<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd" [ <!ENTITY at "@"> ]>
<!--
     http://rsget.pl/ page generated from index template.
     2010-2011 (c) Przemysław Iskra <sparky@pld-linux.org>

     NOTE: If you expected do see a web page, but all you see is this XML
   source it probably means your web browser cannot handle XHTML correctly.
                  Try using different web browser !
       
        In links, elinks or w3m press '\' to switch to HTML view.
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
	<title>rsget.pl: about</title>
	<link rel="stylesheet" type="text/css" href="/_style/screen.css" media="screen" />
	<link rel="stylesheet" type="text/css" href="/_style/print.css" media="print" />
	<link rel="shortcut icon" href="/_style/favicon.png" />
	<script type="text/javascript" src="/_style/screen.js"></script>

	<meta name="language" content="English" />
	<meta name="description" content="Basic information what rsget.pl is and what it is not. You can find more specific information in the subpages." />
	<meta name="robots" content="index,follow" />

	<link rel="Start" href="/" />
	<link rel="Contents" href="/" />
	<link rel="Index" href="/" />
	<link rel="Help" href="/about/" />
	<link rel="Bookmark" title="contact" href="/about/contact/" />
	<link rel="Bookmark" title="bugs" href="/about/bugs/" />
	<link rel="Bookmark" title="config" href="/about/config/" />
	<link rel="Bookmark" title="get.list" href="/about/get.list/" />
	<link rel="Bookmark" title="http interface" href="/about/interface/" />
	<link rel="Bookmark" title="logo" href="/about/logo/" />
	<link rel="Bookmark" title="new core" href="/about/new-core/" />
	<link rel="Bookmark" title="proxy" href="/about/proxy/" />
	<link rel="Bookmark" title="requirements" href="/about/requirements/" />
	<link rel="Bookmark" title="getting started" href="/about/start/" />
	<link rel="Bookmark" title="web page" href="/about/web/" />
</head>
<body id="body" class="no_rsget">

<div id="_lightL"></div>
<div id="_lightR"></div>
<div id="_msgBoard"></div>

<div class="column" id="_column0">
	<div class="head">
		<h1>rsget.pl</h1>
	</div>
	<div class="body">
		<a href="/"><img src="/_style/hook.png" class="logo" alt="–" /></a>
		<p>
		A powerful perl application
		designed to retrieve files from download services (like
		RapidShare, MegaUpload and <a href="/getters/">many more</a>).
		It has a long list of features implemented already
		and even longer TODO list.
	</p>
	<p>
		You can find more details on the <a href="/about/">about</a> page.
	</p>
	<p>
		If you already know you want it, grab latest tarball from
		<a href="/download/">downloads</a> and read
		<a href="/about/start/">where to start</a>.
	</p>
		<div class="sublist"><h2>Subpage list</h2>
<dl><dt><a href="/about/">about</a></dt>
<dd>Basic information what <strong>rsget.pl</strong> is and what it is not.
	You can find more specific information in the subpages.<br />
