Skip to main content

A Python bot that looks up posts from specified subreddits and/or redditors and automatically posts them on Mastodon

Project description

Repo at Codeberg CI - Woodpecker Downloads

Checked against Safety DB Checked with pip-audit CodeLimit

Code Style: Black PyPI - Python Version PyPI - Wheel

GPL3

This is a Python bot that looks up posts from specified subreddits and automatically posts them on Mastodon. It is based on reddit-twitter-bot.

Features:

  • Tootbot posts to Mastodon

  • Media from direct links, Gfycat, Imgur, Reddit, and Giphy is automatically attached in the social media post. Tootbot attaches up to the first 4 pictures for imgur albums and reddit gallery posts.

  • Links that do not contain media can be skipped, ideal for meme accounts like @babyelephantgifs

  • NSFW content, spoilers, and self-posts can be filtered

  • Tootbot can monitor multiple subreddits at once

  • Tootbot is fully open-source, so you don’t have to give an external service full access to your social media accounts

  • Tootbot also checks the sha256 checksum of media files to stop posting of the same media file from different subreddits.

  • Tootbot can ping a Healthchecks instance for monitoring continuous operation of Tootbot

  • Optionally throttle down frequency of tooting when mastodon errors are detected.

!!! Tootbot no longer supports posting to Twitter. !!!

If you need twitter functionality look into reddit-twitter-bot as a possible alternative.

!!! Tootbot no longer supports deleting old toots. !!!

If you’d like to delete older toots from your Mastodon account look into Fedinesia as a tool that might work for you.

Disclaimer

The developers of Tootbot hold no liability for what you do with this script or what happens to you by using this script. Abusing this script can get you banned from Mastodon, so make sure to read up on proper usage of the API for each site.

Setup and usage

For instructions on setting up and using Tootbot, please look at the documentation

Supporting Tootbot

There are a number of ways you can support Tootbot:

  • Create an issue with problems or ideas you have with/for Tootboot

  • You can buy me a coffee.

  • You can send me small change in Monero to the address below:

Monero donation address: 87C65WhSDMhg4GfCBoiy861XTB6DL2MwHT3SWudhjR3LMeGEJG8zeZZ9y4Exrtx5ihavXyfSEschtH4JqHFQS2k1Hmn2Lkt

Changelog

See the Changelog for any changes introduced with each version.

License

Tootbot is licences under the GNU General Public License v3.0

Project details


Download files

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

Source Distribution

tootbot-8.2.0.tar.gz (28.3 kB view details)

Uploaded Source

Built Distribution

tootbot-8.2.0-py3-none-any.whl (29.3 kB view details)

Uploaded Python 3

File details

Details for the file tootbot-8.2.0.tar.gz.

File metadata

  • Download URL: tootbot-8.2.0.tar.gz
  • Upload date:
  • Size: 28.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.11.1 CPython/3.11.7

File hashes

Hashes for tootbot-8.2.0.tar.gz
Algorithm Hash digest
SHA256 e61b6b12424b114153466cbabac52540ba35261eef9532fe58500c03617f2fea
MD5 0eedc2b9b57d06241c44ec7ac50ff34e
BLAKE2b-256 08df2d23c6fef13abb843cfdfe23fd15c68124b28fe3d99312d33de75f536c8c

See more details on using hashes here.

File details

Details for the file tootbot-8.2.0-py3-none-any.whl.

File metadata

  • Download URL: tootbot-8.2.0-py3-none-any.whl
  • Upload date:
  • Size: 29.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.11.1 CPython/3.11.7

File hashes

Hashes for tootbot-8.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4f0239a4b9c062f8256d51d6f4308eaab310809664254077dcf234d358ddf328
MD5 629b2aefae91369935e0ddce301f9fec
BLAKE2b-256 090289eaf534622e8549aeb2392235e3f749ca66be09d56fce7bf3efa8ee69a1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page