Python tool for mirroring Reddit posts to Twitter and Mastodon
I'm no longer developing Tootbot. The current version (v2.6) will be the last release from me, and I've disabled the ability to create and comment on issues. Besides some buggy behaviour with Gfycat/Imgur links, Tootbot is still functional, but I can't guarantee it won't break in the future.
If you want to take over the project, send me an email.
No special steps are required when updating from Tootbot 2.5 to Tootbot 2.6. Just replace tootbot.py
and getmedia.py
in your Tootbot folder with the latest versions.
See the wiki for help updating an existing Heroku installation.
IMPORTANT: If you currently operate a Twitter bot, you have to apply for a Developer account or you will eventually lose API access. It's free and doesn't take much time. Full instructions are here.
This version requires an updated version of the Mastodon.py
library. Open the command line/terminal and set your directory to the Tootbot folder, then run this command:
pip3 install -r requirements.txt
If you get an error, try using pip instead of pip3.
The last step is to replace tootbot.py
and getmedia.py
in your Tootbot folder with the latest versions.
See the wiki for help updating an existing Heroku installation.
IMPORTANT: If you currently operate a Twitter bot, you have to apply for a Developer account or you will eventually lose API access. It's free and doesn't take much time. Full instructions are here.
No special steps are required when updating from Tootbot 2.1-2.3. Just replace tootbot.py
and getmedia.py
with the latest versions.
See the wiki for help updating an existing Heroku installation. Since the Heroku version of Tootbot currently only supports Twitter, and there are no major improvements for posting to Twitter in this release, there's not a major reason to upgrade existing Heroku bots at this time.
No special steps are required when updating from Tootbot 2.2. Just replace tootbot.py
and getmedia.py
with the latest versions.
See the wiki for help updating an existing Heroku installation.
No special steps are required when updating from Tootbot 2.1. Just replace tootbot.py
and getmedia.py
with the latest versions.
Hashtags
option in [BotSettings]
, where you can set multiple hashtags to be used on every postSpoilersAllowed
options in [BotSettings]
, which allows or blocks Reddit posts marked as spoilers (default is true)SensitiveMedia
option in [Mastodon]
, which marks all media attachments on Mastodon as sensitive material (default is true)If you are updating from Tootbot v2.0, there are a few minor tasks you must do, or else the updated version will fail:
SpoilersAllowed: true
to the [BotSettings]
section of the config.ini
file.Hashtags:
(you can leave the value blank) to the [BotSettings]
section of the config.ini
file.SensitiveMedia: true
to the [Mastodon]
section of the config.ini
file.PostToTwitter
setting to disable or enable Twitter postingDelayBetweenTweets
setting to DelayBetweenPosts
config.ini
that explain each settingIf you are updating from Tootbot v1.0, there are a few minor tasks you must do, or else the updated version will fail:
PostToTwitter: true
to the [Twitter]
section of the config.ini
file. If your bot does not post to Twitter, set it to false
.DelayBetweenTweets
setting in config.ini
, and rename it to DelayBetweenPosts
.Tootbot v2.0 stores API keys in separate files, instead of in the config.ini
file. When running the updated version for the first time, you will be asked for all your API keys again. This will only happen once, and you can just paste the API keys from your config.ini
file.