(<a href="/about/contact/">contact</a>,
<a href="/about/bugs/">bugs</a>,
<a href="/about/config/">config</a>,
<a href="/about/get.list/">get.list</a>,
<a href="/about/interface/">http interface</a>,
<a href="/about/logo/">logo</a>,
<a href="/about/new-core/">new core</a>,
<a href="/about/proxy/">proxy</a>,
<a href="/about/requirements/">requirements</a>,
<a href="/about/start/">getting started</a>,
<a href="/about/web/">web page</a>)</dd>
<dt><a href="/donate/">donate</a></dt>
<dd>Support <strong>rsget.pl</strong>.</dd>
<dt><a href="/download/">download</a></dt>
<dd>Download tarball files.<br />
(<a href="/download/svn/">svn</a>,
<a href="/download/r11838/">r11838</a>,
<a href="/download/r11666/">r11666</a>,
<a href="/download/r11550/">r11550</a>,
<a href="/download/r11377/">r11377</a>,
<a href="/download/r11322/">r11322</a>,
<a href="/download/r11270/">r11270</a>,
<a href="/download/r11190/">r11190</a>,
<a href="/download/r11111/">r11111</a>,
<a href="/download/r10943/">r10943</a>,
<a href="/download/r10926/">r10926</a>,
<a href="/download/r10883/">r10883</a>,
<a href="/download/r10871/">r10871</a>,
<a href="/download/r10782/">r10782</a>,
<a href="/download/r10666/">r10666</a>,
<a href="/download/r10581/">r10581</a>,
<a href="/download/r10504/">r10504</a>)</dd>
<dt><a href="/getters/">getter plugins</a></dt>
<dd>Detailed information about downloader plugins.<br />
(<a href="/getters/Premium/">Premium</a>,
<a href="/getters/Get/">Get</a>,
<a href="/getters/Video/">Video</a>,
<a href="/getters/Audio/">Audio</a>,
<a href="/getters/Image/">Image</a>,
<a href="/getters/Link/">Link</a>,
<a href="/getters/Direct/">Direct</a>)</dd>
<dt><a href="/news/">news</a></dt>
<dd>Current and past events.<br />
(<a href="/news/2010-10-12/">2010-04-07: new core</a>,
<a href="/news/2010-07-13/">2010-07-13: release</a>,
<a href="/news/2010-03-24/">2010-03-24: svn@github</a>,
<a href="/news/2010-03-21/">2010-03-21: web@github</a>)</dd>
<dt><a href="/screenshots/">screenshots</a></dt>
<dd>The absolutely most important web section of any application.</dd>
<dt><a href="/tools/">tools</a></dt>
<dd>Some tools for controlling rsget.pl.<br />
(<a href="/tools/console/">console</a>,
<a href="/tools/gtk-captcha/">gtk captcha</a>,
<a href="/tools/userscript/">userscript</a>)</dd>
</dl></div>

		<hr />
		<p class="large">
	Help <strong>rsget.pl</strong>, make sure it stays alive:
	<a href="/donate/">donate</a>!
</p>
<p class="large"><a href="/about/new-core/">Current donations: <strong>0€</strong>; required: <strong>2000€</strong></a></p>
		<address>2010-2011 (c) Przemysław Iskra &lt;sparky&at;pld-linux.org&gt;</address>
	</div>
	<hr class="foot" />
</div>

<div class="column" id="_column1">
	<div class="head">
		<h1>about</h1>
	</div>
	<div class="body">
		
		Basic information what <strong>rsget.pl</strong> is and what it is not.
	You can find more specific information in the subpages.
		<div class="sublist"><h2>Subpage list</h2>
<dl><dt><a href="/about/contact/">contact</a></dt>
<dd>How to contact us.</dd>
<dt><a href="/about/bugs/">bugs</a></dt>
<dd>How and where to report bugs and request new features.</dd>
<dt><a href="/about/config/">config</a></dt>
<dd>Config file example.</dd>
<dt><a href="/about/get.list/">get.list</a></dt>
<dd>Download list structure.</dd>
<dt><a href="/about/interface/">http interface</a></dt>
<dd>How to make best use of the http interface.</dd>
<dt><a href="/about/logo/">logo</a></dt>
<dd>rsget.pl logo</dd>
<dt><a href="/about/new-core/">new core</a></dt>
<dd><p>Old development path is coming to an end, but there is a new one!
	This page describes some hows and whys.</p></dd>
<dt><a href="/about/proxy/">proxy</a></dt>
<dd>Use socks and http proxy as additional interfaces.</dd>
<dt><a href="/about/requirements/">requirements</a></dt>
<dd>List of system requirements.</dd>
<dt><a href="/about/start/">getting started</a></dt>
<dd>Where to start if you have no idea how it works.</dd>
<dt><a href="/about/web/">web page</a></dt>
<dd>What was I smoking when I created this web page.</dd>
</dl></div>

		<hr />
		<p>
	<strong>rsget.pl</strong> is primarily designed to run on a
	small server on top of your home network. Any hardware capable of
	running perl will do, for me it is <em>AMD K6/2 450MHz with 320MB
		of RAM</em> but even a machine with 1/5 of those specifications
	should be enough.
</p>
<p>
	<strong>rsget.pl</strong> was tested and works as expected on a
	variety of UNIX-like systems, those include Linux, FreeBSD, NetBSD,
	Open Solaris and Mac OS X. There shouldn't be any problem with
	operating systems from UNIX family. Other operating systems, especially
	those which do not handle file paths in same way UNIX does (i.e.
	React OS or Windows, Mac OS) may not be supported.
