ptpimg_uploader

Upload image file or image URL to the ptpimg.me image hosting.

Features

• Upload local image files
• Rehost images from image services (e.g., from imgur)
• Copy resulting URL to clipboard
• BBCode formatting support
• Command-line and programmatic usage

Installation

Using pip (traditional install):

pip install ptpimg_uploader

This places ptpimg_uploader on your PATH — run it directly afterwards:

ptpimg_uploader image.jpg

To upgrade an existing installation:

pip install --upgrade ptpimg_uploader

Using uv (no Python setup required):

Install uv from https://docs.astral.sh/uv/getting-started/installation/, then:

Install permanently and run as a regular command (same workflow as pip):

uv tool install ptpimg_uploader
ptpimg_uploader image.jpg

To upgrade:

uv tool upgrade ptpimg_uploader

Run once without installing (useful for trying it out):

uvx ptpimg_uploader image.jpg

Run the raw script directly (uv auto-installs dependencies):

uv run ptpimg_uploader.py image.jpg

Manual Dependencies:

• Required: requests package

  • Debian/Ubuntu: apt-get install python3-requests
  • Other systems: pip3 install requests

• Optional: pyperclip package for clipboard support

  • Install via: pip3 install pyperclip
  • With uv: uv run --with pyperclip ptpimg_uploader.py --clip image.jpg

API Key Setup

1. Login to https://ptpimg.me
2. Open browser developer tools (View -> Developer -> View Source in Chrome)
3. Find api_key in the page source
4. Copy the hexadecimal string (format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

Set your API key using either:

Environment variable (recommended):

# Add to your ~/.bashrc or ~/.zshenv
export PTPIMG_API_KEY=your-api-key-here

Or use the command-line option: -k / --api-key

Usage

Get help:

ptpimg_uploader -h

Upload a local image:

ptpimg_uploader ~/seed/mytorrent/folder.jpg

Rehost from URL:

ptpimg_uploader https://i.imgur.com/eaT6j3X.jpg

Multiple uploads (mix-and-match files and URLs):

ptpimg_uploader ~/seed/mytorrent/folder.jpg https://i.imgur.com/eaT6j3X.jpg

Additional command-line options

• --bbcode: URLs will be wrapped in BBCode [img] tags

ptpimg_uploader --bbcode ~/seed/mytorrent/folder.jpg

• --clip: Place a resulting URL to clipboard (if pyperclip package is installed)

ptpimg_uploader --clip ~/seed/mytorrent/folder.jpg

• --nobell: Disable completion sound. If output is a terminal, a bell will be ringed on completion.

Programmatic Usage

The package can be used as a library via the upload function for programmatic access.

License

BSD

Acknowledgments

• mjpieters - a great refactoring and Python packaging
• lukacoufyl - fixing image upload order