
         ooooo                     oo     o  o               oo     o
        M"   "Mo                    Mo  oM"  M                Mo  oM"
       M           oM""Mo  oM""Mo    "Mo"    Mo"""o  oM""Mo    "Mo"
       M    """M   MooooMM MooooMM   oMMo    M    "M M    M    oMMo
       "o     oM   M    o  M    o   oM  Mo   M    oM M    M   oM  Mo
        "MoooM"M   "MooM"  "MooM"  M"    "M  M"ooo"  "MooM"  M"    "M



| O produktu
| ~~~~~
GeeXboX je druh "divx box" softwaru. Jedn se o bootovac CD umoujc
sledovn film nebo poslouchn hudby. Podporuje celou adu formt jako
avi, mpeg, divx, ogm, rm, mp3, ogg, dvd, vcd , cdda. Obsahuje tak podporu
IR dlkovch ovlada a TV vstup na uritch typech grafickch karet.
Tato distribuce obsahuje nstroje potebn k  vytvoen vlastnho GeexboX iso souboru.



GeeXboX is a kind of "divx box" software. In fact, it is a stand-alone boot
CD which allows you to watch movies or listen to music. It supports many
formats, such as avi, mpeg, divx, ogm, rm, mp3, ogg, dvd, vcd and cdda.
It also supports some IR remote controllers and TV-Out for some graphic cards.
This archive contain the needed scripts to rebuild an iso image of the GeeXboX.


| Poadavky na systm
| ~~~~~~~~~~~~
Pro vytvoen GeeXboX iso souboru potebujete jedno z nsledujcch:
  - GNU/Linux systm s  mkisofs a mkzftree.
  - MAC OS X systm s  mkisofs a mkzftree.
  - MS Windows systm.

K instalaci GeeXboX potebujete:
  - GNU/Linux systm s syslinux.

Pro vytvoen GeeXboXu jsou zapoteb nsledujc standardn nstroje:
  - funkn GNU/Linux systm.
  - gcc C compiler.
  - GNU make
  - patch command.
  - nasm assembler.
  - bzip2 a gzip.
  - mkfs.ext2 a mkfs.vfat
  - wget download tool (nen zapoteb pokud mte plnou verzi GeeXboX balku).
  - mkisofs a mkzftree pro vytvoen iso souboru.
  - mkzftree pro komprimaci soubor v  iso souboru.
  - cdrecord (pro vyplen iso souboru).

A tak piblin 500 MB volnho diskovho prosoru.


| Vlastn nastaven
| ~~~~~~~~~~~~~~~

Pokud je GeeXboX nainstalovn na pevn disk nebo generovn
je velice jednoduch vytvoit osobn nastaven.


Mete pidat dal kodeky jako napklad rv9 nebo wmv9 pouhm nakoprovnm
do adrese GEEXBOX/codecs. Tyto kodeky mete nalzt v balcch na
http://www.geexbox.org/releases/geexbox-extra-codecs-nonfree.tar.gz

Dle upravit velk mnostv nastaven editac textovch konfiguranch  soubor.


* Jazyky:
    Mete zvolit preferovan jazyk nabdky nsledujcmi zpsoby:


    - uivatel GNU/Linux:
    Ped sputnm editujte dek "MENU_LANG=en" skriptu generator.sh
    na v preferovan jazyk nap "MENU_LANG=cz"


    - Uivatel Microsoft Windows :
    Pi sputn genertoru vyberte v rozbalovac nabdce poadovan jazyk.


    Poznmka : Toto nem vliv na volbu jazyka v DVD (vce v sekci o MPlayeru ).

    Pro seznam podporovanch jazyk nahldnte do adrese "language".
    Pokud nen V jazyk v nabdce mete jej vytvoit peloenm ji existujcch soubor menu
    language/menu_LANG.conf a language/help_LANG.txt,
    a pidnm LANG do language/lang.conf.

