**************************************************************
*   FreeRapid Downloader                                     *
*      - Ladislav Vitasek aka Vity (c) 2008                  *
*   Homepage/Forum/Bugtracker: http://wordrider.net/freerapid*
*   E-Mail: info@wordrider.net - suggestions                 *
*   Poslední změna: 2008-10-25                               *
**************************************************************

=======================================
Obsah:
   I.   Co je FreeRapid Downloader
  II.   Systémové požadavky
 III.   Jak spustit FreeRapid
  IV.   Známé problémy a omezení
   V.   Řešení problémů
  VI.   Hlášení chyb
 VII.   Jak podpořit FreeRapid
VIII.   Často kladené otázky a odpovědi
=======================================


I.    Co je FreeRapid Downloader
=======================================

FreeRapid downloader je jednoduchá aplikace napsaná v jazyku Java, která umožňuje pohodlné stahování souborů z datového uložiště Rapidshare a mnoha dalších služeb.

Hlavní vlastnosti:
 - stahování souborů z více služeb najednou
 - možnost použítí seznamu proxy serverů
 - historie stahování
 - sledování schránky
 - rozhraní pro programování aplikací (API) pro přidání dalších služeb jako pluginy
 - automatické ukončení
 - možnost spuštění pod operačními systémy Windows, Linux a MacOS


Různé:
 - Drag&Drop URL adres

V současné době jsou podporovány následující služby:
 -  Rapidshare.com (chcete-li stahovat přes premium ůčet, navštivte prosím domovskou stránku pro více informací)
 -  FileFactory.com
 -  Uploaded.to
 -  MegaUpload.com
 -  DepositFiles.com
 -  NetLoad.in
 -  Megarotic.com a Sexuploader.com
 -  Share-online.biz
 -  Egoshare.com
 -  Easy-share.com
 -  Letibit.net
 -  XtraUpload.de
 -  Shareator.com
 -  Load.to
 -  Iskladka.cz
 -  Uloz.to
 -  HellShare.com
 -  QuickShare.cz


 II.    Systémové požadavky
=======================================

Doporučená konfigurace
    * Windows 2000/XP/Linux(jádro 2.4)* nebo vyšší operační systém
    * procesor Pentium 800MHz
    * minimální rozlišení obrazovky 1024x768
    * 40 MB volné operační paměti
    * 10 MB volného prostoru na pevném disku
    * Java 2 Platform - nainstalovaná alespoň verze 1.6 (Java SE 6 Runtime)

