
		eMoviX v0.8.0pre3 <http://movix.sourceforge.net/>
		  Auteur: Roberto De Leo <peggish@users.sf.net>
			    30 Januari, 2003

  Wat is dit?
  -----------
  
  eMovix is een piepkleine Linux CD distributie, die alle software bevat om
  op te starten vanaf een CD en elk video bestand af te spelen wat in de CD
  root is geplaatst. Alle formats die MPlayer ondersteund, worden door
  eMovix ondersteund. De belangrijkste Divx, maar in het algemeen AVI, MPEG,
  Quicktime, WMV, ASF, FLI en nog een paar anderen.
  Als je ondertiteling in dezelfde map met dezelfde titel doet (bijv.
  movie.avi en movie.sub), dan zal deze automatisch getoond worden.

  In andere woorden, als je je video bestand(en) en MoviX op dezelfde CD
  brand dan zal je op de CD niet alleen de film, maar ook de software om de
  PC op te starten en de film af te spelen. Zo ben je in staat de film op
  elke PC af te spelen, zelfs als er geen OS is geïnstalleerd
  (zolang de PC hardware wordt ondersteund door Linux).

  Hoe is dit gemaakt?
  -------------------

  eMoviX is gemaakt uit software die al bestaat op het net:

  syslinux v2.00       <syslinux.zytor.com>   om de CD bootable te maken;
  mplayer v0.90rc3     <www.mplayerhq.hu>     om films af te spelen;
  alsa 0.9.0rc7        <www.alsa-project.org> als audio drivers;
  slackware v8.0       <www.slackware.com>    om een mini distro te maken;
  linux kernel v2.4.20 <www.kernel.org>       om alles te laten werken :-)  

  Het enige wat ik heb gedaan is deze software samenvoegen :-)

  Van de Slackware CD, die met SysLinux opstart, heb ik de ramdisk gehaald.
  Deze heb ik licht gewijzigd om veel onnodige bestanden te verwijderen, en
  alle mogelijke audio modules + kernel v2.4.20 + het Mplayer pakket toe
  te voegen.
  Een perl script (/usr/local/bin/movix.pl) wordt uitgevoerd meteen na het
  opstarten om alle mogelijke audio modules uit te testen, en meteen daarna
  wordt de video afgespeeld.
  
  Documentatie
  ------------

  Tot nu toe had ik niet veel tijd om documentatie te schrijven, dus dit
  bestand bevat bijna alle documentatie die er is. Hopelijk heb ik er meer
  tijd in de toekomst. Een klein beetje info/docs is verkrijgbaar bij de
  boot prompt bij elke CD met eMoviX erop.
  
  Software en Systeemeisen
  ------------------------

  --> Software:

  Het enige wat je nodig hebt om eMoviX te gebruiken, is een software pakket
  om de bootable isoimage te maken en branden op CD. In zowel Linux als
  M$ Window$ kan je gebruik maken van mkisofs & cdrecord, die je vindt op:

        ftp://ftp.fokus.gmd.de/pub/unix/cdrecord/

  Window$ gebruikers kunnen een win32 versie krijgen op:

        ftp://ftp.fokus.gmd.de/pub/unix/cdrecord/alpha/win32

  Een [hopelijk!] werkende versie van mkisofs voor win32 is toegevoegd aan
  het eMoviX pakket om het voor winXX gebruikers makkelijker te maken.
  Instructies over hoe je mkisofs moet gebruiken, vind je beneden.
  Veel dank aan Wojtek Nasilowski, die me een werkende versie van mkisofs
  en de .bat file heeft gegeven!
	
  --> Hardware:

  CPU
  Alleen x86 compatible CPU's worden ondersteund, en alleen >= i586.

  RAM
  Ik heb het idee dat eMoviX-0.8.0 meer geheugen gebruikt dan alle vorige
  versies, maar 32MB is misschien nog genoeg [het is makkelijk om te zorgen
  dat het weer kan, ik heb er nu alleen weinig tijd ervoor], maar meer dan
  40MB RAM is in ieder geval genoeg.

  MUIS
  Je hebt geen muis nodig met eMoviX.

  CONTROLLERS
  Alle IDE en SCSI controllers ondersteunt door kernel 2.4.20, worden
  ondersteund. Schrijf me een mail als je controller niet werkt met eMoviX.

  VIDEOKAARTEN
  Het is niet makkelijk te zeggen welke videokaarten met eMoviX werken.
  Merken die bekend zijn te werken zijn:
    
    Matrox 
    Ati    
    NVidia 
    Intel  
    3Dfx   
    Sis    
    S3
    Trident

  Maar waarschijnlijk werkt de meerderheid van de videokaarten prima.
  Ik plan een meer gedetailleerde videokaart database op de website
  te zetten. Dus als je kaart niet op de lijst staat maar werkt met eMoviX,
  laat het me horen zodat ik de kaart op lijst met werkende kaarten
  kan zetten. Hetzelfde geldt voor als hij NIET werkt!

  BTW, als je het "aa" label gebruikt, dan zal eMoviX hoe dan ook werken
  onafhankelijk van de kaart. Ok, het is ASCII mode, nou en, het werkt! :-)

  GELUIDSKAARTEN

  Vanaf deze release gebruikt eMoviX de nieuwe ALSA drivers!
  Ze zijn de toekomstige standaard drivers voor Linux en ondersteunen veel meer
  kaarten [en features] dan de oude OSS. Dus als je kaart niet werkte in deze
  versie, kan je deze maar beter proberen!

  Een complete lijst van alle ondersteunde kaarten met gedetailleerde info erbij
  is te vinden op de ALSA website: http://www.alsa-project.org/
          http://www.linux.org.uk/OSS/

  NETWERKKAARTEN

  Net wordt niet ondersteund door eMoviX.

  AFSTAND BEDIENINGEN (AB)

  Vanaf v0.8.0 ondersteunt eMoviX afstand bedieningen!!!
  Nou ja, om precies te zijn, op dit moment ondersteunt het 1 model:
  De AB die bij de Hauppauge WinTC kaart zit (ja, die AB heb ik zelf ;-) )
  Het werkt fantastisch en ik hoop dat dit de eerste in een serie ondersteunde
  AB's wordt. Maar om dit te doen heb ik veel hulp van jullie nodig!
  Als je veel van lirc weet, en bereid bent te helpen, laat het me weten!

  Ondersteunde Audio/Video formaten
  ---------------------------------

  Ik ben geen expert hierin, dus ik kan er niet heel precies over zijn.
  Wat ik weet, is dat het mogelijk moet zijn om de meeste DivX bestanden
  af te spelen, en in het algemeen AVI, MPEG, Quicktime, ASF en WMV.
  Van audiobestanden, zouden mp3 en OGG/VORBIS prima moeten afspelen.

  Als je voorbeelden kan geven van video/audio die niet werken in eMoviX,
  laat het alsjeblieft weten.
  
  Installatie
  -----------

  Vanaf (pre-)release 0.6pre2 wordt de installatie gedaan door het autoconf
  mechanisme. Dus eMoviX installeren is zo makkelijk als untarren van de
  tarball, cd'en naar de nieuwe map en de volgende commando's invoeren:
     ./configure
     make 
     make install
  Standaard worden de binaries "mkmovixiso", "movix-conf" en
  "movix-version" geïnstalleerd in
     /usr/local/bin 
  en alle eMoviX data bestanden worden gekopieerd in 
     /usr/local/share/emovix

  Als je dit alles niet snapt, of je maakt liever zelf een iso image,
  vergeet alles hierboven en lees beneden verder.

  Bootable images maken met je audio/video bestanden
  --------------------------------------------------

  WINDOWS GEBRUIKERS: totdat er een windows GUI voor eMoviX wordt
  uitgebracht [ooit], is de makkelijkste oplossing het installeren van
  het CygWin pakket (http://cygwin.com/). Een handig pakket dat op je Windows
  systeem de meeste voorkomende hulpmiddelen in de Unix wereld installeerd.
  Met name degene die je nodig hebt om het "mkmovixiso" te gebruiken, maken
  het erg makkelijk om een eMoviX iso image te maken.

  *** Nieuwe methode [niet voor WinXX users, tenzij je cygwin hebt]

  Om het maken van een iso image zo makkelijk mogelijk te maken,
  is het perl script "mkmovixiso" inbegrepen bij het pakket.
  Als je een iso image wilt maken met bijv. "file1" en "file2", en deze wilt
  plaatsen in de directory "dir", zou je dit zo moeten intypen:

     mkmovixiso -t "My title" -o /tmp/movix.iso file1 file2 dir

  Houdt in je hoofd dat je misschien ook een playlist op de CD wilt zetten,
  voor als je meer dan 1 bestand op de cd hebt staan, en je ze in een bepaalde
  volgorde wilt afspelen. Voor meer info over "Playlists", zie de sectie
  hierover een stuk verder beneden.

  Om meer te weten te komen over mkmovixiso opties, probeer mkmovixiso -h

  Als je altijd hetzelfde output bestand, of zelfde taal gebruikt, of altijd
  dezelfde extra opties gebruikt, kan je voorkomen ze apart te moeten
  intypen iedere keer als je mmkmovixiso gebruikt. Door een .movixrc bestand
  in de home dir. aan te maken. Hier is een voorbeeld:

# <--------- .movixrc voorbeeld

# mijn .movixrc bestand
# alle regels met # zijn commentaar!

# standaard output locatie
output-file=/tmp/movix.iso

# standaard boot label 
boot-label=MoviX

# standaard font set
subtitleFonts=polish

# extra opties voor mkisofs
extra-mkisofs-options=-J

### Opties voor MPlayer

# extra opties voor mplayer
extra-mplayer-options=-double -aspect 4:3 -flip

# opties die je niet door mplayer wilt laten gebruiken
unwanted-mplayer-options=-fs -zoom

# herhaal afspelen 5 keer [0 = oneindig]
loop=5

# speel alle bestanden willekeurig af
random=y

# opnieuw opstarten wanneer klaar met afspelen
reboot=y

# eject CD wanneer klaar met afspelen
eject=y


# ---------> einde van .movixrc voorbeeld  

  Geen andere opties voor .movixrc zijn tot nu toe te gebruiken

  *** Oude methode [voor WinXX gebruikers die mkisofs zonder cygwin willen gebruiken]

  Als je de oude methode fijner vindt, doe dit:

  0. maak ergens in bijv. de "utils" map", een nieuwe map aan. Die noem je
     bijv. "movix"
  1. Kopieer de mappen src/isolinux en src/movix naar de nieuwe map "movix"
     [om misverstanden te voorkomen, de nieuwe "movix" en src/movix zijn
     _niet_ hetzelfde, en de laatste zal niet voorkomen in deze sectie]
  2. Als je ondertitels hebt die je wilt gebruiken, maak een map "mplayer"
     in de "movix" map. Maak een map "font" in de "mplayer" map, en kopieer
     hier in je favoriete fontset van mplayer-fonts [in de map "font" moeten
     nu bestanden met de extensie .raw en 1 bestand met de naam "font.desc"
     zijn]
  3. Kopieer alle audio/video bestanden die je wilt gebruiken in de "movix"
     map
  4. Voer "sh mkmovixiso.sh" (Unix) of "mkmvxiso.bat" (WinXX) uit. De image
     zal gemaakt worden in "\tmp\movix.iso" (Unix) of C:\temp\movix.iso (WinXX)
     Zorg dat je de _-V "Film"_ string verandert, als je een andere titel aan
     de CD wilt geven!

  Laat het me weten als je fouten vindt in het algoritme :-)

  *** "Ik wil Nero gebruiken!"
  
  Window$ gebruikers die mkisofs haten, kunnen nog steeds een bootable eMoviX
  CD maken, dankzij een methode bedacht door de erg creatieve Hakan Atac:

  0. download de eMovix bootable floppy image
  1. start Nero :-)
  2. Sluit de wizard (heeft geen bootable optie)
  3. selecteer CD-ROM (boot) uit New Compilation
  4. selecteer als disk image, de floppy image die je had gedownload
  5. in Expert Settings, zet je "Kind of Emulation" op "Geen Emulatie"
  6. zet de "isolinux" in de root van de CD
  7. zet alle audio/video bestanden in de root van de CD [niet een subdir!]
  8. als je een playlist wilt gebruiken, zet 1 of meer playlists in de
     "movix" map. Standaard zal eMoviX degene met de naam "movix" afspelen.
     (wanneer aanwezig)
  9. brandt de cd!

  Veel dank gaat naar Hakan Atac die deze makkelijke manier heeft bedacht
  om een eMoviX cd in Nero te maken!

  MultiSession 
  ------------

  om te leren hoe je multi-sessie eMoviX CD maakt, lees de de docs op
  http://advancemame.sourceforge.net/doc-advcd.html
  in sectie 5-7.
  LET OP: een eMoviX multisessie cd in Nero maken is lastig, omdat het
  het Rock-Ridge cd formaat niet begrijpt. Dus *lees* de secties hierboven.

  Gebruik
  -------

  Als je eenmaal je iso image hebt, kan je 'm branden op CD met iets van:

     cdrecord dev=0,0 -v -eject /tmp/movix.iso

  Of gebruik gewoon Nero of een ander pakket om de iso op CD te branden.

  Laat de nieuwe CD in de CD-ROM drive, en reboot de PC: als alles goed is
  gegaan, zal de PC vanaf de CD opstarten en na een paar seconden begint
  mplayer de bestanden ad te spelen.

  Boot Labels
  -----------

  Er zijn veel videokaart drivers en mplayer video drivers, waarvan niet
  al hun combinaties goed met elkaar werken.

  Het movix.pl script probeert automatisch de beste optie voor je te bepalen,
  zodat je over het algemeen niks hoeft in te typen bij de boot prompt.

  Maar voor het geval je niet tevreden met de video kwaliteit, zijn er een
  paar extra bootlabels waarmee je eMoviX kan forceren een bepaalde driver
  te gebruiken:

     Label       Beschrijving

     MoviX    -  Het default label zorgt ervoor dat het movix script 
   (default)     automagisch de beste mplayer voor je videokaart kiest.

      sdl     -  Hoge ondertitel kwaliteit, maar niet perfecte video kwaliteit

     vesa     -  De "vesa" driver moet werken op de meeste videokaarten

     vesaFB   -  Gebruikt de algemene vesa FrameBuffer driver

      FB      -  Gebruikt de specifieke FB driver voor je kaart (als nodig)

      aa      -  Bekijk je films in ASCII formaat! :-)

     aa1024   -  Bekijk je films in ASCII formaat @ 1024x768 resolutie.
 
     aa1280   -  Bekijk je films in ASCII formaat @ 1280x1024 resolutie.
                 (De laatste 2 hebben een CPU nodig die >= 1GHz)

      TV      -  Schakelt de applicatie [als aanwezig] in, om de TV-out
                 van je kaart aan te zetten.