</p>
<h2 id="c1_features"><a href="#c1_features">Features</a></h2>
<ul>
	<li>Perfect for screen session</li>
	<li>Support for many download services</li>
	<li>Supports multiple network interfaces</li>
	<li>Dead interfaces are kicked out (useful with unreliable vpn tunnels)</li>
	<li>Continues partially downloaded files (if download service allows it)</li>
	<li>Incorporates small HTTP server allowing to check the status of downloads,
		and add new links.</li>
	<li>Automatically updates itself from SVN.</li>
</ul>

<h2 id="c1_todo"><a href="#c1_todo">TODO</a></h2>
<ul>
	<li>Write more documentation</li>
	<li>When continuing partially downloaded data start few kb before the end and
		compare old with new.</li>
	<li>Add commands: pause downloads, allow/don't allow captcha, clean done
		downloads, and more</li>
	<li>File group support (first step for multiuser support)</li>
	<li>File priorities and group priorities.</li>
	<li><del>Selectable temporary directory.</del> <ins>Set tmpdir=</ins></li>
	<li><del>Fix freezing http server - move to separate thread/process ?</del>
		<ins>Should be fixed now.</ins></li>
	<li><del>Fix bugs in http server, and speed it up.</del>
		<ins>Those are list file writer problems.</ins></li>
	<li>Better file writing methods, to allow downloading from multiple sources.</li>
	<li>Backoff if captcha fails too many times; lower uri priority.</li>
	<li>If multi-download problem appears while checking files force check on
		another interface/ip.</li>
	<li><del>Possibility to mark uri as "cannot continue".</del>
		<ins>I'm not sure what I meant by it.</ins></li>
	<li><del>Investigate using user space tunnels (ssh, proxy) to use as
		additional interfaces.</del>
		<ins>Use http proxy or socks as:
		<tt>eth0, http=somehost.com:8080, socks5=localhost:9999</tt></ins></li>
	<li>Download rate limits. Soft limit - don't start another downloads if
		rate limit exceeded. Hard limit - don't allow download speeds
		over specified value.</li>

</ul>

<h2 id="c1_planned_features"><a href="#c1_planned_features">Planned features</a></h2>
<ul>
	<li>Multiuser support (may require major changes in the code).</li>
	<li>XML-RPC (or similar) to allow writing GUIs.</li>
	<li>Use SQL for storing links and other data. This should speed things up.
		At least SQLite 3, PostgreSQL and MySQL will be supported to allow
		user chose hers/his favourite.</li>
	<li>Premium accounts support and premium plugins.</li>
</ul>

<h2 id="c1_wishful_thinking"><a href="#c1_wishful_thinking">Wishful thinking</a></h2>
<ul>
	<li>Squid and iptables integration. To disallow users accessing
		download sites directly.</li>
	<li>File uploading.</li>
	<li>Download list sharing between daemons running on different hosts.</li>
</ul>

<h2 id="c1_not_todo"><a href="#c1_not_todo">Not TODO</a></h2>
<ul>
	<li>Lower memory footprint. -- I have done what I could,
		if it still is to much for your device try curl library with http
		support only (disable https, ftp and others).</li>
	<li>I am thinking about C version of the program with getters written in
		Lua, or some other minimal scripting language. It would enable it
		to run on even the smallest devices. -- Unless someone generously
		sponsors development of that version I will continue work on
		perl version only.</li>
</ul>

<h2 id="c1_command_line_options"><a href="#c1_command_line_options">Command-line options</a></h2>
<pre>For full list of command-line options check: rsget.pl --help. All those options
may also be set in config file ( $HOME/.rsget.pl/config ). Check 'README.config'
file for example config.
Each option requires a value, which may be specified immediately after '=' sign,
or as next argument. Underscores may be replaced with dashes.
Following command-line declarations are equivalent:
 --use_svn=update
 --use-svn=update
 --use_svn update
 --use-svn update
</pre>
		<address>2010-2011 (c) Przemysław Iskra &lt;sparky&at;pld-linux.org&gt;</address>
	</div>
	<hr class="foot" />
</div>


</body>
</html>

