messic
Issues API Docs Wiki Android Download FAQ

messic

Music Organizator and Player with ♥

1.1.0

Other Languages:

Please, leave your comments here. We would love to hear your feedback.

Good News! 1.1.0 version published.

2016/04/03

Good news again! messic Team love to announce that finally we got here the second stable release of messic, v1.1.0. See here how to update messic!. It is time to enjoy its new characteristics updating your old version and please report all bugs you detect (you can do it here) as well as your ideas for future messic versions.

Here are the main updates:

  • Messic Radio plugin by icecast and libsout -more detailed info explaining configuration very soon-
  • Multi Volume Albums
  • Draggable Playlist Queue
  • New Android client rework
  • Catalan translation (lot of thanks to Lekspelunca & Renat M. Rius)
  • A lot of other minor bugs and improvements

Don't forget to leave your comments here , we love to hear you and feel that our effort make sense. Remember! We need your help in order to continue improving messic.

Thank you.
messic Team.

 

How to Update messic

This is a common question. Unfotunatelly, messic doesn't have (yet) an automatic mechanism to update your version, but it is very easy to update though.
First, if you have an old version running, ensure to STOP the service with the messic monitor. Before installing the new version, it is important to know where is you current messic music folder due to it will be the same for the updated version. So, if you don't know what is your folder you can get it from the messic monitor window.
Then, UNINSTALL your last version before install the new one (messic uninstall will NOT delete your current music folder).
All you need to do now is to download the last version of messic and install it (or decompress if you downloaded a compressed vesion). When running for the first time, messic will ask you where is your music folder.
This is the most important step: you must put there the music folder you where using with the last version. messic will detect it and warn you that at that place is an existing messic database. You only need to say it is OK.

Important Note: Where the hell is my messic music folder?? hehe, If you don't know where is your old messic music folder you just need to open your old messic version monitor. At the configuration section is the current messic music folder that you were using.

Second Important Note: You must specify the root of your messic music folder (inside of the messic folder are others like the database, your messic user folder, your albums and so on). i.e. If you selected the default messic music folder it should be something like (windows path example) c:\users\myuser\messic-data

Welcome to messic Web Page.

messic name comes from the union of two words:

  • Mess: A dirty or untidy state of things or of a place
  • Music: Vocal or instrumental sounds (or both) combined in such a way as to produce beauty of form, harmony, and expression of emotion
The aim of the project is to convert this mess of music files in a real ordered and cataloged music library, playing it also in a comfortable way. The main characteristics are:

  • Fully FREE and OPEN SOURCE! messic is totally free without any personal benefit. It has a GPLv3 license.
  • It order our catalog of music as automatic as possible, and it is owned only by you. You can go always to the file system where you are saving it and get it.
  • It plays the music in a very comfortable and beautiful interface.
  • It is executed via web, so we could publish this service at home for every device.
  • It is multiuser.
  • It is focused to catalog your personal music library. We want to manage and listen to our own catalog of music at home without uploading anything to the internet.
  • You don't need to be connected to the internet to listen to your music. It is available always in your home network, or downloaded locally to your device.

I don't understand it well. What is messic and How it works?

If you really love music then you probably want to collect and save it in a safe, ordered and accessible way. Let's suppose that you also think that:

  • those music cloud services (like spotify) don't offer to you all the music catalog that you would like, or it is not complete,
  • or it is not well organized in some cases,
  • or simply you don't believe in a service that can be down in the future,
  • or you prefer to be the owner of the music you pay and don't get only the right to hire music for a period of time,
  • something that can't even inherit your children...

If that's the case, then messic is made for you.

