README
------
(Last updated July 2, 2005)

1. Important Links

ClamAV		: http://www.clamav.net
ClamTk		: http://freshmeat.net/projects/clamtk/
Dag Wieers	: http://dag.wieers.com  #for excellent rpms
Fedora Extras	: http://fedoraproject.org/wiki/Extras
Debian		: http://www.debian.org

2. About

ClamTk is a frontend for ClamAV using Gtk2-perl. It is intended to be
an easy to use, lightweight program for Linux systems.

3. GUI

ClamTk started out using the Tk libraries (thus its name). I have
since switched to perl-Gtk2 (or Gtk2-perl, whatever). The Tk version
is still available on sourceforge.net. Also, I'll go back to 
maintaining the Tk version if there is a demand for it. There are
advantages and disadvantages to both.

I'm also open to a name change, but that seems like too much effort.

4. Cross-distro

RPMs and .debs are available from clamtk.sourceforge.net and yum repos.
An Ubuntu package is in the works.

5. Installation

RPMs:
The easiest way is to use the rpms.
For FC3 and earlier, use Dag's rpms. For FC4, Fedora Extras has
any necessary dependencies.
As root (or better, use su - or sudo):
# yum install clamav clamav-update clamav-data
and:
# rpm -Uvh clamtk-*.rpm

SOURCE:
The tarball contains all the sources - you can also launch the perl script
with:
	a. # perl clamtk.pl
	b. # chmod +x clamtk.pl
	   # ./clamtk.pl

DEBs:
# dpkg -i clamtk

6. Running ClamTk

	a. I would recommend launching ClamTk as root first, if only to 
	   ensure you have the latest virus signatures. The rpm version
	   of clamav insists on root doing this (I'm not complaining;
	   only pointing it out). The update feature is located under "Help"
	   - or you can use "ctrl-U".

	b. Also consider the options under "Options" and "Actions".
	   Under "Scan Options" you can opt to save a log of your
	   scanning, show hidden files (those beginning with a "."),
	   and/or show ALL files (typically, only those files which are
   	   infected or otherwise not clean are shown). 

	   Under "Actions", you have the choice of having ClamTk
	   just report viruses (the default), quarantine them, or
	   delete them (caution with this one!).

	c. Information on items quarantined is available under the 
	   "Quarantine" option. This is another safe option, along with
	   the default.

	d. Scan a file by either clicking the icon (first on the left), or
	   going under "File".

	e. Scan a directory by either clicking the icon (second on the left),
	   or going under "File". Also available is the recursive scan, which
	   will descend to all directories within the selected directory.

	f. You can STOP the scan by clicking the stop button located on the
	   gui toolbar (red circle with the white X).

7. Afterwards

If you've opted to save the results, you can view them by selecting the
"View Histories" option under "View".

You can also remove saved histories by clicking the "Delete Histories",
located just beneath "View Histories" under "View".

Clear away the output by clicking the clear icon (looks like a broom) on the
gui toolbar, or select "Clear Output" under "View".

8. Locale/Internationalization

If anyone's interested in providing translations, I'm open!

9. Limitations/Bugs

ClamTk will slow down during scans consisting of $lots_of_files.
That's due to the use of hashes.

10. Other

For feature requests or bugs, it's best to email me. You can also go
to the Sourceforge project page and submit requests/problems there
(http://sourceforge.net/projects/clamtk).

Please note that version numbers mean absolutely nothing to me.
A new version means it goes up 1. Or .01, whichever. Because I
changed from Tk to Gtk2 I did move the version number up 
significantly, but that was just to keep them separate.
Just pointing it out.

11. Thanks

	* Everyone who has contributed in one way or another to
ClamTk
	* Muppet and the gtk2-perl folks for their time and effort
	* Perlmonks.org for helping me learn Perl (and continuing
	  to do so!)
	* Ksnapshot for making snapshot-taking very easy

dave.nerd AT gmail DOT com
