epMEDIA 0.4 README

1. ABOUT epMEDIA
================

1.1 epMEDIA?
------------
Well, i mainly programed this piece of software for my 'Via Epia M10000' geared
Mediabox, so epMEDIA stands for epia and media. not very creative huh?

1.2 What is it?
---------------
It's mainly a very basical graphical filebrowser with the built-in ability to
play musicfiles and show pictures. Other functions and filetypes (e.g. videos,
snes) can be handled through other applications (e.g. ZSNES for snes-roms). It's
supposed to run on TV-Screens (800x600) and not so powerful PC's.

1.3 Why should i use epMEDIA instead of Freevo, MythPC, etc.
--------------------------------------------------------------------------
All these programs are much better and featureful than epMEDIA, that's right,
_but_ epMEDIA runs much faster on smaller CPU's (like the Via C3 on my epia)
because it's not that featureful. Cheap trick: No TV, no programguide, not even
weatherforecast. Faster startup. Anyways, if you need that features and got a
fast pc, epMEDIA may not be your first choice. It's mainly an audio-jukebox.


2. INSTALL INSTRUCTIONS
=======================
epMEDIA is written in Python, so it should be completely os-independent, anyways
i did test it on Windows XP and Ubuntu Linux 6.06

2.1 LINUX
---------
In order to get epMEDIA to work, you'll need:

Python 2.4		->	python.org
pygame 1.7.1		->	pygame.org

on many linux-distributions Python is already included and pygame can easily be
installed through apt or rpm.

after that just decompress the archive whereever you like and start epMEDIA
with:

python epmedia.py
(in the epmedia directory)


2.2 Windows
-----------
In order to get epMEDIA to work, you'll need:

Python 2.4		->	python.org
pygame 1.7.1		->	pygame.org
pySonic			->	pysonic.sourceforge.net
FMOD.dll		->	fmod.org

For the binary version of epMEDIA (windows only) you only need
to extract epmedia.exe into any directory and go on downloading
FMOD.

Download FMOD

BEWARE! FMOD IS NOT FULLY FREE SOFTWARE! So you are not allowed to use it
commercially!

copy 'fmod.dll' from the downloaded archive into the epMEDIA folder or the
Python folder.

change 'sdlmixer' to 'pysconic' in 'epconfig.xml' in the <sound> section, if
needed.

2.2.1 why pySonic/fmod?
-----------------------
under Windows pygame lacks of the capability of playing mp3 files. correct me if
i am wrong.


2.3 epconfig.xml
----------------
This is the main configuration file for epMEDIA, edit it to fulfill your needs.
Better explanation hopefully coming soon... or even better a new config editor.


2.4 psyco
---------
psyco is a very nice thing you may download and install to speed up epmedia!
-> psyco.sourceforge.net


3. USING epMEDIA
================
After starting epMEDIA you will see the mainmenu showing the sections you
defined in 'epconfig.xml'. Now you may navigate
through this menu with your up/down-keys. with the right key you
switch to the selected section (back with left). Now you should
see the directory you defined as 'files' for that section
(note: you see only directories and defined filetypes), with
the enter-key, the defined program is launched with the file
as parameter. If PLAY_MUSIC is defined that musicfile will be
played. If you are pointing at a directory all musicfiles
in that directory are added to the playlist. controls
for the playlist are:
A : previous track
S : stop
X : pause
W : play
D : next track
Q : randomize playlist

In the picture section the controls are:
ENTER	: Show picture or not
UP, DOWN: previous, next picture in dir
SPACE, TAB: Switch from/to sidemenu

All other controls:
UP,DOWN,PAGEUP, PAGEDOWN : navigate in filelists
RIGHT, LEFT : go into, or leave directories
ENTER : play music, add files to playlist, launch your favourite
	videoplayer, etc.
ESC : exit


4. CHANGELOG
============

0.4 Changed scrollstyle, which speeds the program feeled 200% up. added a
sidemenu. changed configfile and themefiles to xml. replaced all themes with
Inkscape graphics (sources included)  Removed Bugs related to empty directories.
thanks to Yura Semashko for many of the bugfixes!
thanks to Fayaaz Ali for the xml-classes!

0.3 Finally added the SHOW_PICTURE function. fixed many bugs. Added base skin
wich uses an overlay (looks cool, slow). pageup/down works now, added some
features to all skins (mostly playtime). It's now possible to run epMEDIA at any
resolution, but currently only 800x600px skins are included.

0.2 Added epconfig, a log-system, overworked clean-skin, reduced bugs a little
bit more, added psyco support

0.1 Initial release


5. CONTACT
==========
Feel free to write me if you have suggestions or questions:
TobiasDuehr@yahoo.de