Micro Music Player Documentation

Table of Contents

Next: , Up: (dir)   [Contents]

Micro Music Player Documentation

Micro Music Player 3.0, Dec 19, 2016

Eddie Brüggemann

Copyright © 2016, Brüggemann Eddie

Contents:


Previous: , Up: Top   [Contents]

1 mmp (Micro Music Player)


Developer: Eddie Brüggemann


Contact: mrcyberfighter@gmail.com


version: 3.0


Language: C++


Release Time: Dec 19, 2016


License: GPLv3


Next: , Up: mmp Micro Music Player   [Contents]

1.1 Presentation from mmp (Micro Music Player)

`mmp' is a little, minimal features, music player program with following simple functionalities:

`mmp' is an easy music folder or files playing concept music player so that you only have to select a folder which contains some `mmp' compatible music file(s) to play it content, or selecting a list of compatible music files.

After listing the folder content or file(s) and searching for an cover image to display ; `mmp' will give you full access to the music folder content or file(s) and display the album cover image if found.

A cover image is in form of a compatible image file resized to `mmp' 3 differents, free choosable, fixed interface sizes (`little', `middle', `big').

Then `mmp' play the folder content or the selected music files in lexicographic sorted order (so as your O.S present you the files) or in shuffle mode.

And the cover image is displayed, except you’re using the Minimal interface.

You can access the playlist to choose a music file to play immediatly.


Next: , Previous: , Up: mmp Micro Music Player   [Contents]

1.2 Features

 
 
 
 
 
 
 
 
 
 

You can open a folder or files with `mmp' through your file navigator or start it with the commandline:

$ mmp [folder|file(s)]path # mmp is a symbolic link.

Next: , Previous: , Up: mmp Micro Music Player   [Contents]

1.3 What `mmp' not does:

`mmp' provide nothing else features:

So `mmp' stay as simple as possible: as a simple `play files' or a `folder content', with no internet connection required anyway, only your music folder and `mmp'.

This is because i implement it at start only for personnal usage so it´s a personnal requirement builded program,

but finally i decide to distribute it because `mmp' is so easy, as in the concept as the short source code,

so that you can use it like this or modify it, in the way you want, according to the terms of the `GPLv3' license.


Next: , Previous: , Up: mmp Micro Music Player   [Contents]

1.4 `mmp' menus and shortcuts

  1. `Files'

  1. `Music'

  1. `Config'

  1. `Info ?'

Next: , Previous: , Up: mmp Micro Music Player   [Contents]

1.5 Notes

This program, mmp version `3.0', was written on an Ubuntu 16.10 distribution.

Then adapt to:

So some functionalities are not available on some portages, very sorry !


Windows: This program was tested on a `Windows 7 64 bits' system and should work on `Windows' versions `>= 7'.


MacOS: This program was tested on a `Mac OS' `Sierra', I don’t know about retro-compatiblity and future O.S release compatiblity.


Next: , Previous: , Up: mmp Micro Music Player   [Contents]

1.6 mmp supported filetypes:


Next: , Up: mmp supported filetypes   [Contents]

1.6.1 Music files filetypes:

The most common music filetypes:

Else the complete supported filetypes list:


Previous: , Up: mmp supported filetypes   [Contents]

1.6.2 Cover image filetypes:

The most common images formats:

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.


Next: , Previous: , Up: mmp Micro Music Player   [Contents]

1.7 Changelogs


Next: , Up: Changelogs   [Contents]

1.7.1 mmp 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. `mmp' uses gtk+-3.0 for the cover images resizing.

Nothing change for the user except that the program will never more crashing due of my missuse of the SDL2_mixer library.


Next: , Previous: , Up: Changelogs   [Contents]

1.7.2 mmp Version 2.1

Introduce some few new usefull concept.

`mmp' use some few metadatas from the files with fallback if not found for:

  1. Formatting the displaying to the user of the current playing music file, in following manner:
N° of track Artist - Title Duration
  1. Getting the duration of the music file what permit:
  1. Displaying a timeline bar.
  2. 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 `mmp' cannot access the metadata, but not necessarily in this case (because of fallback success).


Previous: , Up: Changelogs   [Contents]

1.7.3 mmp Version 3.0


New features:


Changes:


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'/`UNIX' systems.


Next: , Previous: , Up: mmp Micro Music Player   [Contents]

1.8 Credits

Thanks to my beloved `mother', my `family' and to the `doctors'.

`Stay away' from `drugs': `drugs destroy your brain and your life'.

Thanks to my `uncle' too, who let free usage of his `Mac O.S', for the development of `mmp' version `1.0',

during my holydays where i write this lines from...

By the way `Mac O.S' seems to me a little bit strange the first times but i think it’s good stuff finally.

I think that `Mac' compile right with his C++ compiler but not verbose enough about errors.

The `Mac' terminal is near enough from the `GNU/Linux' terminal,

so that i could work...


Previous: , Up: mmp Micro Music Player   [Contents]

1.9 License

Micro Music Player a very simple play a folder or a file music player.
Copyright (C) 2015, 2016  Brüggemann Eddie.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.