<page xmlns="http://projectmallard.org/1.0/" type="topic"
id="install-clamtk">
  <info>
        <link type="guide" xref="index#welcome" />
        <credit type="author">
                <name>Dave M</name>
                <email>dave.nerd @ gmail.com</email>
        </credit>
  </info>
  <title>Installing ClamTk</title>

<p>It is always recommended that you install <app>ClamTk</app> from official repositories.  Check your distribution first, and always install from trusted sources.</p>

<p>Packages for some distributions are available at the <link
href="http://code.google.com/p/clamtk/">ClamTk</link> homepage.  Again, you should check with your distribution's sources first.</p>

<list>
		<item><p>For YUM-based distributions</p>
		<p>First, try to install it via a GUI interface - most distributions have programs to easily install whatever program you wish.  If this is unavailable, use the commandline and type</p>

		<p><cmd># yum install clamtk</cmd></p>

		<p>Assuming your distribution has <app>ClamTk</app> in its
repositories, this should do all the work for you.  If it is unavailable or you wish to manually install it, download it from the <link
href="http://code.google.com/p/clamtk/">ClamTk</link> homepage, and double-click it.  This should allow yum to work its magic.  To install it via commandline instead, type</p>
<p><cmd># yum install --nogpgcheck /path/to/clamtk-rpm-you-just-downloaded.rpm</cmd></p></item>

		<item><p>For APT-based distributions</p>
		<p>First, search through your distribution's GUI-based software installation tool.  This is the easiest method.  If it is unavailable, open a terminal window and type:</p>
		<p><cmd>sudo apt-get install clamtk</cmd></p>

		<p>If it is unavailable or you wish to manually install it, download the latest version from the <link href="http://code.google.com/p/clamtk/">ClamTk</link> homepage, and double-click it.  This should allow apt to work its magic.  To install it via commandline instead, type
                </p>

		<p><cmd>sudo dpkg -i /path/to/clamtk-deb-you-just-downloaded.deb</cmd></p>
                <p><cmd>sudo apt-get install -f</cmd></p>
                </item>

		<item><p>Installing manually by source</p>
		<p>You should never have to do this.  Don't.  Many people,
including me, package <app>ClamTk</app> to be easily installed with a double-click.  No, seriously, just double-click the rpm or deb.  Put down the source.</p>
		<p>However, one way to do this:</p>
		<p><cmd># mkdir -p /usr/share/perl5/vendor_perl/ClamTk</cmd></p>
		<p><cmd># cp lib/*.pm /usr/share/perl5/vendor_perl/ClamTk</cmd></p>
		<p><cmd># chmod +x clamtk</cmd></p>
		<p><cmd># cp clamtk /usr/local/bin</cmd></p>
		</item>
		
</list>

</page>