You just need to download the messic service for the platform you wish (windows, mac or linux) and install it in any device in your home. Once installed, you could start and stop the service. This service will provide to you a web access to the web interface of messic, namely, from that pc, laptop or any other device (even from your Android and IOS devices) you could see the messic web interface just opening it from any modern navigator and launching the URL of the device where messic was installed (probably something similar to http://192.168.1.X:8080/messic. This URL will depend on the equipment where you installed the messic service in your local network...Don't worry, the messic service will let you know how is that URL when you start it).

Therefore, you have installed the messic service at any PC of your home network and now, from this device, or any other, you are ready to access to the messic web interface to manage your music. Let's start uploading some music to messic: you select the audio files that you want to attach for the album that you are creating and any other resource like covers, arts, lyrics, and so on... You can add all the extra information of your music, like the year of publishment, author, observations, genre, song names, ... or add this information obtaining it from the mp3 tags automatically, or thanks to external services like freedb or discogs, which are also supported by messic. For sure you can use this web interface to listen to your music whenever you wish, or even enable the DLNA protocol to share your music with other devices in your home.

All that music you are uploading is being sotred in an ordered way into the folder that you chosen during the messic installation, so you can access it directly without the messic service, making it possible to continue enyoing your ordered music without any messic dependency, in case you don't want to continue using messic in the future. Moreover, if the messic service is installed in your home, in your network, and you don't want to publish it against the internet, then you probably will want to use the Android smartphone client. This Android client can connect with your messic service and listen to your music from there, or you can as well download your music to your device in order to listen to your music everywhere, without the need to be connected to your messic service.

Download and Install

You can download messic from the download section links. You will find there links to messic for Linux, Mac and Windows. Select the most appropiate version for your system and proceed to install it.

Moreover, it is available now the client versions (not the server) for Android Smartphones and Android TV

 

News! Android client version

We have now a new native Android client for messic. Thanks to this client you will connect with your mobile device easily to your messic server. You will play from the device all your music at the server and also you can download your preferred music to your device, allowing playing it in an offline mode.

You can download the app from your preferred play store (see right links), or if you prefer, you can download directly the APK and install it manually:

  • From your mobile device, go to Settings, scroll down to Security, and select Unknown sources.
  • Download the APK file from your mobile (or copy to your mobile).
  • Once your APK is in your mobile device you only need to search for it (maybe you need some kind of file explorer to find it, or it is at the download section).
  • Install the app.

Last inestable version

Our recomendation is to download only the last stable version, but if you live on the edge and need to have the last last version of messic, you can download it from github directly. By the moment, you will need to compile it, but soon we will built night builds and so on.

FAQ

  • Which navigators are compatible?

    Essentially all those compatible with html5 and css3, but that's not true. Please update your navigator to the last version and probably you will not have any problems.

    If you are trying to launch messic from a Microsoft Internet Explorer... well, good luck (really it seems that with version 11 is more or less ok). We have tested with google chrome (some versions of chromium for linux seems to have problems playing mp3 files natively), firefox, safari (from 6.1 version). Konqueror doesn't seems to be ok :(
    You can see at the wiki pages a table with the user's results launching messic in different navigators. Any help filling this table with real information is more than welcome.

    We are working to improve compatibility, but please, please, update your navigator always you can.

  • Can I share messic music through DLNA protocol with other devices?

    Yes!, you can. You need to activate DLNA share content at the settings page of messic. There are two parts that need to be checked. The first one is the general setting to allow DLNA. This is done only by the administrator, at the administrator settings. If this is abled, then each user can allow at the music settings if they want to share their content over DLNA or not.

    Please, take into account that DLNA protocol doesn't have any authoring mechanisms, so, if you allow DLNA sharing content, any devices at home could get info from messic. This shouldn't be a problem if you have a controlled network, but keep in mind.
    We have tested connecting some DLNA devices to messic, but there are a lot of variety at the market. We are working constructing a table with the information given by the users. Consult it to see if your device has been tested. Any information about compatibility is more than welcome.

  • Does messic use a secure protocol SSL/TLS?

    Initially no, because it's intended to be in your home, inside your home network. But if you need, you can do it by modifying the configuration.

    Just open the messic monitor and open the configuration section. From there you can modify a set of options, and also to enable the security (also you can specify the https port).

    After a restart of the messic service, the connections will be done through the new https port, and probably your navigator will advise you because the messic certificate doesn't correspond to the url, and so on. This is normal, but if you want also to fix it, you only need to go to the folder [messic_folder]/jetty/etc/ and you will find there all the jetty configuration. Just touch the jetty-selector-ssl.xml file with your own configuration.
    Another important question is the imposibility to share content over DLNA when the security is activated. This is really due to the problem of the certificate validation.

  • How can I help the project?

    We need a lot of help. For example, translations of messic to other languages. At this time, we have not defined a protocol for external helps, but we will do. For us is very useful if you notify and describe us the bugs you find on messic. It helps a lot to improve the application. Also you can tell us your desired improvements for next versions.

    We really need a lot of help, like graphical designers, programmers, and so on... maybe, if you want to work seriously with us, the best way could be forking the project and pull request. You have a guide here.

  • Can I use messic for free?

    Yes, its free in both senses. It has a GPLv3 license.

  • Where is the source code?

    Just here: https://github.com/spheras/messic

  • I want to move my music folder to other place. How can I do?

    OK, it's very easy. All the necessary information is inside your folder (included database). So you just need to stop messic service, move the WHOLE folder (which is configured at the messic monitor). After that, open the messic monitor and update the new location in the configure section. Finally, you can launch the messic service with this new location.

  • I don't see well some pages of messic. What can I do?

    Well, in the most of cases, you should upgrade your navigator. In the case you use Internet Explorer, well... it's better to change. Give an opportunity to other navigators like firefox or chrome.

  • Can I see messic from my mobile phone or tablet?

    News!: You can download now a native application for Android!!. More information here. In general you can connect to the web page by a mobile navigator. We have tested some cases and usually it works, not perfectly, but works. The best is to try and tell us your experience. We are working in this area, and also thinking to build native applications..


API