Skip to main content

Download all files from your account recursively with aria2c

Project description

Build Status

Python script that sends download links to aria2c for download


This setup assumes you have aria2c up with rpc running

pip install putio-downloader


Usage: putio-download [OPTIONS]

  CLI entrypoint for downloader

  --oauth-token TEXT          [required]
  --root-watch-dir INTEGER    [required]
  --aria2c-secret-token TEXT  [required]
  --incomplete-dir TEXT       [required]
  --complete-dir TEXT         [required]
  --watch-folders TEXT        [required]
  --rpc-url TEXT              [required]
  -q, --quiet
  -v, --verbose
  --config FILE               Read configuration from PATH.
  --help                      Show this message and exit.


If you don't want to pass those options on the command line, you can work with a config file to pass all or just some of the following:

oauth_token = 'XXXXXXXX'
keep_folder_structure = 'true'
root_watch_dir = 0
incomplete_dir = '/download/incomplete'
complete_dir = '/download/complete'
rpc_url = ''
watch_folders = ['isos', 'news', 'videos']

For windows, directories must follow windows' directory formatting, ie.

incomplete_dir = 'C:\\download\\incomplete'
complete_dir = 'C:\\download\\complete'


Run the download script on an interval so you don't miss out on any of your files

*/10 * * * * putio-download --config ~/myconfig.ini >> ~/putio.log 2>&1

To prevent multiple instances of putio-download from running, consider using a wrapper script like the following:

COUNT=`ps -ef | grep putio-download | grep -v grep | wc -l`
if [ $COUNT == 0 ]; then
    putio-download --config ~/config.ini
	echo "already running..."

If you do use a script like this, make sure to update the crontab to point to it

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for putio-downloader, version 3.1.4
Filename, size File type Python version Upload date Hashes
Filename, size putio_downloader-3.1.4-py2.py3-none-any.whl (8.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size putio-downloader-3.1.4.tar.gz (6.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page