autopost

A social media auto-poster for a blog.

Supported sites:

Twitter (currently untested)
Mastodon (any instance)
Reddit (any subreddit)
Bluesky

Installation

autopost requires Python 3.11 or newer, and is available on PyPI:

python -m pip install autopost

Usage

usage: autopost [-h] [-V] [-v] [--dry-run] [--config-file CONFIG_FILE] {manual,atom} ...

auto-posts social media updates

positional arguments:
  {manual,atom}
    manual              auto-post manually
    atom                auto-post from an Atom RSS feed

options:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -v, --verbose         be more verbose while running (default: False)
  --dry-run             perform a dry-run (default: False)
  --config-file CONFIG_FILE
                        the file to load for configuration (default: ./autopost.toml)

Examples

To do anything meaningful with autopost, you'll need to configure it. See autopost.example.toml for an example configuration file.

Once configured, you can use autopost to make a post manually:

$ autopost manual "test" --url "https://example.com" --tags foo bar
🎉 reddit:/r/enosuchblog: https://reddit.com/r/enosuchblog/comments/zldk8y/test/
🎉 mastodon:@yossarian@infosec.exchange: https://infosec.exchange/@yossarian/109509443715725349

...where --tags is optional.

Alternatively, you can use autopost atom to retrieve a post from an Atom-style RSS feed:

autopost atom https://example.com/feed.xml

In both cases, you can pass --dry-run to see what autopost would post instead of actually doing it:

$ autopost --dry-run atom https://blog.yossarian.net/feed.xml
dry run: would have posted Modernizing my 1980s sound system with URL:
https://blog.yossarian.net/2022/11/07/Modernizing-my-1980s-sound-system and tags: ['howto', 'workflow', 'music']

Development Status
- 4 - Beta
Intended Audience
- Developers
Programming Language
- Python :: 3
- Python :: 3 :: Only
Topic
- Security

Download files

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

Source Distribution

autopost-0.0.11rc1.tar.gz (6.7 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

autopost-0.0.11rc1-py3-none-any.whl (10.6 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file autopost-0.0.11rc1.tar.gz.

File metadata

Download URL: autopost-0.0.11rc1.tar.gz
Upload date: Aug 11, 2026
Size: 6.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for autopost-0.0.11rc1.tar.gz
Algorithm	Hash digest
SHA256	`21fddf2ee15171e9b4b9b8d6bd60f64f4995d01634c9c2e0f4c4b09400dd3c53`
MD5	`6318302131b342e0e43d005cd2683437`
BLAKE2b-256	`1984ce7d5f543a0fb19ed987bd726de78d23587def6e23dcd31faf35fc8bab0f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for autopost-0.0.11rc1.tar.gz:

Publisher: release.yml on woodruffw/autopost

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: autopost-0.0.11rc1.tar.gz
- Subject digest: 21fddf2ee15171e9b4b9b8d6bd60f64f4995d01634c9c2e0f4c4b09400dd3c53
- Sigstore transparency entry: 2415021697
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: woodruffw/autopost@2b834cf04ab9abd2119bfa8ab342998b6be7cb31
- Branch / Tag: refs/tags/v0.0.11rc1
- Owner: https://github.com/woodruffw
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@2b834cf04ab9abd2119bfa8ab342998b6be7cb31
- Trigger Event: push