Skip to content
This repository has been archived by the owner on Oct 22, 2020. It is now read-only.
/ tootbot Public archive

Python tool for mirroring Reddit posts to Twitter and Mastodon

License

Notifications You must be signed in to change notification settings

corbindavenport/tootbot

Repository files navigation

Tootbot

I am no longer actively developing Tootbot, and no bug fixes or new features will be implemented. There a fork developed by Mark Burgunder here, with fixes to Gfycat integration and and other changes.

This is a Python bot that looks up posts from specified subreddits and automatically posts them on Twitter and/or Mastodon. It is based on reddit-twitter-bot. Tootbot is now used by a wide variety of social media accounts.

Deploy

Features:

  • Can post to both Twitter and Mastodon
  • Runs in the cloud with a free Heroku account, or locally on any PC with Python
  • Media from direct links, Gfycat, Imgur, Reddit, and Giphy is automatically attached in the social media post
  • Links that do not contain media can be skipped, ideal for meme accounts
  • NSFW content, spoilers, and self-posts can be filtered
  • Multiple subreddits can be monitored at once

Tootbot uses the tweepy, PRAW, py-gfycat, imgurpython, Pillow, and Mastodon.py libraries. The Heroku version also uses the redis-py library.

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 Twitter and/or 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 visit the wiki.