MMboX Version 0.5
=================


Librairies necessaires :
------------------------
- la glibc (bah oui !)
- la glib
- SDL => http://www.libsdl.org/download-1.2.php
- SDL_image (avec support libpng) => http://www.libsdl.org/projects/SDL_image
- donc libpng => http://www.libpng.org/pub/png/src/ (et jpeg... enfin c'est
pas oblig mais si vous voulez les lire dans g-see...)
- SDL_ttf => http://www.libsdl.org/projects/SDL_ttf
- donc freetype => http://sourceforge.net/project/showfiles.php?group_id=3157
- SDL_gfx => http://www.ferzkopp.net/Software/SDL_gfx-2.0/

comme programmes il faut :
--------------------------
- xmms (ou autre, editez alors mmbox.sh) => http://www.xmms.org/download.html
- mplayer (meme remarque) => http://www.mplayerhq.hu/homepage/dload.html
- grep et find (et ouais...)
- cdinfo (fourni avec MMboX)
- xsetbg (qui fait parti de ???), enfin c'est pas essentiel mais c'est mieux...

Compilation :
-------------
make

Installation :
--------------
make install

Nouveau :
---------
Systme de skins. Elles se trouvent dans /usr/local/share/mmbox/skins

La skin a utiliser se trouve dans le fichier /usr/local/share/mmbox/mmbox.conf,
ainsi que la resolution a utiliser.

Il est impratif d'editer le fichier mmbox.sh pour l'adapter a vos propres
besoin (paramtres de mplayer par exemple).
Il faut aussi configurer xmms pour qu'il se lance avec les plug-ins desirs.
Je vous conseille l'installation du plug-in cdread pour xmms qui permet
d'utiliser les plug-ins de visualisation avec les cd audio.

Lancement :
-----------
mmbox.sh (/usr/local/bin doit etre dans le PATH)
Vous pouvez lancer MMboX aussi, mais ca servira pas a grand chose...
A part creer une playlist dans /tmp peut etre...

Utilisation :
-------------
Pour se deplacer dans les menu -> fleches de direction
ou joypad/joystick
pour selectionner un element du menu -> RC (tous les elements ne sont pas
selectionnable pour le moment... version pre-beta-alpha-test-proto oblige...)

Les fonctions "Lecture Media" de musique et video sont implmentes et font
de leur mieux... si ca vous plait pas, faites les modifs que vous voulez et
envoyez les moi !!! ;op

Pour quitter, 'q' depuis le menu principal uniquement.

Pour les listes de lecture (playlists) :
- Dans le browser (partie gauche) et dans la playlist (partie droite)
  les fleches haut et bas permettent de se deplacer.
- Pour ajouter un fichier dans la playlist depuis le browser : RC.
  Si c'est une playlist (.m3u ou .pls) son contenu est ajout. Par contre
  si vos playlists sont au format Windows (C:\truc\machin.mp3) ben venez
  pas dire que ca marche pas, je suis pas magicien moi...
- Dans le browser n'apparaissent que les fichiers portant les extensions
  declares dans le code (mp3, ogg, wma, wav, pls et m3u pour les audios).
  Si il en manque vous pouvez les ajouter dans le code (mais si vous allez
  trouver ou et comment, c'est vraiment tres simple...) et me le signaler.
- Pour supprimer un fichier de la playlist : RC sur le nom de ce fichier.
- La derniere playlist est automatiquement ajoute a la nouvelle, il
  suffit d'effacer son contenu avec le bouton X si vous n'en voulez pas.
- Le bouton AddAll (double fleche) permet d'ajouter recursivement tous
  les fichiers d'un repertoire. Si ce n'est pas un repertoire qui est
  selectionn dans le browser, c'est le repertoire courant.
- La fonction save n'est pas implmente (et ca attendra qu'on ait le
moyen de saisir un texte en entre => voir TODO)
- La fonction load cre le fichier de playlist, quitte le prog et lance
  xmms (ou MPlayer pour les videos).

Pour la visionneuse d'images :
Utilisez les fleches haut, bas, gauche et droite pour vous dplacer.
Pour zoomer sur une photo, appuyez sur 'Entre'. Pour revenir a la mosaique,
appuyez sur 's'.
Et pour quitter le programme appuyez sur 's'.
Pour effectuer une rotation de l'image, c'est 'r'. Pour zoomer, c'est '+' et
'-', a noter que l'on ne descend pas en dessous du raport 1:1. Ensuite, si
vous avez effectu un zoom, les touches de direction permettent de se
deplacer dans l'image.
Toutes ces fonctionnalits sont aussi accessibles avec un joystick/joypad !!
Pour visionner la photo suivante : espace (ou le bouton 7 du joypad), la
precedente c'est backspace (ou bouton 6).

Bonne chance !

Ce logiciel utilise cdinfo de 
 *  (c) 1996,1997,1998  Gerd Knorr <kraxel@goldbach.in-berlin.de>
 *       and             Heiko Eissfeldt <heiko@colossus.escape.de>
distribu sous licence GPL.

Remerciements :
---------------
Arnaud Rolly pour son code de detection de l'insertion d'un CD.
(en plus c'est vachement bien crit comme code, ca change du mien ;op)

