1
2                       eMoviX v0.8.0rc1 <http://movix.sf.net/>
3                  Author: Roberto De Leo <peggish@users.sf.net>
4           T�umaczenie: Tomasz "Zen" Napierala <zen@poczta.net.pl>
5                                      08.05.2003
6
7  Co to jest?
8  -----------
9  eMoviX jest mikro dystrybucj� Linuxa na bootowalnej p�ycie CD, pozwalaj�c�
10  automatycznie odtworzy� ka�dy plik video umieszczony w g��wnym katalogu
11  p�yty. Program obs�uguje wszystkie formaty wspierane przez Mplayer-a,
12  przede wszystkim DivX, ale r�wnie� AVI, MPEG, QuickTime, WMV, ASF, FLI oraz
13  kilka innych.
14
15  Je�eli umie�cisz w g��wnym katalogu p�yty plik z napisami i nazwiesz go tak
16  jak plik z filmem (np. film.avi i film.sub) to napisy zostan� wy�wietlone
17  automatycznie.
18
19  Innymi s�owy, je�eli umie�cisz tw�j film i eMoviX na tym samym CD, uzyskasz
20  nie tylko p�yt� z filmem, ale kompletne oprogramowanie potrzebne do
21  uruchomienia komputera i ogl�dania filmu. B�dziesz m�g� odtworzy� go na
22  dowolnym pececie, nawet nie posiadaj�cym zainstalowanego systemu operacyjnego
23  (lub maj�cym jaki� z�y OS :). Pod warunkiem �e sprz�t jest wspierany przez
24  Linuksa.
25
26  Oczywi�cie ca�y czas b�dziesz m�g� odczyta� CD i odtworzy� film za pomoc�
27  dowolnego, innego odtwarzacza. Jedyne co tracisz to oko�o 8Mb, kt�re eMoviX
28  zajmie na p�ytce.
29
30  Jak to zosta�o zrobione?
31  ------------------------
32
33  eMoviX zosta� stworzony na bazie oprogramowania dost�pnego w sieci:
34
35  syslinux v2.00       <syslinux.zytor.com>   bootowanie systemu;
36  mplayer v0.90rc3     <www.mplayerhq.hu>     odtwarzacz film�w;
37  alsa 0.9.1           <www.alsa-project.org> sterowniki kart d�wi�kowych;
38  slackware v8.0       <www.slackware.com>    baza dla mini-dystrybucji;
39  linux kernel v2.4.20 <www.kernel.org>       sprawia ze reszta dzia�a :-)
40
41  Jedyne co zrobi�em, to zebra�em to wszystko do kupy :-)
42
43  Z dystrybucji Slackware, kt�ra korzysta z SysLinuksa do bootowania,
44  wyci�gn��em ramdysk, zmodyfikowa�em go wyrzucaj�c mn�stwo niepotrzebnych
45  plik�w, doda�em wszystkie mo�liwe modu�y d�wi�kowe dla j�dra v2.4.20 i
46  oczywi�cie MPlayer-a. Po wystartowaniu systemu uruchamia sie skrypt perla,
47  (/usr/local/bin/movix.pl) kt�ry sprawdza wszystkie mo�liwe modu�y d�wi�kowe a
48  nast�pnie uruchamia odtwarzanie filmu.
49
50  Dokumentacja
51  ------------
52
53  A� do dzisiaj nie mia�em do�� czasu aby napisa� dokumentacje projektu, wi�c
54  ten plik zawiera praktycznie cala dost�pn� wiedz� nt. eMovixa. Mam nadziej�
55  ze znajd� troch� czasu w przysz�o�ci. Kr�tkie informacje s� dost�pne podczas
56  uruchamiania ka�dej p�yty z eMovixem.
57
58  Wymagania
59  ---------
60
61  --> Oprogramowanie:
62  Jedyn� rzecz� jakiej potrzebujesz s�: narz�dzie do utworzenia uruchamialnego
63  obrazu iso oraz co� do jego wypalenia na CD. Zar�wno pod Linuxem i M$ Window$
64  mo�esz u�y� mkisofs & cdrecord, dost�pnych pod adresem
65
66    ftp://ftp.berlios.de/pub/cdrecord/
67
68  W pe�ni funkcjonalne kopie mkisofs.exi i cdrecord.exe znajduj� si� w pakiecie
69  MoviX_Win32_Script.zip stworzonym przez Christophe Paris i dost�pnym do
70  �ci�gni�cia ze strony MoviXa:
71
72  http://sourceforge.net/project/showfiles.php?group_id=61561
73
74  Pakiet zawiera r�wnie� kilka po�ytecznych skrypt�w .bat napisanych przez
75  Christophe, kt�re u�atwi� korzystanie z mkisofs i cdrecord u�ytkownikom M$.
76  Wielkie dzi�ki dla Christophe za te pliki!
77
78
79  --> Sprz�t:
80
81  CPU
82  Tylko procesory kompatybilne z x86 s� wspierane i tylko i586 lub nowsze.
83
84  RAM
85  Mam wra�enie, �e eMovix-0.8.0 zu�ywa wi�cej pami�ci ni� poprzednie wersje, ale
86  32MB nadal powinny wystarczy� [pewnie �atwo mo�na sprawdzi� �e wystarczy z
87  ledwo�ci�, ale nie mam w tej chwili na to czasu], ale dla pewno�ci: ka�da
88  ilo�� powy�ej 40MB jest w porz�dku.
89
90  MYSZY
91  Do u�ywania eMoviXa nie potrzebujesz myszy.
92
93  KONTROLERY
94  Wszystkie wspierane przez j�dro 2.4.20 kontrolery s� obs�ugiwane. Powiadom
95  mnie je�eli masz problemy ze swoim kontrolerem.
96
97  KARTY WIDEO
98  Nie�atwo wymieni� karty z kt�rymi eMoviX wsp�pracuje.
99  Generalnie karty nast�puj�cych producent�w dzia�aj� z eMoviXem:
100
101    Matrox
102    Ati
103    NVidia
104    Intel
105    3Dfx
106    Sis
107    S3
108    Trident
109
110  ale prawdopodobnie wi�kszo�� kart b�dzie dobrze dzia�a�.
111  Mam w planach opublikowanie dok�adniejszej bazy kart dzia�aj�cych pod eMoviXem
112  na stronie WWW, wi�c je�li Twoja karta funkcjonuje a nie jest na li�cie, daj
113  mi zna� a dodam j� do bazy. Oczywi�cie daj r�wnie� zna� je�li nie dzia�a:)
114
115  BTW, je�eli u�ywasz trybu "aa" eMoviX zadzia�a niezale�nie od tego jak� kart�
116  posiadasz. Jasne, to tylko wizualizacja ASCII, ale - do diab�a - to dzia�a :-)
117
118  KARTY Z WYJ�CIEM TV
119  eMovix obs�uguje wyj�cie TV w kilku modelach Matroxa, ATI, S3 Savage i NVidii.
120  W wi�kszo�ci przypadk�w musisz u�y� trybu TV podczas uruchamiania (kiedy
121  pojawi si� logo eMoviXa wpisz TV i naci�nij Enter).
122
123  Karty ATI w��czaj� obs�ug� wyj�cia TV automatycznie, je�li karta jest
124  pod��czona do telewizora w momencie startu.
125
126  Matrox G400: wystartuj eMoviXa w trybie TV.
127
128  Matrox G450 i G550: wystartuj eMoviXa w trybie TV. Obraz pojawi si� je�eli
129  telewizor b�dzie pod��czony do drugiego wyj�cia karty.
130
131  NVidia: wystartuj eMoviXa w trybie TV.
132
133  S3 Savage: wystartuj eMoviXa w trybie TV. Ekran telewizora b�dzie czarny,
134  poniewa� sygna� zostanie skierowany na wyj�cie TV. Kiedy film sie sko�czy,
135  b�dziesz m�g� przywr�ci� ekran na monitorze wpisuj�c "s3switch lcd"
136  lub "s3switch crt".
137
138  KARTY DZWI�KOWE
139  eMoviX u�ywa sterownik�w ALSA.
140  Pe�na lista wspieranych kart z dok�adnymi wyja�nieniami znajduje si� na
141  stronie domowej projektu ALSA:
142    http://www.alsa-project.org/
143
144  KARTY SIECIOWE
145
146  eMoviX nie obs�uguje �adnych kart sieciowych.
147
148  PILOTY
149
150  Od wersji v0.8.0 eMoviX wspiera piloty!!! C�, aby by� dok�adnym, wspiera
151  tylko jeden model: pilota dodawanego do karty Hauppage WinTV (tak, to w�a�nie
152  ta, kt�rej jestem posiadaczem ;-) Pilot dzia�a wspaniale, i mam nadzieje ze
153  b�dzie jednym z d�ugiej listy obs�ugiwanych modeli, ale aby tego dokona�
154  potrzebuje od Ciebie wiele pomocy. Je�eli jeste� ekspertem i masz ochot� pom�c
155  w rozwoju eMoviXa, daj mi zna�!
156
157  Wspierane formaty audio/video
158  -----------------------------
159
160  Nie jestem w tych zagadnieniach ekspertem, wi�c mog� by� nieprecyzyjny.
161  Jedyne co wiem, to �e b�dziesz m�g� odtwarza� wi�kszo�� plik�w DivX, i
162  generalnie wi�kszo�� plik�w AVI, MPG, QuickTime, ASF i WMV. Je�eli chodzi o
163  zbiory d�wi�kowe, to wszystkie MP3 oraz OGG/VORBIS s� odtwarzane.
164
165  Je�eli wiesz, �e jakie� formaty nie dzia�aj� z eMoviXem daj mi zna�.
166
167  Instalacja
168  ----------
169
170
171
172  [OD T�UMACZA: Je�eli czytasz ten tekst to prawdopodobnie oznacza, �e nie
173  mia�em do�� czasu aby przet�umaczy� ca�e README przed ukazaniem si� nowej
174  wersji eMoviXa. Ale prawdopodobnie w CVS znajduje si� ju� kompletne
175  t�umaczenie, mo�esz wi�c je �ci�gn��. Link do CVS znajduje si� na stronie
176  projektu. Je�eli masz problem z obs�ug� CVS, zwr�� si� do mnie, a postaram Ci
177  si� podes�a� najaktualniejsz� wersj� dokumentacji.
178  Gotowy jest za to fragment o przygotowaniu p�yt po Windows przy pomocy NERO.
179  Na os�od� doda�em kilka fragment�w, kt�re nie znajduj� si� w oryginale:)]
180
181
182
183  Pocz�wszy od wersji 0.6pre2 instalacja odbywa si� z u�yciem mechanizmu
184  autoconf, wi�c instalowanie eMoviXa sprowadza si� do rozpakowania tarballa,
185  wej�cia do powsta�ego katalogu i wydania standardowych komend
186     ./configure
187     make
188     make install
189  Domy�lnie binaria "mkmovixiso" i "movix-version" zostan� zainstalowane w
190     /usr/local/bin
191  a wszystkie pliki z danymi eMoviXa zostan� skopiowane do
192     /usr/local/share/emovix
193
194  Je�eli to wszystko nie ma dla Ciebie sensu, lub wolisz raczej przygotowywa�
195  obrazy iso r�cznie, zapomnij o tym co w�a�nie przeczyta�e�.
196
197  K3b i eMoviX
198  ------------
199  Dzi�ki wieku pro�bom uzytkownik�w, obecna wersja K3b dost�pna w CVS wspiera
200  eMoviXa!!!
201  To oznacza, �e je�li zainstalujesz K3b z bie��cego drzewa CVS, b�dziesz m�g�
202  przygotowywa� p�yty z eMoviXem w rewelacyjnym �rodowisku graficznym!
203  W zwi�zku z tym, opu�� trzy kolejne sekcje :-)
204
205
206  Tworzenie bootowalnego obrazu p�yty z w�asnymi plikami audio/video
207  ------------------------------------------------------------------
208
209  [OD T�UMACZA: ch�opaki kt�re u�ywaj� Linuksa w wi�kszo�ci pewnie znaj�
210  angielski. Tak przynajmniej za�o�y�em i skupi�em si� raczej (z braku czasu) na
211  u�ytkownikach Wingrozy:). So sections below will coming soon]
212
213  UWAGA DLA U�YTKOWNIK�W WINDOWS: dop�ki nie istnieje tryb graficzny dla Windows
214  [je�eli w og�le b�dzie] naj�atwiejszym sposobem jest zainstalowanie CygWina
215  (http://cygwin.com). To bardzo fajny pakiet, kt�ry umieszcza w Windowsie
216  wi�kszo�� narz�dzi dost�pnych w Unixach, szczeg�lnie tych, kt�re s� niezb�dne
217  do uruchomienia skryptu "mkmovixiso", za pomoc� kt�rego �atwo mo�na utworzy�
218  obrazy iso z eMoviXem.
219
220  *** Nowy spos�b [nie uzywaj tego pod WinXX, chyba �e masz CygWina]
221
222  Aby uczyni� tworzenie rozruchowych obraz�w iso tak �atwym jak to tylko mo�liwe
223  w pakiecie dostarczamy skrypt perla "mkmovixiso". Typow� czynno�ci�, kt�r�
224  musisz wykona� aby utworzy� obraz iso zawieraj�cy pliki "plik1" i "plik2"
225  oraz zawarto�� katalogu "katalog", jest wpisanie
226
227    mkmovixiso -t "M�j tytu�" -o /tmp/movix.iso plik1 plik2 katalog
228
229  Pami�taj, �e mo�esz r�wnie� doda� playlisty do CD, je�eli chcesz aby utwory
230  na p�ycie by�y odtwarzane w konkretnej kolejno�ci. Aby dowiedzie� si� wi�cej
231  przeczytaj sekcj� "Playlisty (listy odtwarzania)"
232
233  Aby dowiedzie� si� wi�cej o opcjach mkmovixiso wpisz "mkmovixiso -h".
234
235
236
237  If you use always the same output file or same language or like to add
238  always the same extra options, you can avoid writing them explicitly
239  every time you run mkmovixiso creating a .mkmovixisorc file in your home dir.
240  Here is an example
241  [WARNING: these are more or less random setting, use your own ones!!!]:
242
243# <--------- .mkmovixisorc sample
244
245# my .mkmovixisorc file
246# all lines starting by # are comments!
247
248# default output file location
249output-file=/tmp/movix.iso
250
251# default boot label
252boot-label=MoviX
253
254# default font set
255subtitleFonts=polish
256
257# extra options for mkisofs
258extra-mkisofs-options=-J
259
260### Options to be passed to MPlayer
261
262# extra options for mplayer
263extra-mplayer-options=-double -aspect 4:3
264
265# options you want to be sure won't be used ny mplayer
266unwanted-mplayer-options=-fs -zoom
267
268# repeat the playback 5 times [0 = repeat for ever]
269loop=5
270
271# do not enforce DMA usage
272#[use it only if your system hangs during the boot]
273dma=n
274
275# play all files in random order
276random=y
277
278# reboot after playback is over
279reboot=y
280
281# turn off the PC after playback is over
282# shut=y
283
284# eject after playback is over
285eject=y
286
287# delete temporary directory
288auto-delete=y
289
290# ---------> end of .mkmovixisorc sample
291
292  No other options are available till now for the .movixrc
293
294  *** Old style [for winXX users willing to use mkisofs without installing
295  cygwin]
296
297  If you like better the good old way do something similar to this:
298
299  0. make somewhere, e.g. inside the "utils" folder",  a new directory,
300     say you call it "movix";
301  1. copy the folders src/isolinux and src/movix in the newly created
302     "movix" folder [just to avoid misunderstandings, the new "movix" folder
303     and src/movix are _not_ the same folder and the second won't appear anymore
304     in this section...];
305  2. if you have subtitles and wanna see them, create a folder called "mplayer"
306     inside "movix", create a folder "font" inside "mplayer" and copy inside
307     it your favorite character set from mplayer-fonts [inside "font" there
308     should be at this point a few files with extension .raw an a single file
309     called font.desc];
310  3. copy all the audio/video files you want in the "movix" folder;
311  4. run "sh mkmovixiso.sh" if you are on unix and "mkmvxiso.bat" if you are
312     on winXX; your bootable iso image will be created in "\tmp\movix.iso"
313     and "c:\temp\movix.iso" respectively.
314     Remember to edit the _-V "Film"_ string inside the script if you want to
315     give a better title to your CD!
316
317  Please let me know if you find any mistake in this algorithm :-)
318
319  *** Don't wanna use mkisofs!
320
321  [poni�sza metoda nie zosta� przez mnie przetestowana, poniewa� nie mam Nero:).
322  Nie wiem r�wnie�, czy dobrze przet�umaczy�em nazwy opcji Nero]
323
324  U�ytkownicy Window$, kt�rzy nienawidz� mkisofs nadal mog� stworzy� bootowaln�
325  p�yt� CD, post�puj�c zgodnie z poni�sz� metod�, kt�r� przedstawi� mi
326  utalentowany Hakan Atac:
327  0. �ci�gnij bootowalny obraz dyskietki z eMoviXem;
328  1. odpal Nero :-)
329  2. zamknij kreatora (nie ma tam opcji bootowalnych CD);
330  3. wybierz wybierz File->New, nast�pnie CD-ROM (boot) z lewego obszaru,
331     znajdziesz si� w sekcji tworzenia obrazu bootowalnego;
332  4. wybierz �ci�gni�ty w kroku 0 plik jako obraz dysku;
333  5. w opcjach zaawansowanych, ustaw "Rodzaj emulacji" na "Bez emulacji";
334  6. umie�� katalog "isolinux" w g��wnym katalogu tworzonego CD.
335     WA�NE: je�eli chcesz u�ywa� napis�w, musisz w g��wnym katalogu utworzy�
336     r�wnie� podkatalog "mplayer/font" ("font" jest podkatalogiem katalogu
337     mplayer) i umie�ci� w nim ulubiony zestaw font�w. Na przyk�ad, dla polskich
338     font�w, musisz w katalogu "mplayer/font" umie�ci� wszystkie pliki, kt�re
339     znajdziesz w katalogu "mplayer/font/polish" pakietu z eMoviXem;
340  7. umie�� wszystki ppliki audio/video w g��wnym katalogu CD (nie umieszczaj
341     ich w podkatalogach!);
342  8. Je�li chcesz aby pliki by�y odtwarzane w konkretnej kolejno�ci, wrzu� jedn�
343     lub kilka `playlist do katalogu "movix". Domy�lnie eMoviX odtworzy playlist�
344     nazwana "movix" (je�li taka b�dzie).
345  9. wypal CD!
346
347  Wielkie dzi�ki dla Hakana Ataca za dostarczenie sposobu wypalania bootowalnych
348  p�yt CD pod Nero!
349
350  [OD TLUMACZA: niedlugo wrzuce tu grafe obrazujaca to co czytaliscie wyzej]
351
352
353  MultiSession
354  ------------
355
356  To learn how to add sessions to an eMoviX CD you can read the docs on
357  http://advancemame.sourceforge.net/doc-advcd.html
358  in sections 5-7.
359  WARNING: making an eMoviX multisession CD with Nero is tricky because
360  Nero is not aware of the Rock-Ridge CD format, so please *read* the
361  sections above.
362  NOTE: a user suggested using Winimage to add files to a bootable ISO file
363  under WinXX. I had no time to test this, so if you try it please let
364  me know if it works!
365
366  Usage
367  -----
368
369  Once you have your iso image you can burn it over a CD with something
370  like
371
372     cdrecord dev=0,0 -v -eject /tmp/movix.iso
373
374  or just use Nero or any package able to burn iso images on CDs.
375
376  Leave the newly created CD in the CD-ROM drive and reboot your PC: if
377  everything went fine your PC will boot from the CD and after a few seconds
378  the mplayer copy contained in eMoviX will start playing all of your files.
379
380  Boot Labels
381  -----------
382
383  There are a lot of video cards out there and a lot of mplayer video drivers
384  and not necessarily all of their combinations work well together.
385
386  The movix.pl script tries to determine automatically the best options for you,
387  so that you don't need in general to enter anything at the boot prompt.
388
389  But in case you are not satisfied with the playback video quality there
390  are a few extra boot labels you can try to force eMoviX to use a particular
391  driver:
392
393     Label       Comment
394
395     MoviX    -  The default label causes the movix script to choose
396   (default)     automagically the best mplayer driver for your card.
397
398      sdl     -  Very good subtitles rendering but not the best video quality.
399
400     vesa     -  The "vesa" driver should work for most cards.
401
402     vesaFB   -  Use the generic vesa FrameBuffer driver.
403
404      FB      -  Use the specific FB driver for yr card (if any).
405
406      aa      -  Watch your videos in ASCII format! :-)
407
408     aa1024   -  Watch your videos in ASCII format at a 1024x768 resolution.
409
410     aa1280   -  Watch your videos in ASCII format at a 1280x1024 resolution.
411                 (these last two requires a CPU >= 1GHz)
412
413      TV      -  Initialize the applications [if any] needed to activate
414                 the TV-out of your card.
415
416There are also two extra labels that can be useful too when you
417forget an eMoviX CD in your drive:
418
419    hd    - forget the CD and boot from the HD
420    floppy    - forget the CD and boot from the Floppy
421
422Thanks a lot to Christophe Paris for this nice suggestion,
423I use it many times a day!
424
425  Boot Arguments
426  --------------
427
428  You can also provide at boot time a few options that will be automagically
429  passed to the movix.pl script to modify its behaviour:
430
431            Boot Args  Values     Effect
432
433              SLOW       y,n      By default movix slows down your CD-ROM drives
434                                  to decrease their noise, but sometimes this
435                                  messes
436                                  them up. If your CD drive seems to behave in
437                                  some
438                                  strange way try using this option.
439
440              ACCEL      sw,no    Force software or no rescaling. If your
441              playback
442                                  appears to be very slow you can try "ACCEL=no"
443                                  to make it smoother [but your movie won't be
444                                  rescaled
445                  to fullscreen!].
446
447              VO_DRIVER  <driver> Force vo driver (read mplayer DOCS first!).
448
449              MP_OPTIONS <opts>   Add mplayer options (same as above!).
450
451              LIST       <list>   Use "list" as default playlist.
452
453              DMA        y,n      Use "DMA=n" if your system hangs at boot time
454                  trying to access your CD drive.
455
456              SHUT       y,n      Power off PC after playing all CD files.
457                  This is especially useful if you are likely to
458                  fall asleep before the end of the playback :-)
459
460              REBOOT     y,n      Reboot PC after playing all CD files.
461
462              LOOP       <N>      Loops playback n times. Setting "LOOP=0"
463                  let mplayer playing your files for ever.
464
465              RANDOM     y,n      Play all the CD files in random order.
466
467              REGION     <region> Either one of NTSC, NTSC-J, PAL, PAL-B,
468                                  PAL-M, PAL-NC, PAL-60, PAL-M60 or SECAM.
469                                  For your TV-Out to work properly,
470                                  your video card needs to know what mode uses
471                                  your TV (ATI cards don't need this).
472
473              AUDIO     <N>       Audio card selection (if you have more than
474              one)
475                                  0 for the "first" card, 1 for the "second"
476                                  etc.
477                                  The order in which the audio cards are
478                                  detected
479                                  by eMoviX is somewhat arbitrary, so you might
480                                  need to try 0 and 1.
481
482
483Example: if you like the standard boot label but you want to play your
484"sleepy.asx" playlist and you want your PC to shut down after the playlist's
485end (probably because you shut down way before that) and you don't want to
486slow down your CD-ROM because you like that buzzing background, then you
487should use the folowing boot string:
488
489boot: MoviX LIST=sleepy.asx SLOW=n SHUT=y
490
491  How to play QuickTime files
492  ---------------------------
493
494  To play QuickTime files MPlayer needs a few special DLL. Their total size
495  is ~4MB and therefore I decided not to include them in the eMoviX package.
496  To be able to visualize QT files with eMoviX you have to perform the following
497  operations after installing eMoviX in your PC:
498
499  1. download the DLL files at the address
500    http://www1.mplayerhq.hu/MPlayer/releases/codecs/qt6dlls.tar.bz2
501
502  2. create a directory "win32" inside the $prefix/emovix/movix directory
503     (by default $prefix is /usr/local/share)
504
505  3. put the 4 files contained in qt6dlls.tar.bz2 inside the newly created
506     "win32" dir.
507
508  4. every time you put QT files in an eMoviX CD, add the "--hasQT" option to
509     the mkmovixiso you normally use.
510
511  Mplayer Menu
512  ------------
513
514  You can easily use the new MPlayer "menu" feature to "navigate" through
515  your videos selection and/or to change playlist!
516  Just wait for mplayer to start and press the key "m" to activate the menu.
517
518  The list of the other active keys for the mplayer is available on the
519  mplayer site.
520  The list of the most important keys is also available on every eMoviX CD
521  when the splash-page logo appears.
522
523  How to play other files after the playback is over
524  --------------------------------------------------
525
526  After eMoviX finished playing the CD content you can play any
527  other eMoviX CD just putting the new CD inside and running the command
528  "movix" at the prompt.
529  NOTE THAT UNFORTUNATELY this command won't play non-eMoviX CD though.
530
531  Playing DVDs, VCDs and non-eMoviX CDs
532  ------------------------------------
533
534  If you want to do this then you are looking for MoviX, not eMoviX!
535  Still, thanks to Balazs Barany, eMoviX now features a limited support
536  to play CD/DVD/VCD/AudioCD/MP3CD media: after watching your eMoviX CD you can
537  put any CD/DVD/VCD/AudioCD/MP3CD in one of your CD/DVD drives and use one of:
538    movix (to play a CD with audio/video files inside)
539    dvd N (where N is usually 1 or 2)
540    vcd N (where N is usually 1 or 2)
541    acd
542    mcd
543  to play it!
544  To get a much more powerful interface to MPlayer go back at the MoviX
545  web site and download the last MoviX or MoviX2 version!
546
547  What to do if audio is too low or absent
548  ----------------------------------------
549
550  If the audio is too low or absent even after maximizing it from mplayer
551  then you can try the following:
552  stop the movie, change console with ALT-F2, change the volume
553  with alsamixer, go back to the original console with ALT-F1 and
554  start back the playback with the "movix" command.
555  Note: you *cannot* do this while the movie is playing!
556
557  Playlists
558  ---------
559
560  Since version 0.6 eMoviX supports playlists!
561  The supported formats are: .asx .m3u .pls .txt .list
562
563  E.g. if you have a file "My Video.avi" and "My Audio.mp3" you
564  may write the following lists:
565
566  1. movix.asx
567
568  that will look like:
569
570  <asx version = "3.0">
571   <title>My List</title>
572   <entry>
573     <ref href = "/cdrom/My Video.avi"/>
574   </entry>
575   <entry>
576     <ref href = "/cdrom/My Audio.mp3"/>
577   </entry>
578  </asx>
579
580  2. movix.list or movix.txt
581
582  that will look like:
583
584  /cdrom/My Video.avi
585  /cdrom/My Audio.mp3
586
587  Don't know much about pls or m3u formats but I know that they work,
588  at least in some case :-)
589
590  eMoviX by default looks in the CD root for "movix.asx" or "movix.list"
591  or similar.
592  If none of them is available, then files should be played in alphabetic
593  order.
594  If you like to have more than a playlist you can use other names and activate
595  the other ones booting the CD with the LIST parameter.
596  E.g if you have two playlists named "movix.list" and "alt.list" and want to
597  use the second, then boot the CD in the following way:
598
599     boot: MoviX LIST=alt.list
600
601  NOTE: keep in mind that the new mplayer "menu" feature allows you to open
602  a new playlist (or even to move from file) without having to reboot!
603
604  Internationalization
605  --------------------
606
607  Starting from v0.8.0pre3 I started including translations of a few docs.
608  To get a complete list use "mkmovixiso -h".
609  To use boot messages in a language different from english use the
610  "-lang <lang>" option of mkmovixiso [find details with "mkmovixiso -h"].
611
612  Supported font sets
613  -------------------
614
615  Starting from v0.6pre2 the movix distro contains the following mplayer
616  font packages: czech, cyrillic, greek, hebrew, polish, russian and turkish.
617  All these packages support latin characters (iso-8859-1) plus their
618  specific characters.
619  By default the polish package is added to the iso image.
620  To have no fonts installed (in case you have no subtitles) use add the
621  -noSub option to the "mkmovixiso" command.
622  See "mkmovixiso -h" to set a different language.
623  In general you'll write something like
624     mkmovixiso -a filename -t "My title" -sub=greek -o /tmp/movix.iso
625  All fonts packages were extracted from
626    ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/
627  except for the polish fonts (sent me by Krzysztof Kajkowski) and hebrew
628  fonts (sent me by Pavel Bibergal).
629
630  Debugging
631  ---------
632
633  For debugging purposes, after a nice suggestion by Jose' M. Fandinho,
634  I added to eMoviX a script that will put on a floppy the following info:
635    1. output of dmesg
636    2. /proc/pci
637    3. movix script logs
638    4. settings of all cd-rom on the machine
639
640  To run the script just put an empty floppy in the floppy drive, write
641  "debug" and press ENTER.
642
643  To retrieve all the info from the floppy from your Linux installation
644  give the following command:
645    sed -n "1,/MOVIX_MARK/p" /dev/fd0 > bugreport.txt
646
647  Thanks a lot to Jose' for this nice trick!
648
649  Kernel & MPlayer configuration
650  -----------------------------
651
652  You will find the config files for the current eMoviX mplayer and vmlinuz
653  in the "config" dir of this package.
654
655  Acknowledgments
656  ---------------
657
658    I want to thank the great guys at www.scriptamanent.it for making the logo
659    for the eMoviX project. I also want to thanks my friend Andrea Assorgia for
660    all his encouragements and good advices about making eMoviX and for actually
661    having suggested the name of the project. Special thanks go to my brother
662    Vincenzo that bought me a very fast CD burner speeding up a lot the
663    development of this package! :-)
664