Er zijn ook 2 extra labels die nuttig zijn, wanneer je een eMoviX CD vergeet
in de drive te doen:
      hd      - vergeet de CD, en start vanaf de HD
    floppy    - vergeet de CD, en start vanaf Floppy

Veel dank gaat naar Christophe Paris voor deze suggestie.
Ik gebruik deze labels nu vaak!

  Boot Opties
  -----------

  Je kan bij de boot prompt ook een aantal opties opgeven, die automagisch
  worden doorgegeven aan het movix.pl script:

            Boot Args  Waarde     Effect

              SLOW       y,n      Standaard laat movix je CD-ROM drives
                                  langzamer draaien, tegen lawaai. Sommige
                                  spelers kunnen de CD zo niet meer lezen.
                                  Heb je hier last van, gebruik deze optie
                                  dan.

              ACCEL      sw,no    Forceer software mode of geen rescaling. Als
                                  de film traag speelt, kan je dit proberen om het
                                  soepeler te laten lopen. Maar de film wordt dan
                                  niet ge-rescaled naar fullscreen!

              VO_DRIVER  <driver> Forceer vo driver (lees de mplayer DOCS!)

              MP_OPTIONS <opts>   Voeg mplayer optie toe ( ^ zie hierboven!)

              LIST       <list>   Gebruik "list" als playlist

              SHUT       y,n      PC uitzetten na afspelen van CD bestanden.
                                  Dit is handig voor als je in slaap valt tijdens
                                  het afspelen :-)

              REBOOT     y,n      PC rebooten na afspelen van CD bestanden.
                                  Dit is handig voor als je in slaap valt tijdens
                                  het afspelen :-)

              LOOP       <N>      Herhaal film N keren [0 = oneindig]

              RANDOM     y,n      Films afspelen in willekeurige volgorde


