home *** CD-ROM | disk | FTP | other *** search
/ Chip 2003 December / Chip_2003-12_cd1.bin / zkuste / movix / download / movix-0.8.1pre2-iso / README < prev    next >
Text File  |  2003-10-12  |  38KB  |  961 lines
  1.  
  2.          MoviX v0.8.1pre2 <http://movix.sourceforge.net/>
  3.           Author: Roberto De Leo <peggish@users.sf.net>
  4.                  October 12th, 2003
  5.  
  6.   What is it?
  7.   -----------
  8.   
  9.   MoviX is a mini Linux "live CD" distribution containing all the software 
  10.   to boot from 
  11.     CD/HD partition (either Linux or Winblows)/USB pen/CompactFlash card/Net
  12.   and start a console menu from which you can play, thanks to the great 
  13.   MPlayer package (http://www.mplayerhq.hu/), most of the audio/video files 
  14.   out there (and, if you are lucky, also internet radios and TV :-)
  15.  
  16.   If you already tried MoviX2, this is basically the same thing but it does not
  17.   use X [so it is much smaller!] and the menu is written in Perl [so it is much 
  18.   easier to develope and customize!].
  19.   Moreover, it supports TV-out for [at least!] ATI, Matrox, NVidia, CastleRock, 
  20.   Savage and Trident cards.
  21.  
  22.   Supported formats are all formats supported by mplayer, most noticeably
  23.   DivX and QuickTime but more in general any DVD, VCD, AudioCD, avi, mpeg,
  24.   ogm, wmv, asf, fli and a few others.
  25.  
  26.   BTW, MPlayer reads also mp3 & ogg/vorbis files, so you can also use it to
  27.   play music!
  28.  
  29.   MPlayer supports playlists so you can also use it to play in the order
  30.   you want any number of audio/video files.  
  31.  
  32.   If you are interested you'll find a copy of the config files for mplayer 
  33.   and the linux kernel in the main dir of this package.
  34.  
  35.   All relevant MoviX configuration files and scripts are in the src/movix 
  36.   folder from where will be automatically loaded in RAM at boot time, so
  37.   if you want to make any change to them it is enough to change those
  38.   files and make a new CD.
  39.   If you make some nice improvement please let me have a patch!
  40.  
  41.   How is it done?
  42.   ---------------
  43.  
  44.   MoviX is all made from software already available on the net.
  45.   Here is a list of the main packages I used:
  46.  
  47.   syslinux v2.00       <syslinux.zytor.com>
  48.   mplayer v0.92        <www.mplayerhq.hu>  
  49.   slackware v8.0       <www.slackware.com>  
  50.   linux kernel v2.4.22 <www.kernel.org>
  51.   Perl 5.8.0           <www.perl.org>
  52.   Curses-UI 0.76_01    <maurice@gitaar.net>
  53.   BusyBox 0.60.5       <www.busybox.net>
  54.   ALSA 0.9.6           <www.alsa-project.org>
  55.  
  56.   All I did is just put these pieces of software together :-)
  57.  
  58.   From the Slackware CD, that uses SysLinux to boot, I extracted
  59.   the ramdisk that I slightly modified getting rid of a lot of
  60.   unneeded files and adding all possible audio modules for kernel
  61.   v2.4.22 and of course the MPlayer.
  62.  
  63.   The menu has been written all in Perl using the nice Curses::UI
  64.   module made by Maurice Makaay (now mantained by Marcus Thiesen).
  65.  
  66.   The picture currently displayed in the MPlayer menu and during 
  67.   the music playback is by Coresis ( http://www.coresis.com )
  68.   and it is released under the GNU license.
  69.  
  70.   Want to help?
  71.   -------------
  72.  
  73.   There are literally _tons_ of feature that may be added to this menu.
  74.   I will never have time to add them all and in the future I will not
  75.   have so much time to spend on this projet, so if you like it and want
  76.   to help improving it just drop me an email!
  77.  
  78.   Documentation
  79.   -------------
  80.  
  81.   I strongly hope the few lines I wrote in the menu will be enough
  82.   to make everybody able to use it succesfully.
  83.   Hopefully someone eventually will improve the menu adding a help
  84.   and the many features that can be introduced.
  85.   
  86.   Requirements
  87.   ------------
  88.  
  89.   --> Software:
  90.  
  91.   The only thing you need to use MoviX is a software package to
  92.   produce the bootable isoimage and one to burn the image on CD.
  93.   On both Linux and M$ Window$ you can use mkisofs & cdrecord, 
  94.   that you can get from
  95.  
  96.     ftp://ftp.berlios.de/pub/cdrecord/
  97.  
  98.   Working copies of mkisofs.exe and cdrecord.exe are included in the
  99.   file MoviX_Win32_Script.zip packaged by Christophe Paris and available
  100.   for download in the usual MoviX download page
  101.  
  102.   Window$ users may be interested in downloading the Win32 MoviX setup
  103.   installer packaged by Clovis Sena (csena2k2@users.sf.net) that allow
  104.   to build very easily MoviX ISO images to be burned later on CD with
  105.   cdrecord, Nero or similar software.
  106.   There are also different Win32 setup packages recently built by Kangur, 
  107.   you can get them at 
  108.  
  109.     http://www.movixisocreator.prv.pl/
  110.  
  111.   Of course it does not matter with which application you write
  112.   the image on the CD, but you cannot make the iso image in the
  113.   usual easy way because you want it to become bootable.
  114.  
  115.   --> Hardware:
  116.  
  117.   CPU
  118.   Only x86 compatible are supported, and only >= i586.
  119.  
  120.   RAM
  121.   This MoviX cersion needs at least 64MB but it may work even with as low as 
  122.   32MB if you have a Linux swap partition with >=32MB on your HDD. 
  123.  
  124.   ==> NOTE: in order to keep MoviX working with as few as 64MB a few features
  125.   may be automatically disabled by the movix script, namely:
  126.   1. Win32 codecs support
  127.   2. Samba support
  128.   3. Multiple MPlayer subtitles character sets
  129.  
  130.   MICE
  131.   I could not manage make the mouse do anything good with Curses in a console
  132.   :-(
  133.   Hope to learn it soon.
  134.  
  135.   CONTROLLERS
  136.   All IDE controllers are supported.
  137.   All SCSI controllers supported by kernel 2.4.22 are also supported.
  138.  
  139.   VIDEO CARDS
  140.   It is not easy to say on which video cards MoviX will work. 
  141.   Cards brand that are generally known to work are:
  142.  
  143.     Matrox 
  144.     Ati    
  145.     NVidia 
  146.     3Dfx   
  147.     Intel
  148.     Sis    
  149.     S3
  150.     Trident
  151.  
  152.   but it is likely that the majority of video cards will work fine.
  153.   There are good chances that DXR3/Hollywood+ cards now works, please
  154.   let us have your feedback!
  155.  
  156.   BTW, if you use the "aa" mplayer driver than MoviX should work no matter 
  157.   which card do you have. Ok, it is ASCII visualization but, what the hell, 
  158.   it works! :-)
  159.  
  160.   If your video card works with MoviX please let me know so that
  161.   I can start writing a database of cards known to work.
  162.  
  163.   **KNOWN DXR3/H+ CARDS PROBLEM**
  164.   DXR3 modules (http://dxr3.sf.net/) are not yet able to autodetect the 
  165.   specific chipsets used in the card (apparently there are *many* different 
  166.   combinations) so it is likely that your card won't work with the standard 
  167.   settings.
  168.   In this case go in the Edit->DXR3 menu and try different combinations of 
  169.   the parameters until your card is able to visualize anything.
  170.   If nothing works drop me a note.
  171.   
  172.   AUDIO CARDS
  173.   MoviX makes use of the ALSA sound drivers.
  174.   A complete list of all supported cards with detailed info on each of them
  175.   is available form the ALSA home page at
  176.         http://www.alsa-project.org/
  177.  
  178.   In case your card has problems with ALSA, you can still try the old OSS
  179.   modules using the "OSS=y" option at the boot [after a very nice patch
  180.   by William Daniau].
  181.  
  182.   If you have more than one card on your PC, you can choose the one you want
  183.   with the "AUDIO=n" boot arg, where n=1,2,... [0 is the default value]. 
  184.   Unfortunately there is no way to know which number will be assigned to each
  185.   card so you'll have to make experiments :-)
  186.  
  187.   **KNOWN ISA AUDIO CARDS PROBLEM**
  188.   If you have an ISA card, it may fail to be automatically detected.
  189.   In this case try first of all to use the "DETECT=all" boot argument to 
  190.   let the system try all possible audio modules available.
  191.   If you are brave enough :-) , you can boot with the "AUDIO=n" boot arg
  192.   (so that audio is not loaded at all) and try to load by hand the right 
  193.   driver with "modprobe".
  194.   If nothing works, drop me a note and cross your fingers :-)
  195.  
  196.   ETHERNET CARDS
  197.   All cards supported by kernel 2.4.22 are supported.
  198.  
  199.   REMOTES
  200.   Remotes support has been improved in this version.
  201.   Tested working remotes are: 
  202.    1. Hauppauge (bundled with TV cards)
  203.    2. AST Logitech serial remote
  204.    3. Pinnacle PCTV (41 keys)
  205.  
  206.   To make new remotes work with MoviX, a line must be added to the
  207.   src/movix/remotes.data listing the model, the driver name, the device 
  208.   that lircd uses with it and the kernel modules needed to be loaded.
  209.   This is necessary because unfortunately some serial remote uses the 
  210.   standard Linux serial driver while other serial remotes use the lirc's 
  211.   own serial driver and so on.
  212.  
  213.   If you have a remote working on your Linux box, please help the
  214.   project support new remotes sending directly to me or in the movix 
  215.   forums all data needed to activate your remote!
  216.  
  217.   USB
  218.   All relevant USB devices supported by the 2.4.22 kernel should be 
  219.   automatically used by the system.
  220.  
  221.   FireWire
  222.   All relevant FireWire devices supported by the 2.4.22 kernel should be 
  223.   automatically used by the system.
  224.  
  225.   Installing MoviX on a CD
  226.   ------------------------
  227.  
  228.     --> ISO package
  229.  
  230.    Usually a few days after a new version is out I upload a .zip file 
  231.    containing a ready-to-be-burned bootable MoviX ISO image, so if you are 
  232.    particularly lazy you can get that and skip the rest of this section 
  233.    ***unless you want to make  any change to the standard settings***
  234.    
  235.    It is possible that you may modify the stabdard ISO package with the win32
  236.    utility WinISO (www.winiso.com). The application is not open but it is free 
  237.    to us it to modify small ISOs.
  238.  
  239.     --> Win32 Setup
  240.  
  241.   Thanks to Clovis Sena & Kangur, all *MoviX* distros have now a Win32 
  242.   installation file, so if you are a WinXX user you may use that file to 
  243.   create a customized ISO image and skip the rest of this section.
  244.   You can get these packages in the usual MoviX download directory and at
  245.  
  246.     http://www.movixisocreator.prv.pl/
  247.  
  248.     --> MoviXMaker
  249.  
  250.   Thanks to Pascal Giard there is now a GNU/Linux Perl GTK+/Gnome/GladeXML 
  251.   interface to help you create customized ISO images for [e]MoviX[2] in secs!
  252.  
  253.   New MoviXMaker packages are available at
  254.  
  255.     http://savannah.nongnu.org/projects/movixmaker/
  256.  
  257.     --> Custom setup for Win & Lin OS
  258.  
  259.   If you are not familiar with the procedures to create a bootable CD,
  260.   below you get step-by-step instructions for Linux & M$ Window$.
  261.  
  262.   0. Let's assume your untarred MoviX package is in /usr/local/movix-0.8.1pre2/
  263.  
  264.   1. cd in the "/usr/local/movix-0.8.1pre2/" folder :-)
  265.  
  266.   2. There are a few packages you may want to download (I stopped including 
  267.      them in this package to make it as small as possible, but they are present
  268.      in the ISO package).
  269.  
  270.      To "install" the packages, all you have to do is copying the archives in 
  271.      the src/mplayer/codecs directory. 
  272.      Do *not* unpack the files, just copy the whole archive(s) you want to use.
  273.  
  274.      Here is the list:
  275.      
  276.       - Win32 codecs
  277.         http://www1.mplayerhq.hu/MPlayer/releases/codecs/win32codecs.tar.bz2
  278.       - QuickTime6 DLLs
  279.     http://www1.mplayerhq.hu/MPlayer/releases/codecs/qt6dlls.tar.bz2
  280.       - RealPlayer9 codecs
  281.     http://www1.mplayerhq.hu/MPlayer/releases/codecs/rp9codecs.tar.bz2
  282.       - RealPlayer Win32 codecs
  283.     http://www1.mplayerhq.hu/MPlayer/releases/codecs/rp9win32codecs.tar.bz2
  284.       - XAnim DLLs 
  285.     http://www1.mplayerhq.hu/MPlayer/releases/codecs/xanimdlls.tar.bz2   
  286.  
  287.   3. If you want to be able to play your DVDs, you probably need to include the
  288.      libdvdcss library.
  289.  
  290.      DISCLAIMER: the libdvdcss library makes use of the DeCSS algorithm, 
  291.      that has been declared *illegal* in some country (e.g. USA and Germany),
  292.      so before adding it I suggest you to make sure it is ok to use it 
  293.      in your country. 
  294.      I am in no way responsible of what you put in your MoviX version.
  295.  
  296.      Because of the extremely unclear status of the legal matters about DeCSS 
  297.      I can't even provide a link for those who legitimally can make use of it, 
  298.      but nevertheless all you should do is going in your favorite search engine,  
  299.      look for the package named libdvdcss-1.2.6-1.i386.rpm and copy that package 
  300.      in the src/movix dir.
  301.  
  302.   4. If you speak french, italian or spanish you may replace all txt files 
  303.      of the src/isolinux directory with the corresponding files of the 
  304.      boot-messages/fr or boot-messages/it or boot-messages/es directories.
  305.  
  306.   5. If you know what you are doing, feel free to modify the configuration files
  307.      in src/movix :-)
  308.  
  309.   6. Create the .iso file running 
  310.  
  311.     sh mkmovixiso.sh
  312.  
  313.      or 
  314.  
  315.         mkmvxiso.bat
  316.  
  317.      depending on the degree of Micro$oft-ness of your OS :-)
  318.      The scripts output the iso image in /tmp/movix.iso or
  319.      c:\temp\movix.iso respectively. 
  320.      Edit the scripts if you want to change this setting.
  321.  
  322.   7. Write the iso image with any package you like. 
  323.      E.g. with cdrecord you'd write something like:
  324.  
  325.      cdrecord dev=0,0 -v -eject /tmp/movix.iso
  326.  
  327.   If everything went fine, the CD you produced should be a bootable CD
  328.   and it will automatically boot and start the MoviX menu.
  329.  
  330.   ==> NOTE: if you are a window$ user, you probably want to use
  331.   Christofe Paris scripts! Read above about how to get them.
  332.  
  333.   Installing MoviX on a HD partition
  334.   ----------------------------------
  335.  
  336.   - Linux partitions
  337.  
  338.   If you have a Linux box installed on your PC, chances are you use LILO as a 
  339.   boot loader.
  340.   Starting from v0.8.1pre1 MoviX is able to boot from HD with LILO if you 
  341.   append to your /etc/lilo.conf file an entry similar to the one you can find 
  342.   inside the package file extras/hd/linux/lilo.conf.movix
  343.  
  344.   All you have to do is copying the content of the 'src' directory of this 
  345.   package in some directory, e.g. under /movix/, and adjust accordingly the 
  346.   lilo.conf.movix 'image=' and 'initrd=' entries.
  347.  
  348.   Moreover, you should modify the variables MD, MP and MF so that they contain 
  349.   respectively the hd number [0 = 1st disc of the primary IDE channel and so on]
  350.   and the partition number corresponding to the partition containing the movix
  351.   folder and the actual name you chose for the movix folder [if you called it 
  352.   /movix/ you don't even need to modify MF at all].
  353.   
  354.   - Windows partitions
  355.  
  356.   To boot MoviX from WinXX you need the loadlin package by Hans Lermen 
  357.   (http://elserv.ffm.fgan.de/~lermen/).
  358.   Since the loadlin.exe binary is very small I included it in this package 
  359.   inside the extras/hd/windows/ folder.
  360.   
  361.   All you have to do is copying the loadlin.exe file in some directory included
  362.   in your PATH (e.g. in c:\windows\command), copying the content of the 'src' 
  363.   directory of this package in some (simple) directory, e.g. in c:\movix, 
  364.   copying the extras/hd/windows/wininit.gz file in the c:\movix\isolinux 
  365.   folder and copying somewhere, say in c:\movix, the 
  366.   extras/hd/windows/movix.par file (give a look to the file to verify that the
  367.   data inside it correspond to your setup).
  368.  
  369.   At this point, boot your PC in DOS mode, open a MS-DOS prompt shell, cd in 
  370.   the c:\movix folder and run the command
  371.  
  372.     loadlin @movix.par
  373.   
  374.   Booting MoviX from the net
  375.   --------------------------
  376.  
  377.   It is not clear whether this feature is really useful but I used it to test 
  378.   MoviX on a discless EPIA board and so why not to explain how to do it? :-)
  379.  
  380.   Ingredients:
  381.   0. a client with a PXE NIC [it can work without it but it's too long to write
  382.      it down...]
  383.   1. a dhcp server [look in extras/net for a very simple dhcpd.conf sample]
  384.   2. a tftp server [I use the hpa tftp server:
  385.      ftp://www.kernel.org/pub/software/network/tftp/]
  386.   3. the pxelinux.0 from the SysLinux distro (included inside extras/net of 
  387.      this package)
  388.   4. a file called 'default' where the boot options will be kept
  389.  
  390.   Recipe:
  391.   0. create the /tftpboot dir and run the tftp server so that it serves files 
  392.      from there
  393.   1. create a /tftpboot/movix directory and copy there the contents of the 
  394.      'src' dir of this package
  395.   2. create a /tftpboot/pxelinux.cfg directory and copy there the 
  396.      extras/net/default file
  397.   3. start your daemons, boot your client and cross your fingers ;-)
  398.  
  399.   Installing MoviX on USB Pens & CompactFlash cards
  400.   -------------------------------------------------
  401.  
  402.   Starting from this release, a script has been added to let you install MoviX
  403.   on your USB pen or CompactFlash card with no hassles.
  404.  
  405.   MoviX distro size varies from ~20MB to ~30MB depending on how many codecs you 
  406.   decide to include in the src/mplayer/codecs directory, so you need for it a 
  407.   USB pen/CompactFlash card with >=32MB.
  408.  
  409.   You can install MoviX simply going in the 3rd console and running the script 
  410.   'install.pl'.
  411.  
  412.   If you still prefer to do everything by hand, in next two sections you'll 
  413.   find the instructions to install the MoviX files by hand.
  414.  
  415.   Installing MoviX on a CompactFlash card
  416.   ---------------------------------------
  417.  
  418.   Starting from MoviX 0.8.1pre1 it is possible to install MoviX on Compact 
  419.   Flash cards!
  420.   
  421.   The installation procedure differs slightly according to whether the card is 
  422.   connected to the PC through an IDE interface or a USB one.
  423.   In the last case, follow these instruction and then go ahead and follow also 
  424.   the ones in the next section ("Booting from a USB pen").
  425.  
  426.   ==> Making the card bootable
  427.  
  428.   You need to use SysLinux to make a card bootable.
  429.   You can get the SysLinux package from 
  430.  
  431.     http://syslinux.zytor.com/
  432.  
  433.   It contains the syslinux executables for both Linux and WinXX.
  434.  
  435.   Linux Instructions:
  436.  
  437.   To make bootable your card, just run
  438.  
  439.     syslinux /dev/XXX
  440.  
  441.   where XXX is the card partition [not the device! For example, if the
  442.   card device is /dev/sda then the partition is /dev/sda1].
  443.  
  444.   Windows Instructions:
  445.  
  446.   I don't know for sure, but I think that it should be something like
  447.  
  448.     syslinux X:
  449.  
  450.   where X is the device letter associated to the card.
  451.   If you try it out please report!
  452.  
  453.   ==> Copying the right files in the right place
  454.  
  455.    1. mount the card with something like:
  456.  
  457.         mount /dev/sda /mnt -t vfat
  458.  
  459.       [don't need to do that in DOS ;-) ]
  460.  
  461.    2. copy the extras/flash/syslinux.cfg file in the flash card
  462.  
  463.    3. edit the card syslinux.cfg and change the MD variable so that it 
  464.       corresponds to the flash card number as an IDE device [e.g. if you have 
  465.       two IDE HDs then Linux will see your card as IDE device 2, while if you 
  466.       have no HD then the flash card IDE device will be 0].
  467.  
  468.    4. create a 'movix' directory in /mnt with
  469.  
  470.     mkdir /mnt/movix
  471.  
  472.       and copy all 'src' files there with
  473.  
  474.     cp -R src/* /mnt/movix/
  475.  
  476.    5. move a few files in the flash card root:
  477.  
  478.     mv /mnt/movix/isolinux/kernel/vmlinuz \
  479.            /mnt/movix/isolinux/initrd.gz \
  480.        /mnt/movix/isolinux/*txt \
  481.            /mnt/movix/isolinux/mov* \
  482.            /mnt
  483.  
  484.    8. now you can boot from the flash card and enjoy ;-)
  485.  
  486.   Installing MoviX on a USB pen
  487.   -----------------------------
  488.  
  489.   Starting from version 0.8.1pre1, MoviX is finally able to boot from USB pens!
  490.   These same instructions are also good [I hope!] for booting a CompactFlash 
  491.   card from a USB interface.
  492.  
  493.   The instructions to install MoviX on a USB pen are the same as for a 
  494.   CompactFlash card except for the fact that to boot from a USB pen 
  495.   (or CompactFlash card with USB interface) you have to use the 
  496.   extras/usb/syslinux.cfg file rather than the one found on the extras/flash/ 
  497.   folder.
  498.   
  499.   Booting from USB though requires sometimes some extra wizardry.
  500.   I myself have been able to boot my EPIA M-10k from my USB stick only after 
  501.   Pascal Giard sent me this very precious link I suggest you to read carefully:
  502.  
  503.     http://rz-obrian.rz.uni-karlsruhe.de/knoppix-usb/
  504.  
  505.   The main info I extracted from there is that on some MB you have to enable the
  506.   USB Keyboard support in your BIOS or no USB will be able to boot, and moreover
  507.   that it is better to insert the USB device when the PC in not only turned off
  508.   but also *unplugged* or the BIOS may not detect its presence and so it won't 
  509.   be able to boot.
  510.   
  511.   Following these directions Roberto has been able to boot from EPIA board 
  512.   (very slowly unfortunately because he has a USB 1.1 pen). But we didn't
  513.   succeed with other MBs that, in principle, are supposed to boot from USB 
  514.   devices (Roberto: Asus A7V-E, Pascal: Asus A7V-X), so do not expect 100% 
  515.   chance of succeding: evidently USB boot is not very mature yet.
  516.  
  517.   There's an easy way to bypass all this: the next MoviX boot floppy will
  518.   be able to look for USB devices and boot from them, so if your BIOS won't
  519.   let you boot the good ol' floppy will fix this :-)
  520.  
  521.   Pls report any suggestion or success/failure about USB boot!  
  522.  
  523.   Usage
  524.   -----
  525.  
  526.   --> Boot
  527.  
  528.   Boot your PC from a MoviX CD. 
  529.   You have several option for the boot:
  530.  
  531.                        BOOT LABELS
  532.  
  533.    MoviX       This is the default label and should be able to select 
  534.                automatically the best mplayer options for you video card.
  535.                It makes use of the vesa FB linux driver at 800x600.
  536.  
  537.    vesaFB1024  Same as MoviX but with a 1024x768 resolution. 
  538.                Choose this if you think you are going to watch your videos
  539.                in ASCII! :-)
  540.  
  541.    vesaFB640   Same as MoviX but with a 640x480 resolution. 
  542.            Choose this if the previous two labels fail (most likely
  543.                because you don't have much RAM on your video card).
  544.  
  545.    FB          This uses the Linux FrameBuffer driver specific for your 
  546.                card (if any). It may be faster than the previous one
  547.                but I have no card to check it with.
  548.  
  549.    vesa        This driver should work with most cards around but most 
  550.                likely the MoviX menu will mess up soon and you'll have
  551.                to reboot often. 
  552.                Use it as a last resource.
  553.  
  554.    TV          Using this option, the code needed to activate your card 
  555.                TV-out is automatically used by the setHardware.pl script.
  556.                Supported cards are Ati, Matrox, NVidia, S3 Savage and Trident.
  557.                Probably also Voodoo and other cards work but I do not know,
  558.                so let me have some feedback!
  559.  
  560.    NVidiaTV    This is a label like TV, but it's especially meant for NVidia
  561.                cards. Please give us feedback if it doesn't work with your card.
  562.  
  563.  
  564.   To boot with a label different from the default one, just write the
  565.   label at the boot prompt and press ENTER.
  566.  
  567.   There are also two extra labels that can be useful too when you
  568.   forget a MoviX CD in your drive:
  569.  
  570.       hd      - forget the CD and boot from the HD
  571.     floppy    - forget the CD and boot from the Floppy
  572.  
  573.   Thanks a lot to Christophe Paris for this nice suggestion,
  574.   I use it many times a day!
  575.  
  576.   There are also a few boot parameters you can use:
  577.  
  578.   BootArgs   Values    Effect
  579.  
  580.    acpi       off      Turn off ACPI support. ACPI is a PowerManagement software 
  581.                        especially useful on laptops to avoid discharging your
  582.                        battery in just a few minutes.
  583.                        HOWEVER ACPI is still buggy and IT IS KNOWN TO HANG the
  584.                        boot on some machine, so if you can't boot your MoviX
  585.                        copy try first of all to turn off the ACPI.
  586.                        KNOWN BUG: owners of VIA MBs *MUST* turn ACPI off or most
  587.                        likely nothing will work!!!
  588.  
  589.    MOUNT       n       Do not let the movix script to mount your HD partitions.
  590.  
  591.    DMA         n       Do not try to activate DMA on CD drives. 
  592.                        Use this if during the boot process your CD seems to cause 
  593.                        a mess of error messages.
  594.  
  595.    ACCEL     sw,no     Force MoviX to use sw or no rescaling. 
  596.  
  597.    DETECT     all      Use the old hw detection method, i.e. try all possible
  598.                        modules until the right ones are found.
  599.                Use this if your audio card is not detected by the 
  600.                        default method.
  601.  
  602.    OSS         y       Use OSS audio modules instead of the new ALSA
  603.                        (use this if your audio card is not detected even 
  604.                         with DETECT=all)
  605.  
  606.    AUDIO     1,2,..    If you have more than one card and get no audio from
  607.                        your speakers, then probably MoviX choose the wrong one. 
  608.                        Try "AUDIO=1" to use your second card and so on.
  609.                        Use "AUDIO=n" to skip audio autodetection if you need
  610.                        to load audio modules by hand.
  611.  
  612.    USB         n       Do not activate USB support
  613.  
  614.    IEEE1394    n       Do not activate IEEE1394 support
  615.  
  616.    KB          fr      Use french kbd layout
  617.  
  618.    REGION     <region> Either one of NTSC, NTSC-J, PAL, PAL-B,
  619.                        PAL-M, PAL-NC, PAL-60, PAL-M60 or SECAM.
  620.                This is needed if you use the "TV" boot
  621.                    label unless you have an Ati card.
  622.  
  623.    TVCARD      1,2,..  Specify your TV card type if autodetect fails
  624.  
  625.    TVTUNER     1,2,..  Specify your TV tuner type if autodetect fails
  626.                        Check http://bt848x.sourceforge.net/config.en.html 
  627.                        for a complete list of cards & tuners.
  628.  
  629.    SCSI     <module>   Force MoviX to load the SCSI module.o module
  630.             (e.g. "SCSI=tmscsim")
  631.  
  632.    REMOTE   <model>    Tell MoviX to initialize your remote. Currently only 
  633.                        "hauppauge" and "logitech" are supported.
  634.  
  635.    splash    verbose   Do not hide kernel boot messages.
  636.  
  637.   Example
  638.   Boot with the default label, do not rescale the video, use the second audio
  639.   card and a Logitech remote:
  640.   
  641.      boot: MoviX ACCEL=no AUDIO=1 REMOTE=logitech
  642.  
  643.   --> Customizing the default boot parameters
  644.  
  645.   - Boot Label
  646.  
  647.   If you want to boot by default with a boot label different from MoviX2
  648.   then you should edit the src/isolinux/isolinux.cfg file and modify its
  649.   very first line.
  650.   
  651.   - Boot Args
  652.  
  653.   If you use often certain boot arguments, you can avoid having to digit them 
  654.   at every boot writing a file called 'bootrc' containing all your args one per
  655.   line and putting the file in the src/movix/ directory.
  656.   E.g. if you use always "ACCEL=no AUDIO=1 REMOTE=logitech" then you can write 
  657.   the following file:
  658.  
  659. # <--------- .bootrc sample
  660.  
  661. ACCEL=no
  662. AUDIO=1
  663. REMOTE=logitech
  664.  
  665. # ---------> end of .bootrc sample
  666.  
  667.   Boot args passed at the boot prompt have higher priority than the ones 
  668.   written in the bootrc files, so in the few cases you don't want your default
  669.   options you have a way to override them.
  670.  
  671.   --> Configuration File
  672.  
  673.   Starting from MoviX 0.8.0, it is possible to load/save from/to 
  674.   floppy a movix configuration file containing all possible parameters
  675.   that you can set from the MoviX menu.
  676.  
  677.   The name of this file is 'movixrc'.
  678.   Writing it by hand is not trivial and it is highly discouraged.
  679.   The best way to generate is using the "Edit->Save config" menu of MoviX:
  680.   once you find your favorite configuration, save it on a floppy and 
  681.   either use the floppy every time to load the config file using the 
  682.   "Edit->Load config" menu or burn a new MoviX CD after putting the 
  683.   movixrc in the src/movix/ directory. 
  684.   This way, the movixrc file will be automatically loaded at boot time 
  685.   by the movix scripts.
  686.  
  687.   You can also save audio mixer settings to floppy in the same way you save
  688.   movixrc. To load automatically this settings when MoviX start, just put
  689.   asound.state from the foppy (or your favorite GNU/Linux distro) in src/movix/
  690.   and burn a new MoviX CD.
  691.  
  692.   BEWARE: if you use such a "customized" MoviX CD in a different PC,
  693.   remember to remove the movixrc using the "Edit->Remove config" menu 
  694.   or there will be an inconsistency between MoviX config data and the 
  695.   actual hw of the PC and therefore much likely MoviX won't be able
  696.   to do much.
  697.  
  698.   MoviX Menu
  699.   ----------
  700.  
  701.   If it starts, you can safely remove the MoviX CD and use the console 
  702.   menu to load&play any DVD/VCD/Audio CD/file you want.
  703.  
  704.   ==> DVDs
  705.  
  706.   *** IMPORTANT DVD NEWS ***
  707.   Because of the DeCSS legal problems, no MoviX distro can read crypted 
  708.   DVDs unless *you* add *by your own* the libdvdcss.so library to the distro.
  709.   Read above what to do if in your country is legal to use the DeCSS algorithm.
  710.   **********************
  711.  
  712.   Starting from v0.8.0, thanks to a very nice patch by Max Weninger,
  713.   the DVD menu will automatically look for the movie track among the 
  714.   [usually many] DVD tracks and will at the same time fill the "DVD tracks"
  715.   menu with a list of all tracks available.
  716.   All audio and subtitles available languages will be also shown so that
  717.   you can choose your favorite ones.
  718.   To avoid having to chosse over and over the same audio/subs language you can 
  719.   set default ones in the "Edit->DVD" menu.
  720.   Moreover, the "Play->DVD" selection will automatically play the longest
  721.   DVD track, usually the one you want to see :-)
  722.  
  723.   ==> VCDs/XCDs/AudioCDs
  724.  
  725.   The same DVD mechanism has been imported to VCDs/XCDs/AudioCDs, so that 
  726.   now after loading their TOC you can choose which track to play.
  727.  
  728.   ==> CDs/HD Partitions
  729.  
  730.   Starting from MoviX 0.8.0, it is possible to play the whole content
  731.   of a CD/HD Partition with the "Play->CD" and "Play->Partition" selections.
  732.   Using this options, the movix script will automatically search the drive or 
  733.   partition for audio/video files and will play them all as a playlist. 
  734.   Once the playlist starts, you can use the MPlayer menu [see below] to navigate 
  735.   through the audio/video files contained in the drive/partition.
  736.  
  737.   ==> SlideShow
  738.  
  739.   Starting from MoviX 0.8.1pre2, this option allows to visualize all images
  740.   under some directory chosen by you.
  741.   A DirBrowser menu will let you choose a dir and each picture file under it
  742.   will be visualized by the 'fbi' binary with a temporal distance of 5 seconds.
  743.   
  744.   ==> Playing Files
  745.   
  746.   Starting from MoviX 0.8.0, when you choose a file in a folder containing subs 
  747.   and no sub file with the same name is found, then an extra file chooser 
  748.   will automatically appear to let you choose a subtitle [just press <Cancel>
  749.   if you don't want any].
  750.   
  751.   ==> MPlayer menu
  752.  
  753.   The MPlayer binary contained in MoviX is compiled with support for the new 
  754.   neat "menu" feature of mplayer: pressing "m" while mplayer is showing any 
  755.   video you should be able to access mplayer's native menu and navigate mplayer
  756.   options directly from inside mplayer!
  757.   This menu is also accessible from the MoviX menu presssing 'F4'.
  758.  
  759.   ==> Consoles
  760.  
  761.   There are 3 consoles active, you can choose which one to go pressing
  762.   ALT-F<n>, where n can be 1, 2 or 3.
  763.  
  764.   console 1 (default): is the one with the MoviX menu. When/if MoviX
  765.   menu crashes, it is restarted automatically so you don't have anymore
  766.   to launch the "movix" command. If you need a shell go to console 3.
  767.  
  768.   console 2: here you find the alsamixer, in case the mplayer volume
  769.   keys do not raise the volume enough or if you want to adjust 
  770.   bass/treble or other things.
  771.  
  772.   console 3: here you'll find a shell in case you want to run anything
  773.   [like nvtv].
  774.  
  775.   ==> Audio
  776.  
  777.   If you find the volume too low even when mplayer's volume is at its 
  778.   maximum value, just change console with ALT-F2, set all volumes
  779.   with alsamixer and go back to the original console with ALT-F1.
  780.  
  781.   ==> Playlists
  782.  
  783.   You can play video/audio playlists with mplayer opening them through
  784.   the Play->File menu.
  785.   The mplayer included in this version is able to use playlists with 
  786.   the following extensions: pls, m3u, asx, txt, list.
  787.  
  788.   ==> Net 
  789.  
  790.   If you have an ethernet card tehn MoviX will automatically try to
  791.   use its dhcp client (the 'pump' binary) to connect to a dhcp 
  792.   daemon; in other words, the DHCP boot arg is not needed anymore.
  793.  
  794.   If you are not connected to any DHCP server then you can configure
  795.   by hand your card setting the LAN parameters from the \
  796.   "Edit->MoviX Options" menu 
  797.  
  798.   After that you can either enter an URL through the Play->URL menu
  799.   or use a playlist you load from a CD or a HD partition through 
  800.   the Play->File menu.
  801.   I included two examples called hardhouse56k.pls and hardtrance56k.pls
  802.   [thanks to Richard Didd for these playlists!] in the movix dir of 
  803.   the MoviX CD.
  804.  
  805.   ==> Net volumes
  806.  
  807.   You can also mount remote nfs or samba [e.g. windows partitions] 
  808.   volumes accessing to the mount menu from the Play->Net menu.
  809.   After you mounted the volume, it should automagically appear in
  810.   the partition list and that way you can play any audio/video file
  811.   from it like if it was on your machine.
  812.  
  813.   ==> Subtitles character sets
  814.  
  815.   You can select/change the MPlayer character set and its properties 
  816.   from the Edit->Subtitles menu.
  817.  
  818.   ==> Adding Subtitles character sets
  819.  
  820.   To add a new character set to the MoviX ones, just add a new TrueType file
  821.   (lower-cased!) or a MPlayer fonts dir under the src/mplayer/mplayer-fonts dir.
  822.   The new set will be automatically added by the movix.pl script to the subs
  823.   font list.
  824.   If you want to use it as default, just set it as default in the movixrc
  825.   configuration file in the way explained above.
  826.  
  827.   ==> MoviX Menu fonts size
  828.  
  829.   Starting from this version, you can select/change the MoviX menu font
  830.   size from the Edit->MoviX menu.
  831.   This is particularly helpful when you use the TV-out, in which case you 
  832.   want to maximize the font size, or when you want to use the ASCII output,
  833.   in which case you want to minimize the fonts size.
  834.  
  835.   ==> TV-in
  836.  
  837.   Finally an Edit->TV menu is available and can be used to choose your
  838.   country's Chanlist and/or your area's channels.
  839.   Up to now the only local channels list available are the ones of my 
  840.   area, namely the island of Sardinia (Italy).
  841.   Just send me your own area's to have them added to the distro!
  842.  
  843.   The format of the local area channels is the xawtv format, and to
  844.   generate it it is enough using the 'scantv' utility under Linux
  845.   as explained by Balazs in the following forum thread:
  846.   http://sourceforge.net/forum/forum.php?thread_id=784341&forum_id=207427
  847.  
  848.   I included in MoviX the Balazs script that converts the widely
  849.   used (under Unix) xawtv format in the MPlayer's one, so that to add
  850.   your own channels it is enough adding a xawtv file in the 
  851.   src/mplayer/tv_channels/ directory, burning a new CD and select 
  852.   the new list from the Edit->TV menu.
  853.  
  854.   The program 'scantv' is now available in MoviX. You can use it to
  855.   generate your own xawtv channel file going in the 3rd console and
  856.   running something like the following:
  857.  
  858.     scantv -o mychannels.xawtv 
  859.  
  860.   Once you have the file, you can give it a try copying it under
  861.  
  862.     /tmp/tv_channels/
  863.  
  864.   and restarting (not rebooting!) the MoviX menu and choosing your new file
  865.   from the Edit->TV menu.
  866.   If the file works fine post it on the MoviX 'help' forum and it will soon
  867.   be included in the distro.
  868.  
  869.   Piloting the MoviX menu with a remote
  870.   -------------------------------------
  871.  
  872.   Starting from v0.8.0rc2 thanks to the blackkane suggestions in the Help Forum
  873.  
  874.   http://sourceforge.net/forum/forum.php?thread_id=882303&forum_id=207428
  875.  
  876.   the MoviX menu can be controlled through a remote!!!
  877.   Here's a list of the remote keys currently supported (for hauppauge remote):
  878.  
  879.   VOL+   ->   right arrow
  880.   VOL-   ->   left arrow
  881.   CH+    ->   up arrow
  882.   CH-    ->   down arrow
  883.   FULLSCREEN -> ENTER
  884.   SOURCE ->   Tab
  885.   TV     ->   Escape
  886.  
  887.   The Escape key is particularly useful to bring the menu to its starting status.
  888.   KNOWN BUG: for some reason at the first start the MoviX menu piloted by irpty 
  889.   fails setting the right size, but this may be a problem only in case you need
  890.   to use a filechooser. 
  891.   Nevertheless, it is enough to restart the interface with using the 
  892.   Quit->restart option to restore the normal status.
  893.   Piloting the menu with a remote is well worth this little bug, but of course
  894.   I hope it will be fixed soon.
  895.  
  896.   TV-out
  897.   ------
  898.  
  899.   TV-out should work fine on all Ati, Matrox, NVidia and S3 Savage video cards. 
  900.   EPIA MBs TV-out is also supported but no test has been made yet.
  901.   It is likely that it will work also with other cards, like for example with 
  902.   the Voodoo cards, but I am not 100% sure about that.
  903.   
  904.   If you manage to use the TV-out with other cards please let us know!!!
  905.  
  906.   Ascii Art
  907.   ---------
  908.  
  909.   MPlayer allows you also to watch a movie encoded in ASCII characters
  910.   thanks to the nice AA-lib (http://aa-project.sourceforge.net/aalib/).
  911.  
  912.   Unfortunately watching a movie using the "aa" driver messes up the
  913.   screen so after watching a video you have to close the MoviX menu
  914.   and restart it launching the "movix" command.
  915.  
  916.   Supported Audio/Video formats
  917.   -----------------------------
  918.  
  919.   I am not at all an expert in this so I cannot be very precise about this.
  920.   All I know is that you should be able to play most of the DivX files around
  921.   and more in general any AVI, MPG file, QUICKTIME, ASF and WMV should be ok.
  922.   About video files, all MP3 and OGG/VORBIS files should work.
  923.  
  924.   If you have examples of such files not working with MoviX please let me know!
  925.  
  926.  
  927.   Known bugs
  928.   ----------
  929.  
  930.   * ACPI/VIA incompatibility
  931.   
  932.   Owners of VIA motherboards *must* use the "acpi=off" argument or most likely
  933.   MoviX will behave erratically.
  934.   To avoid having to write that arg at every boot you can add it to the 
  935.   isolinux.cfg file.
  936.   For example, replace the line
  937.  
  938.   append initrd=initrd.gz ramdisk_size=13000 rw root=/dev/ram0 LABEL=MoviX video=vesa:mtrr vga=0x314
  939.  
  940.   with 
  941.  
  942.   append initrd=initrd.gz ramdisk_size=13000 rw root=/dev/ram0 LABEL=MoviX video=vesa:mtrr vga=0x314 acpi=off
  943.  
  944.   * NVidia TV-out
  945.  
  946.   Please use the newly created NVidiaTV label and give us feedback. It's been
  947.   tested with NVidia GeForce 2 MX400 and NVidia GeForce 4 MX440.
  948.  
  949.   Acknowledgments
  950.   ---------------
  951.  
  952.   I want to thank the great guys at www.scriptamanent.it for making the
  953.   logo for the MoviX project.
  954.   I also want to thanks my friend Andrea Assorgia for all his encouragements
  955.   and good advices about making MoviX and for actually having suggested
  956.   the name of the project. Special thanks go to my brother Vincenzo that
  957.   bought me a very fast CD burner speeding up a lot the development of this
  958.   package!
  959.   Finally I want to thanks Robos for his interest in the project and for
  960.   suggesting me the best way to develop this menu.
  961.