Micro Music Player is a very simple music player for folders or file(s).
As simple as possible: as a simple
play a folder content or a music file(s) player, with no internet connection required anyway
only your music folder and Micro Music Player.
So if you organize your music collection as an arborescence of folders and dislike the chaotic music library indexing of some music player,
mmp is the lightweight utility you can use to listen your favorite music.
MicroMusicPlayer is a little, minimal features, music player program with following simple functionalities:
- Play, Stop, Pause, Resume music playing.
- Playing Next, Previous, song control options.
- Shuffle and Repeat All features (playlist modes).
- Volume control setting.
- Time progressbar view, control and current elapsed time displaying.
MicroMusicPlayer is an easy music folder or file(s) playing concept music player
so that you only have to select a folder or music files with MicroMusicPlayer compatible
to play the entire folder content, or a music file(s) according your selection.
After listing to the folder content or the selected file(s) and searching for an cover image to display ;
MicroMusicPlayer will give you full access to the music and display the album cover image if found one in the choosen folder.
A cover image in form of a compatible image file
(filetypes: *.jpg, *.jpe, *.jpeg, *.png, *.bmp, *.dib or *.tif, *.tiff) resized to
MicroMusicPlayer 3 differents, free choosable, fixed interface sizes (little, middle, big sizes).
Then MicroMusicPlayer play the music in lexicographical sorted order
And the cover image is displayed, except you’re using the Minimal interface.
(so as your O.S present you the files) or in shuffle mode, wenn you don't select a single file for playing.
You can open a folder or music files with MicroMusicPlayer through your file navigator or start it with the commandline:
$ mmp [folder|file(s)]path # mmp is a symbolic link.
- Plays music file(s): to play music file(s) instead of an entire folder.
- Display playlist:
Display a window displaying the folder content or the file playlist.
The current playing music file is marked with an icon in the marging.
You can double-click on a file to play it.
- Minimal interface:
You can switch between the normal interface which present a cover if possible or a minimal interface which doesn’t present any cover image.
note: The Minimal Interface looks like a car radio !
- Recent folders:
Everytime you open music file(s) or a directory for listening music, mmp will store it in the recent folders list.
note: Only the folders registered by mmp will appear in the recent folder list.
- Timeline progressbar:
Displaying the progress of the music file reading, which you can drag the slider from to change the current position of the music file.
- Elapsed time of the current music file reading displaying.
Send notifications to the user at song playing start (Not available on Windows nor Mac and subject of restrictions on GNU/Linux).
- Restriction on GNU/Linux systems. For using Gtk notification a dbus connection is required. And I doubt that all GNU/Linux distribution use the DBus desktop messaging processing system. And notify that: I cite the Gtk documentation, There is no guarantee that the notification is displayed immediately, or even at all.
- Configure program: at your convenience.
- Player settings
You can click-on, click-off the repeat all and shuffle mode to be set as you want.
You can change the volume intensity (from 0.0 to 1.0, which default to 0.5.) to be set as the default volume intensity from the program.
You can set the default music folder used when you open a folder, you immediately in !
warning: Feature not available on Windows but Windows store your precedent location in the file selector.
Here you can choose the icons set to use in the interface: 2 different sets available.
- The HighContrast icon set theme: black and white icons.
- The Oxygen icon set theme: colored icons.
You can choose the main size from the interface from 3 available sizes:
- Little size.
- Middle size.
- Big size.
You can set the default folder in order to set by folder selector opening.
You can click-on, click-off repeat all | Repeat one and shuffle mode to be set as you want.
You can change the default volume intensity (from 0 to 100 units, which default to 50.) to be setted as the default volume intensity from the program.
You can Enable and Disable the Minimal interface as you want.
Changes are immediately applied on the program, but you must press the Apply button to store the settings,
so that you can get it back at every new start from the program.
- Misc (Not available on Windows nor Mac)
Set Micro Music Player as default music player.
Reset files associations.
Enable/Disable Send Notifications.
- Magic behavior:
When you press the stop button or your playlist is finished,
you can simply press the play button to relaunch it from the beginning.
- Current song presentation:
The current playing song displaying entry field is formatted like this:
[N°/Total] - Author - Title
Micro Music Player supports following music files formats:
The most common music filetypes:
- mp3 (MPEG-1 Audio Layer III or MPEG-2 Audio Layer III).
- ogg (Ogg Vorbis).
- flac (Free Lossless Audio Codec).
- wav (WAVEform audio file format).
- wma (Windows Media Audio).
- aac (Advanced Audio Coding).
- ac3 (Dolby Digital).
- mid or midi (Musical Instrument Digital Interface).
- ape (Monkey’s Audio).
- mov (QuickTime).
Else the complete supported filetypes list:
Micro Music Player supports following images files formats (for cover displaying):
The most common images formats:
- *.jpeg, *.jpg, *.jpe (Joint Photographic Experts Group).
- *.png (Portable Network Graphics).
- *.bmp, *.dib (bitmap image file or device independent bitmap).
- *.tiff, *.tif (Tagged Image File Format).
In fact all the image filetypes supported by gdk-pixbuf. Which are on my system:
note: The supported image files are automatic detected in relationship to gdk-pixbuf.
Micro Music Player provide nothing else features:
- No music library indexing feature.
- No access to music files metadatas.
- No database connection for cover images downloading or any indexing.
In other words Micro Music Player stays as simple as possible: a simple
play a folder content or music file(s) player, with no internet connection required anyway, only your music folder and Micro Music Player.
In the beginning, I implemented this program only for my personal use.
But finally, I decided to distribute it because the use of Micro Music Player is as easy as the concept of the short source code;
you can use or modify it it as you like, according to the GPLv3 license terms.
Micro Music Player version 2.0 has totally change the audio engine and the images management:
Instead of using the SDL2_mixer library it use the libvlc library (with which the famous media player vlc is build).
The opencv-3.0.0 library is no more needed. Micro Music Player uses gtk+-3.0 for the cover images resizing.
No change for the user except that the program will never more crash down due to the miss use of the SDL2_mixer library.
NOTE: I have used Micro Music Player version 1.0.0 for a time and I remarked that it can crash sometimes...Technical the bug comes from the Mix_HookMusicFinished(void (*music_finished)()) function from the SDL2_mixer library which documentation specify to "NEVER call SDL_Mixer functions, nor SDL_LockAudio, from a callback function". But i must do this otherwise i don't know what to do when a song finishes and i must start the next one...
Introduce some few new usefull concept.
mmp use some few metadatas from the files with fallback if not found for:
- Formatting the displaying to the user of the current playing music file, in following manner:
N° of track Artist - Title Duration
- Getting the duration of the music file what permit:
To display the duration of the music file to the user.
Provide a timeline bar which you can drag the slider to change the current position in the track.
Displaying a timeline bar.
Getting the correct cover image.
Because in version below 2.1 it could append that mmp display the back face of the a cover image or any other image.
note: It can still append but very much least as before: per example if your folder only contains a back face cover image.
- Adding the Repeat one feature.
- Adding the Minimal interface feature.
- Adding the Recent folders feature.
- Adding the possiblity to switch between the light and dark (if available) variant of your theme.
Reformatting the displaying to the user of the current playing music file, in following manner:
[N°/Total] - Author - Title
The total duration of a song is now set aside the elapsed time.
Full change of the menu bar and many items and shortcuts was added.
Full change of the Configure program window.
Using the GtkApplication instead if the traditonnal gtk_init(...) / gtk_main(...) what implies big changes.
Changing the Repeat and Shuffle features buttons to normal buttons which switch their images.
Adding the number of total songs of the playlist to the current song displaying entry wigdet.
Bug fix the display playlist windows, which updating was enterely rewritten.
Final word:I have rewritten a big part of the program. What the user doesn’t sea, if he don’t get interest into the source code, which can be usefull for them which start the C++ language coming from the C language. Because mmp always claim to be written in C++ in a C-like style. Note: The source code is available in the folder: /usr(/local)/share/MicroMusicPlayer/source On GNU/Linux systems.
NOTE: The Windows version of Micro Music Player works a bit different as the GNU/Linux (and POSIX compliant).
Use gdebi (in preference) or dpkg to install the debian package !
sudo gdebi mmp-3.0-noarch.deb # gdebi resolves dependencies. sudo dpkg -i mmp-3.0-noarch.deb # dpkg doesn't resolves dependencies.
NOTE: If you get all requirements installed but the rpm program refuse to install mmp: try the --nodeps switch.
$ ./configure $ make $ make strip # Remove all unneeded symbols $ sudo make install
Thank's to my beloved mother, my family and to the doctors.
Stay away from drugs: drugs destroy your brain and your life.