Voorbeeld: als je het standaard bootlabel ok vindt, maar je wilt je "sleepy.asx"
playlist afspelen, en je wilt je PC afspelen als de playlist klaar is (omdat je zelf
waarschijnlijk al daarvoor bent afgesloten ;-) ) en je wilt je CD-ROM niet vertragen
omdat je het geluid zo fijn vindt, dan zou je de volgende string gebruiken:

boot: MoviX LIST=sleepy.asx SLOW=n SHUT=y

  Mplayer Menu
  ------------

  Vanaf deze versie is de nieuwe "menu" feature van mplayer ondersteund,
  zodat je makkelijke kan browsen door je video selectie en/of de playlist
  veranderen!
  wacht gewoon tot mplayer is gestart en toets "m" om naar het menu te
  gaan.

  De lijst van andere shortcuts voor mplayer is verkrijgbaar op hun site.
  De lijst van de meest voorkomende shortcuts is te zien bij iedere
  eMoviX CD wanneer deze opstart bij het Splash-scherm.

  Hoe andere bestanden afspelen, als hij klaar is
  -----------------------------------------------

  Als eMoviX klaar is met het afspelen van alles op de CD, kan je iedere
  andere eMoviX CD afspelen door gewoon een nieuwe CD er in te doen, en het
  "movix" commando te gebruiken in de prompt.
  LET OP dat dit commando niet werkt bij niet-eMoviX CD's.

  Afspelen van DVDs, VCDs en non-eMoviX CDs
  -----------------------------------------

  Als je dit wilt doen, zoek je naar MoviX, niet eMovix!
  Ga naar de Movix website en download de nieuws MoviX versie.

  Wat doen als de audio traag of niet aanwezig is
  -----------------------------------------------

  Dit is de eerste eMoviX versie met ondersteuning voor de ALSA
  sound drivers. Dus ik weet nog niet of er audio problemen zullen zijn
  gelijk aan die van oudere versies.
  Hoe dan ook, als het geluid traag of niet aanwezig is, zelfs nadat je
  het geluid voluit hebt gezet in mplayer, kan het volgende proberen:
  stop de film, ga terug naar de console met CTRL-ALT-F2, verander het
  volume met alsamixer. Ga terug naar de originele console met
  CTRL-ALT-F1 en ga verder met afspelen met het "movix" commando.

  Let op: zoals je misschien merkt is nmixer vervangen door alsamixer in
  deze versie. De enige reden hiervoor was het feit dat het meer "channels"
  dan nmixer ondersteunt. Als je een reden hebt om de voorkeur te geven aan
  nmixer, laat het me weten.

  Playlists
  ---------

  Sinds versie 0.6 ondersteunt eMoviX playlists!
  De ondersteunde formaten zijn: .asx .m3u .pls .txt .list

  Als je bijv. de bestanden "Mijn Video.avi" en "Mijn Audio".mp3
  hebt, zou je de playlist zo kunnen maken:

  1. movix.asx

  Dat zal er zo uitzien:

  <asx version = "3.0">
   <title>Mijn Playlist</title>
   <entry>
     <ref href = "/cdrom/Mijn Video.avi"/>
   </entry>
   <entry>
     <ref href = "/cdrom/Mijn Audio.mp3"/>
   </entry>
  </asx>

  2. movix.list or movix.txt

  Dat zal er zo uitzien:

  /cdrom/Mijn Video.avi
  /cdrom/Mijn Audio.mp3

  Ik weet niet veel over het pls en m3u formaat. Maar ik weet dat ze werken.
  Nou ja, soms :-)

  eMoviX kijkt standaard in de root van de CD naar "movix.asx", "movix.list"
  of een playlist met andere extensie.
  Als er geen gevonden wordt, worden de bestanden in alfabetische volgorde
  afgespeeld.
  Wanneer je meer dan 1 playlist wilt hebben, kan je andere namen gebruiken en
  deze activeren met de LIST parameter.
  Als je bijv. 2 playlists hebt, met de namen "movix.list" en "alt.list", en je
  wilt de 2e gebruiken, dan start je de CD zo op:

     boot: MoviX LIST=alt.list

  LET OP: onthoudt dat je met het nieuwe mplayer "menu" een andere playlist kan
  kiezen zonder opnieuw op te starten.

  Ondersteunde font sets
  ----------------------

  Vanaf versie v0.6pre2 bevat de movix distro de volgende font paketten:
  tsjechisch, cyrillisch, grieks, hebreeuws, pools, russisch en turks.
  Al deze paketten ondersteunen latijnse karakters (iso-8859-1) en hun
  specifieke karakters.
  Standaard wordt het poolse pakket toegevoegd aan de iso image.
  Om geen fonts te installeren (als je geen ondertitels gebruikt), gebruik
  de -noSub parameter bij het "mkmovixiso" commando.
  Gebruik "mkmovixiso -h" om een andere taal in te stellen.
  Over het algemeen type je iets van
     mkmovixiso -a filename -t "My title" -sub=greek -o /tmp/movix.iso 
  Alle font paketten komen van
	ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/
  behalve de poolse fonts (gekregen van Krzysztof Kajkowski) en
  hebreeuwse fonts (gekregen van Pavel Bibergal).

  Debugging
  ---------

  Voor het debugging heb ik, dankzij een suggestie van Jose' M Dandinho,
  een eMoviX script toegevoegd wat op floppy het volgende zet:
    1. output van dmesg
    2. /proc/pci
    3. movix script logs
    4. instellingen van alle cd-rom's op de PC

  Om het script uit te voeren, stop je een lege floppy in de PC, type
  "debug" en druk ENTER.

  Om alle info van je floppy van de Linux installatie te halen, gebruik
  het volgende commando:
    sed -n "1,/MOVIX_MARK/p" /dev/fd0 > bugreport.txt

  Hartelijk bedankt Jose' voor dit handige truukje!

  Kernel & MPlayer configuratie
  -----------------------------

  Je vindt de config files van deze eMoviX mplayer en vmlinuz in de "config"
  dir van dit pakket.

  Acknowledgments
  ---------------

  Ik wil graag de geweldige mensen van "Scripta Manent" bedanken
  http://www.scriptamanent.it voor het maken van het MoviX logo.
  En ook Andrea Assorgia voor z'n vele aanmoedigingen en adviezen, en het
  bedenken van de naam van het project. Ik wil m'n broer Vincenzo nog
  speciaal bedanken, die mij een hele snelle CD writer heeft gegeven,
  waardoor ik de Movix ontwikkeling kan versnellen! :-)