Aplikace pro své spuštění vyžaduje mít nainstalovanou alespoň Javu 6.0 (http://java.sun.com/javase/downloads/index.jsp , JRE 6).

Uživatelé Linuxu (Debian) like mohou použít tento příkaz k instalaci Javy:
     sudo apt-get install sun-java6-jre

III.   Jak spustit FreeRapid
=======================================

Instalace
------------
Rozbalte archiv se soubory do libovolného adresáře na pevném disku (cesta k aplikaci by neměla obsahovat speciální znaky typu '+', '!').
V případě přechodu na novější verzi smažte předchozí složku aplikace. Veškerá uživatelská nastavení jsou
zachována. Uložená uživatelská nastavení naleznete:
MS Windows: c:\Documents and Settings\YOUR_USER_NAME\application data\VitySoft\FRD
            and in registry HKEY_CURRENT_USER\Software\JavaSoft\Prefs\vitysoft\frd
Linux: ~/.FRD

NEKOPÍRUJTE novou verzi programu přes starou.


Spuštění
-----------
Windows
 Spusťte jednoduše frd.exe

Linux
 Spusťte příkazem ./frd.sh

All platforms
 Spusťte příkazem java -jar frd.jar


volitelné parametry při spuštění:

java -jar frd.jar [-h -v -d -D<property>=<value>]

volby
  -h (--help,-?)      tisk této zprávy
  -v (--version)      tisk informací o verzi a ukončení
  -d (--debug)        tisk podrobnějších informací o běhu programu
  -r (--reset)        reset uživatelských nastavení do výchozího stavu
  -m (--minim)        minimalizovat aplikaci po startu  
  -Dproperty=value    Nastavení interních hodnot vlastností (většinou pro účely ladění, testování)

Pokud je hodnota volby -D nastavena na 'default' (bez '), použije se výchozí hodnota.

Příklad - spuštění aplikace v ladícím módu:
  Windows OS: frd.exe --debug
  Linux/MacOS: java -jar frd.jar --debug


Více informací:
  - Neoficiální tutoriál pro uživatele Linuxu - Jak nakonfigurovat FreeRapid Downloader na Linuxu (ve španělštině)
    http://manualinux.my-place.us/freerapid.html


IV.    Známé problémy a omezení
=======================================
- Aplikace se nespustí, jestliže cesta k ní obsahuje speciální znaky typu '+', '%'
  - X změňte prosím umístění aplikace tak, aby cesta k ní neobsahovala speciální znaky
- ESET "Smart" Antivirus na operačním systému Windows blokuje spuštění FRD
  - X proveďte správné nastavení vašeho antivirového programu nebo spouštějte FRD tímto způsobem: frd.exe -Doneinstance=false
- Vždy řádně ukončete FRD, jinak může dojít ke ztrátě Vašeho seznamu souborů (eg. Windows shutdown with force option...)          
- Výběr stahovaných souborů tažením myší od shora dolů z nějakého důvodu zlobí :-(
    X vybírejte řádky v tabulce pomocí ctrl+kliknutí myší nebo vybírejte položky tažením od sdola nahoru
- Substance look and feel vyhazuje výjimku org.jvnet.substance.api.UiThreadingViolationException:
                                                     Component creation must be done on Event Dispatch Thread
    X ignorujte tuto výjimku v souboru app.log
- Výjimka java.lang.UnsupportedClassVersionError
    X pravděpodobně používáte starší verzi Javy (aplikace vyžaduje Sun Java verze 6 či novější)
- DirectoryChooser vyhazuje výjimku java.lang.InternalError nebo zamrzá na Windows Vista (64bit)
    X ignorujte tuto výjimku v souboru app.log
- java.lang.ClassCastException: java.awt.TrayIcon cannot be cast to java.awt.Component
    X ignorujte tuto výjimku v souboru app.log    
- Uživatelům Linuxu se nezobrazuje ikona v oznamovací oblasti
    X jediným řešením tohoto problému by mohl být přechod JRE na verzi 1.6.0_10-rc či novější


V.    Řešení problémů
=======================================
1. Nejprve si projděte sekci IV kvůli známým chybám a omezením
2. Pokusil(a) jste se již aplikaci ukončit a opět spustit? :-)
3. Navštivte domovskou stránku http://wordrider.net/freerapid a/nebo issue tracker na adrese http://bugtracker.wordrider.net/
   pro vložení oznámení o nalezené chybě
4. Můžete se pokusit odstranit konfigurační soubory (jejich umístění naleznete v sekci III - Instalace)
5. Spusťte aplikaci v ladícím módu:
   Windows OS: frd.exe --debug
   Linux/MacOS: java -jar frd.jar --debug
6. Nahlašte problém dle pokynů v sekci VI


VI.    Hlášení chyb
=======================================
Pokud objevíte chybu, nahlašte mi ji co nejdříve, aby mohla být opravena před vydáním další verze.
K nahlášení chyby  můžete použít issue tracker (preferováno), fóra projektu či můj osobní e-mail.

Napište prosím Vaši verzi JRE a operačního systému a přiložte soubor app.log (naleznete jej ve složce aplikace).
Usnadní nám to práci při identifikaci problému. Také nám velmi pomůže, pokud spustíte aplikaci s parametrem --debug.
Ignorujeme jednoduchá hlášení typu "Nejde mi spustit FRD. Co mám dělat?". Popište Vaši situaci a chování aplikace.


issue tracker: http://bugtracker.wordrider.net/
fórum: http://wordrider.net/forum/list.php?7
e-mail: bugs@wordrider.net (Vaše zpráva může být odchycena spamovým filtrem, proto tento způsob NEdoporučuji!)


VII.    Jak podpořit FreeRapid
=======================================
FreeRapid downloader je distribuován jako freeware. Pokud se Vám aplikace líbí a rádi byste chtěli ocenit tvůrce
nějakou finanční částkou za čas a zdroje vynaložené do vývoje , velmi nás to potěší.
Jsme obyčejní studenti, kteří musí platit webhosting, účty za naše přítelkyně atd...

PayPal: http://wordrider.net/freerapid/paypal
   nebo
použijte bankovní účet, jak je popsáno na domovské stránce http://wordrider.net/freerapid/


VIII.   Často kladené otázky a odpovědi
=======================================

Q: Proč jsi vytvořil další "RapidShare Downloader"?
A: 1) Protože nechci používat ruský software, který je pravděpodobně plný malwaru a spywaru.
   2) Protože si můžu sám jednoduše opravit automatické stahování.
   3) Protože ostatní existující aplikace jsou uživatelsky nepřívětivé a často postrádají důležite funkce.
   4) Protože můžu.

Q: Jak zapnout podporu příkazů pro vypínání na Linuxu a MacOS?
A: Pro více informací nahlédněte prosím do konfiguračního souboru 'syscmd.properties', který naleznete ve složce aplikace.
