The easiest script to synchronize all your Put.io files locally.
After the download, you can enable the option to remove the files from Put.io and also download your preferred subtitles if available in Put.io.
- Check and skip already downloaded files.
- Resume broken/stopped downloads, so you don't have to start from the begin of your huge file.
- Supports SOCKS5 proxy for an even more secure and anonymous transfer, with kill switch, so the application will stop if the proxy became unavailable. No leak connections.
- Option to delete the file from put.io after the download
- Option to download your preferred subtitles from Put.io.
- Simple and easy to run
- For free and forever free :)
My Local Put.io
uses the official Put.io API v2. Use this tool for legal purposes only. You are the only one responsible for what you are downloading from your put.io account, ensuring that your download does not infringe any legal or copyright constraints.
My Local Put.io
or the script author will not take responsibility for any of your downloading acts.
-
Install ruby 2.6.0+
-
Generate a token for your put.io account: https://app.put.io/authenticate?client_id=1&response_type=oob
-
Install the latest version of
my-local-putio
gem:gem install my-local-putio
To update your installed version:
gem update my-local-putio
my-local-putio -h
Usage: my-local-putio [options]
-t, --token TOKEN Put.io access token [REQUIRED]
-l, --local-destination FULLPATH Local destination path [REQUIRED]
-d, --delete-remote Delete remote file/folder after the download
-s, --with-subtitles Fetch subtitles from Put.io api
-v, --version Print my-local-putio version
--temp-destination FULLPATH Temporary destination for the incomplete downloads (Default: 'local_destination'/incomplete_downloads)
--silent Hide all messages and progress bar
--debug Debug mode [Developer mode]
--socks5-proxy hostname:port SOCKS5 hostname and port for proxy. Format: 127.0.0.1:1234
- -t or --token: Your Put.io Token. This attribute becames optional if you set
PUTIO_TOKEN
env variable with your token (Can be inline or into your bash profile). Check examples below. - -l or --local-destination: Local destination folder
Examples:
my-local-putio -t 123 -l Downloads
my-local-putio -l Downloads --token 123
my-local-putio -l Downloads -t token123 -d -s --socks5-proxy 127.0.0.1:1234
With Token variable (inline or exporting):
PUTIO_TOKEN=123 my-local-putio -l Downloads
export PUTIO_TOKEN=123
my-local-putio --local-destination Downloads/
- -d or --delete-remote: Delete the remote file/folder from put.io after downloading
- -s or --with-subtitles: Download subtitles from Put.io API if available. (Remember to set your preferred subtitle language on Put.io Settings website, otherwise no subtitle will be available for download.)
- -h: Print the help usage message
- -v or --version: Print the version of the application
- --temp-destination: Overwrite the default path (incomplete_downloads folder) of the temporary download files. After the download the complete file is moved to the selected local destination.
- --silent: Hide all messages and progress bar. Recommended for Cronjob tasks.
- --debug: Developer mode: Prints everything and expose URLs with tokens for debug purposes.
- --socks5-proxy: Enable the SOCKS5 proxy. If enabled, all the connections for PUT.IO API and the downloads will be performed using this proxy. If the socks connection became unavailable, the application will raise an error and will stop.
Examples:
my-local-putio -h
my-local-putio -t 123 -l Downloads --silent -d -s
my-local-putio -t 123 -l Downloads --silent
my-local-putio -l Downloads -t 123 --temp-destination /tmp --with-subtitles
my-local-putio --local-destination Downloads -t 123 --debug --with-subtitles
my-local-putio --local-destination Downloads -t 123 --socks5-proxy 127.0.0.1:3333
Verbose output example:
my-local-putio -t 123 -l Downloads -d -s --socks5-proxy 127.0.0.1:3333 --temp-destination /tmp
Starting My Local Put.io - version 3.0.0
https://github.com/rafaelbiriba/my-local-putio
=============================================
Full path of the local destination: /Users/user/Downloads
Full path of the temporary destination: /tmp
>>> Delete remote files enabled!
>>> With subtitles enabled!
>>> SOCKS5 enabled with 127.0.0.1:3333
=============================================
[LOG][2019-07-18 11:11:30] Getting file list for /
[LOG][2019-07-18 11:11:31] Getting file list for /ubuntu
[LOG][2019-07-18 11:11:31] Downloading: /ubuntu/ubuntu-18.04.2-desktop-amd64.iso
######################################################################## 100.0%
[LOG][2019-07-18 11:11:33] Deleting remote file: /ubuntu/ubuntu-18.04.2-desktop-amd64.iso
[LOG][2019-07-18 11:11:34] Finishing the download...
If you token is invalid, the script will stop with 401
error message.
First of all, thank you for wanting to help!
- Fork it.
- Create a feature branch -
git checkout -b more_magic
- Add tests and make your changes
- Check if tests are ok -
rake spec
- Commit changes -
git commit -am "Added more magic"
- Push to Github -
git push origin more_magic
- Send a pull request! ❤️