uppy

Unofficial CLI client for Overcast® Premium upload feature

A simple command-line tool to upload audio files to your Overcast Premium account. This is an unofficial tool that interacts with Overcast's upload functionality.

Usage

usage: uppy [-h] [--login LOGIN] [--password PASSWORD] [--save-credentials] [--no-load-credentials] [-s] file

Unofficial CLI file uploader for Overcast

positional arguments:
  file                  File to be uploaded

options:
  -h, --help            show this help message and exit
  --login LOGIN         Email for Overcast account
  --password PASSWORD   Password for Overcast account
  --save-credentials    Save credentials for future use
  --no-load-credentials
                        Do not use stored credentials
  -s, --silent          Disable user interaction

Installation as a local executable

This is a simple single file script. To reference it from everywhere, I recommend to store it in ~/.local/bin/ as uppy - without the .py extension.

Make it executable:

chmod +x ~/.local/bin/uppy

Put this at the top of the file (requires uv to be installed).

#!/usr/bin/env -S uv run --script --quiet

Then you can run it from anywhere:

uppy <path/to/audio/file>

Features

• Upload audio files to your Overcast account
• Simple command-line interface
• Supports common audio formats accepted by Overcast

Legal Note

This is an unofficial tool and not affiliated with Overcast®. If requested by Overcast, this project will be discontinued.