$Id: README,v 1.18 2001/03/19 05:33:35 tujikawa Exp $
Aria - yet another download tool
(c)2000 Tatuhiro Tujikawa

1. Disclaimer
-------------
This program comes with no warranty.
You must use this program at your own risk.

2. Basic features
-----------------
- Aria can avoid annoying CGI download page(Server Template feature)
  that usual download softwares cannot handle properly.
  If you encounter these CGI page, please inform me, then I write
  Server Template for it as long as I can.
- Recursive download feature with verious useful options(HTTP and FTP).
- Drag and Drop support(Mozilla, Galeon, Konqueror, Opera, Netscape).
  In Mozilla, not only url links, plain texts can be dropped.
- Aria can execute command when downloads complete.
- Aria can execute command according to the extention of retrieved file.
- Simple timer feature.
- graphical progress bar.
- download file via HTTP or FTP.
- CRC checking(both 16bit and 32bit).
- URL unfolding feature(also known as numerical download).
- HTTP proxy support.
- Split download.
- Simple but very useful menu and options.
- Cut and Paste support.
- Cookie support.
- Very stable.

3. Requirements
---------------
C++ compiler(I'm using gcc 2.95.5)
GTK version 1.2.6 or higher
Gettext 0.10.35 or higher

4. Compile and install
----------------------
Unpack the archive and enter aria source directory,
	./configure
	make
	make install

Then, after login your account, execute
	./mksetup

This will create .aria directory in your home directory.
This directory contains various configuration files and
save files.
./mksetup backs up your existing configuration files to *.back.

Every time you get new version of Aria, I STRONGLY recommend you to execute
./mksetup.

*For Debian users:
------------------
To install package,
dpkg -i aria_*.*.*-*_i386.deb

then, 	
	sh /usr/share/doc/aria/mksetup.debian

*For RedHat users:
------------------
To install package,
rpm -i aria-x.x.x-x.rpm

then, 
	cd /usr/share/doc/aria-*.*.*
	sh mksetup

5. If you are using galeon,...
------------------------------
In galeon setting menu, choose "handler->download".
In "Program" frame, choose "use command line"(or something like that),
and enter "aria -g %s" in "Command" entry.
(If you don't install Aria in search path, you may have to enter full
path of aria.)

Now, you can download every thing by Aria from galeon.

6. Configuration
----------------
If you wish to specify the font manually, edit ~/.aria/rc.aria.
The directory ~/.aria/save/ contains several configuration and save file:
Download list is saved to list.aria at the end of every session.

default.aria contains default item option.
http_proxy.aria contains HTTP proxy server information. The syntax of this
file is:
SERVERNAME[(':'|' ')PORT]
If PORT is omitted, 8080 is used. The lines starting '#' are a comment.

useragent.aria containes User-Agent definition. You can add your favorite
User-Agent there. The lines starting '#' are a comment.

server.aria is a Server Template File. This file defines file retrieving
procedure for specific web servers. Please read examples/server.aria.template
and server.aria.

command.aria is a command list that is executed when each download completes.
Please read examples/command.aria.template.

7. ICON SET
-----------
Icon set is a collection of icons that represents download status(1st column
of download list).

The icon set path is ~/.aria/iconset/
Create a directory under it, then place following xpm files in the directory
you created:
  filename     : memo
=====================================
  complete.xpm : download complete
  download.xpm : download in progress
  lock.xpm     : locked
  ready.xpm    : ready
  divide.xpm   : split download
  error.xpm    : error
  stop.xpm     : stop

Note that the size of xpm is 30x25.

You can select your own icon set in application settings menu.
In DISPLAY tab, select your favorit icon set, then click "Apply" button.
The entry name of icon set is the name of the directory you created.

8. FAQ
------

I. What is URL list?
--------------------
URLs deliminated by '\n' character
for example:
	foobar01.jpg
	foobar02.jpg
	foobar03.jpg

II. Please tell me valid CRC format
----------------------------------
valid format is <filename> <CRC> [<filesize>].
<filesize> can be omissible.

III. What is "paste URL list with unfolding" means?
-------------------------------------------------
If you copy an phrase "foobar_00-05.jpg", and activate this menu,
You can get following URLs:
	foobar_00.jpg
	foobar_01.jpg
	foobar_02.jpg
	foobar_03.jpg
	foobar_04.jpg
	foobar_05.jpg
You can specify alphabet in variable character like "foobar_aa-zz.jpg"
instead of decimal number. Also, "foobar_[aa-zz].jpg" produces same
results.

IV. What are the defferences between "Open URL list" and "Find Hyplerlink"?
--------------------------------------------------------------------------
If the file you want to read contains just URL list, use "Open URL list".
If the file is html file, use "Find Hyperlink".

V. I got these errors:
io error cannot open file server.aria
error occurred in template ' ' in file server.aria
ERROR: Unable to save default settings
ERROR: Unable to save app settings
ERROR: Unable to save proxy settings
ERROR: Unable to save download list
---------------------------------------------------
Aria itself has no ability to create the directory for setting files. 
You must create before using Aria. A script "mksetup" does this work.

If you use RPM package, run:
    cd /usr/share/doc/aria-*.*.*;sh mksetup
	      
If you use Debian package, run:
    sh /usr/share/doc/aria/mksetup.debian
	      
If you built Aria from tar ball, then enter source directory, run:
    ./mksetup

If you don't have mksetup, then visit http://aria.rednoah.com/

9. Contact
----------
E-mail:   tujikawa@rednoah.com
Web Site: http://aria.rednoah.com/
          http://rabien.virtualave.net/linux/linux_e.html

I realy need feedbacks. If you notice bugs or something, please tell me by
email or message board at my web page.