* MPlayer :
    Zde mete provdt nejvce nastaven a customizac.
    Nastaven se provdj pomoc souboru packages/MPlayer/mplayer.conf.
    Pravdpodobn budete chtt zmnit hodnoty jako nap. velikost OSD fontu.
    Mete pidat dal parametry jako nap. vchoz jazyk pro DVD (eg: alang=cz,en).
    Nejlepm mstem pro zskn parametr je manul MPlayeru.
    Uivatel linuxu (man -l build/MPlayer-*/DOCS/mplayer.1). Mete tak nahldnout na dokumentaci
    ( build/MPlayer-*/DOCS nebo na    http://mplayerhq.hu/DOCS/).
    Dalm souborem kde je dobr provdt pravy je packages/MPlayer/menu.conf.
    Mete odebrat volby, kter nepotebujete nebo jej peloit do vaeho jazyka.
    Poslednm souborem doporuenm k editaci je  packages/MPlayer/build kter obsahuje
    vbr monost MPlayeru.

* tv vstup :
    TV vstu je dosaen s pomoc drobnch aplikac urench pro dan typy grafickch karet
    V souasn dob pouvme  atitvout pro karty ATI, s3switch pro  karty S3  a nvtv pro karty nVidia
    (mon i karty intel i810 a karty 3dfx cards). Nastaven tchto pomocnch program je provedeno
    v config/tvout. Tam mete nastavi V TV standard (pal, ntsc...) a nastavit specieln volby pro nvtv.


    Zde mete tak definovat pomr stran  (nap. 4:3 nebo 16:9) toho doclte parametrem:

    TVOUT_ASPECT="4:3"

    Tento parametr bude pouit pro oba (TVOut i klasick  (CRT/TFT)) vstupy.
    V ppad e mte nestandardn monitor (Wide screen nebo videoprojektor) ete nastavit
    poadovanou vku/ku stejn jako obnovovac frekvenci.
    Parametry nastavujeme v souboru     /etc/mplayer/mplayer.conf .
    Vchoz hodnoty jsou uvedeny ne (odkomentujte dky u frekvenc pokud je chcete pout) :

    screenw=800
    screenh=600
    #monitor-hfreq=31.5k-50k
    #monitor-vfreq=50-90

* Lirc :
     Mete vybrat jeden z podporovanch typ dlkovch ovlada  editac souboru
    GEEXBOX/etc/remote. Dbejte na sprvn vbr pijmacho zazen v tomt souboru
    Pokud chcete zbnit piazen tlatek Vaeho ovladae podvejte se do souboru
    GEEXBOX/etc/lirc/lircrc_REMOTE.

* S :
    Nastaven st se provd v souboru GEEXBOX/etc/network.
    Zde mete nastavit IP adresu pro GeeXboX (vchoz nastaven je pout DHCP
    a pohud proces sele, je nastavena adresa 192.168.0.54.
    Lze zde tak nastavit uivatelsk jmno a heslo pro pstup ke sdlenm slokm
    systmu windows (vchoz nastaven se pipoj pouze k anonymnm sdlenm).
    Parametry pro NFS se nastavuj v souboru GEEXBOX/etc/nfs.

* wifi :
    GeeXboX se pokus automaticky zjistit sov nastaven.
    Pokud mte v systmu klasickou NIC a WiFi kartu pouze  posledn v ad bude nastavena.
    Pro pesn nastaven vyhovujc Vaemu prosted muste upravit soubor  /etc/network.


    Nsledujc dky se tkaj konfigurace WiFi :
    * PHY_TYPE="auto"      # Network physical type (auto|ethernet|wifi)
    * WIFI_MODE="managed"  # Wifi working mode (managed|ad-hoc)
    * WIFI_WEP=""          # Wifi WEP key
    * WIFI_ESSID="any"     # Wifi SSID

    Toto by mlo postaovat pro nastaven. Mete zvolit autodetekci nebo dokonce zvolit pouvn
    pouze WiFi nebo ethernetu.
    Stejnm zpsobem lze vybrat typ WiFi mdu mezi  managed a  ad-hocvetn nastaven WEP kle a SSID.

* gateway :
    GeeXboX podporuje pstup na s internet. Pokud mte na sti dostupn internetov pipojen
    mete ho sdlet pro GeeXBox pouitm routeru nebo brny. Pro tuto monost editujte IP adresu brny
    v souboru /etc/network file.

    * GATEWAY=""     # IP adresa brny ("" pro  DHCP nebo dn pstup na internet)

* nastaven TV :
    GeeXboX umouje pouit TV tuner. Systm se sna rozpoznat jak televizn tuner mte.
    Mete peskoit autodetekci vepsnm parametr Vaeho tuneru v  /etc/tvcard
    nsledujcm zpsobem :

 #TV CARD/TUNER Model (AUTO pro autodetekci nebo zadejte hodnoty z nsledujcch odkaz)
 #http://www.linuxhq.com/kernel/v2.6/2/Documentation/video4linux/CARDLIST.bttv
 #http://www.linuxhq.com/kernel/v2.6/2/Documentation/video4linux/CARDLIST.tuner

    TV_CARD=AUTO
    TV_TUNER=AUTO
    TVIN_STANDARD=pal


    Nechte parametr AUTO pokud si pejete aby se systm pokusil rozpoznat Vai kartu,
    nebo jej nahrate slem Va karty v souladu z odkaz uvedenmi ve.
    Pozor v ppad e nepouijete parametr AUTO muste znt pesn typ Va karty!.

    Pokud mte nastaveno mli by jste bt schopni pijmat TV signls (Composite a S-VHS)
    na va  TV kart. Stejn jako sledovat televizn vysln.
    Pro nalazen program muzte zadat region a frekvenci kanlu, kter chcete sledovat.
    To lze provst v souboru  /etc/tvcard  :

    # TV programy
    # Syntaxe : CHAN="Frekvence:Nzev programu"
    # Ukzka :
    # CHAN="29:France 2"
    # CHAN="K08:Canal +"
    # TV Channels List
    # Available : france, europe-east, europe-west, us-bcast, us-cable
    CHANLIST=france

    Jednotliv programy by se mli objevit v zkladn nabdce.

* audio nastaven :
    GeeXboX podporuje analogov  i  digitln  audio vstup pes klasick JACK
    nebo   RCA SPDIF.  Vchoz vstup je nastaven analogov. Tuto hodnotu mete zmnit editac
    souboru /etc/audio :

    # Output using SPDIF (yes/no), otherwise ANALOG output
    SPDIF=no

    Pamatujte, e muste nastavit SPDIF pokud chcete zvukovou kartu pipojit
    k externmu zesilovai pro dekdovn AC3/DTS stop.


* DXR3/Hollywood+ karty :
    Uivatel s tmto druhem hardware ani nemus mt video a zvukovou kartu k pouvn GeeXboXu.
    Ve relu lze pout pouze TV out s tmito kartami.
    Mon bude zapoteb nastavit poadovanou normu  (PAL/NTSC) v souboru  /etc/tvout
    fstejn jako audio vstup  (Analog nebo SPDIF) v  /etc/audio.

| Generovn
| ~~~~~~~~~~
Nejprve si prosm pette sekci o nastaven viz ve.

Potom jednodue vygenerujte iso soubor v Linuxu sputnm skriptu
  ./generator.sh
nebo ve windows aplikac
  generator.exe


| Instalace
| ~~~~~~~~~~~~

K instalaci je zapoteb vytvoit diskov oddl FAT16 s alespo 16MB volnho msta.

Pak je mon nainstalovat GeeXboX pod linuxem sputnm skriptu
  ./installator.sh
S nslednm zodpovzenm vech nastavujcch dotaz. Dbejte zven opatrnosti v prbhu instalace,
radji perute instalaci pokud si nejste jisti co dlte.


| PXE Bootovn
| ~~~~~~~~
GeeXboX je schopn bootovat ze st na bezdiskov stanici.
K dosaen tohoto stavu budete potebovat:

 -  DHCP server
 -  TFTP server
 -  NFS server
 -  PXE kompatibiln stanici :-)
Nejprve je nutn nakonfigurovat V DHCP server pro zasln PXE bootovacch informac
Zde je ukzka s isc dhcp:


allow booting;
allow bootp;

subnet 192.168.0.0 netmask 255.255.255.0 {
  range 192.168.0.128 192.168.0.192;
  option subnet-mask 255.255.255.0;
  option broadcast-address 192.168.0.255;
  next-server 192.168.0.1;
  filename "/tftpboot/GEEXBOX/boot/pxelinux.0";
}
Dal nastaven je adresa TFTP serveru.
Nakonfigurujte TFTP server na adres /tftpboot a nakoprujte vechny GeeXboX
soubory do tohoto adrese.
Napklad mete nakoprovat obsah GeeXboX CD z linuxu  v mdu TRANSPARENT DECOMPRESSION !
pro oven nahldnte do souboru sbin/init a zkontrolujte e je struktura normln.
Pokud jste vytvoili GeeXboX ze zrdrojovch soubor mete strukturu GeeXboXu vygenerovat pomoc
If you've built the GeeXboX yourself from sources, you can also generate
make pxe.

Pot mete editovat soubor /tftpboot/GEEXBOX/boot/pxelinux.cfg/default
pro nastaven nfsroot na sprvnou  NFS cestu pro  GEEXBOX strukturu.

Nakonec nastavte NFS pro export GEEXBOX struktury v /etc/exports
zhruba tmto zpsobem :

/tftpboot/GEEXBOX (ro)

 a /etc/hosts.allow asi takhle:

ALL: ALL

To by mlo bt ve nyn mete zkusit nabootovat a uvidte co se stane.


| Vytven ISO
| ~~~~~~~~

Nejprve prosm protte st o nastaven.

Potom vytvote iso pomoc:
  make
Nebo soubor rovnou vypalte  :
  make burn

Kdy jste hotovi mete GeeXboX stukturu smazat pro sporu msta na disku:

  make clean
Nebo smazat vechny soubory a zdroje:

  make distclean

Existuje vce nastavujcch pkaz pokud se chcete v GeeXboXu troch vrtat:

  scripts/get package        # sthnout balek
  scripts/unpack package     # rozbalit a pipravit balek
  scripts/build package      # vytvo balek
  scripts/install package    # instalovat balek s $INSTALL prefix
  scripts/clean package      # vymazat adresovou strukturu balku
  make exec                  # launch directly the GeeXboX in a jail
                             # WARNING: this is a highly experimental feature
                             # use it at your own risks.

Pokud jste vytvoili upravenou verzi GeeXboXu mete vytvoit tar.bz2 pomoc :
  make dist
nebo pln  tar (se vemi zdrojovmi soubory) pomoc :
  make fulldist
nebo geexbox genertor pomoc :
  make generator
nebo  geexbox instaltor pomoc :
  make installator
nebo   pxe strukturu pomoc :
  make pxe


| Konfigurace
| ~~~~~~~~~~~~~

* Globln nastaven :

    Je nejdleitjm krokem ped samotnm vytvenm GeeXboXu.
    Je uloeno v souboru  config/options, a jeho syntaxe je srozumiteln.
    Mete zvolit typ Vaeho procesoru, tma, a zda chcete pouvat True Type fonty nebo ne.
    Tak mete upravit nastaven Va vypalovaky aby bylo mon iso rovnou vyplit.

* Linux :
    Tohle je klasick nastaven Linuxu (packages/linux/linux.conf).
    Lze je editovat run nebo spustit skript scripts/unpack linux
    a pot  make menuconfig -C build/linux-* (ppadn pout Vmi preferovanou metodu namsto menuconfig).
    Zazlohujte /linux-*/.config do packages/linux/linux.conf.

* Lirc :
    Lirc umouje  ovldn GeeXboXu pomoc dlkovho ovladae. Nejprve se pokuste nalzt
    soubor s vam typem ovladae v  build/lirc-*/remotes (po proveden  scripts/unpack lirc) a
    pidejte jej do packages/lirc/install. Potom vyberte zazen (vchoz je  /dev/ttyS0 (COM1))
    a ovlada lirc a ulote jej do souboru packages/lirc/lircd_$REMOTE. Pot zvolte nastaven tlatek
    v souboru packages/lirc/lircrc_$REMOTE. Pro kad piazen tlatka muste vybrat jeho jmno ze souboru
    a zasociovat ho k urit akci. Tou me bt nkter z akc MPlayeru (ty naleznete v souboru
    build/MPlayer-*/DOCS/documentation.html#commands).


| pravy
| ~~~~~~~

Jako prvn je dobr podvat se na inicializan skript.
Ve skutenosti se jedn o skripty dva. Prvn je v packages/initrd/linuxrc
ale ten pravdpodobn nebudete chtt upravovat. Druh je  config/init a v nm se d
upravit nkolik monost nastaven.

Dal co by Vs mohlo zajmat je vytvoen novho balku.
To nen nic jinho ne spousta skript kter sleduj urit pravidla.
Vechny skripty musej bt ve stejnm adresi jako je program kter chcete "pibalit"

Zde je seznam skript kter mete vytvoit :
 - url : seznam adres kde lze sthnout zdrojov soubory program.
 - unpack : co se provede po rozbalen zdroj, ete napklad upravit konfiguran soubory,
            netk se aplikac zplat.
 - need_build : pouit pokud balek ji byl sestaven, a pro ujitn e nepotebuje reebuilt.
                Dojde k odstrann souboru .stamps/"package name"/build v ppad e rebuild nen nutn.

 - build :   vechny nezbytn kroky k vytvoen programu.
 - install : vechny nezbytn kroky k instalaci  programu. Zatek instalace by ml bt $INSTALL.

Kdy je soubor z url adresy pojmenovn zplata-program_name-...je automaticky zplata aplikovna
na rozbalen zdrojov soubory programu.

Mli by jste pamatovat e software na kterm GeeXboX b mus bt zkompilovn s
uClibc gcc wrapper.

Nakonec, nejlep cesta k vytvoen balku je podvat s edo ji hotovch.



| Licenn podmnky
| ~~~~~~~

Vechny programy pouit v GeeXboXu jsou chrnny jejich licenc.
Vechny jsou voln iiteln a vtina z nich podlh GNU licencovn.
GeeXboX jako takov. myleno skripty pouit pro jeho vytvoen spadaj pod GNU.
