Skip to main content

PTPImg uploader, handles local files and URLs, from the commandline

Project description

Upload image file or image URL to the image hosting.


Using pip:

pip install ptpimg_uploader


python install


Install python3 package requests (usually apt-get install python3-requests or pip3 install requests).

If you want clipboard support, install pyperclip too.

Run the script from the command line with python3

API key

To find your PTPImg API key, login to, open the page source (i.e. “View->Developer->View source” menu in Chrome), find the string api_key and copy the hexademical string from the value attribute. Your API key should look like 43fe0fee-f935-4084-8a38-3e632b0be68c.

You can export your API key (usually in .bashrc or .zshenv) using:

export PTPIMG_API_KEY=<your hex key>

or use the -k / –api-key command-line switch.

How to use


ptpimg_uploader -h

to get command-line help.

To upload an image file:

ptpimg_uploader ~/seed/mytorrent/folder.jpg

To rehost an imgur image:


An uploaded URL will be printed to the console.

If pyperclip python package is installed, the URL will be additionally copied to the clipboard.

You can specify multiple files and URLs on the command line:

ptpimg_uploader ~/seed/mytorrent/folder.jpg

The resulting URLs are printed each on separate line, and copied to your clipboard with newlines in between.




  • mjpieters - a great refactoring and Python packaging

Project details

Release history Release notifications

This version
History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
ptpimg_uploader-0.1.tar.gz (3.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page