Bot to retrieve tweets from a Twitter feed and post them under a Mastodon account.
Go to file
2019-08-01 16:16:37 +02:00
README.md changed username in README.md 2019-08-01 16:16:37 +02:00
twoot.py Resolved issue of emoji in unicode 2019-08-01 15:18:40 +02:00

I started twoot when tootbot stopped working. Tootbot relies on rss feeds from https://twitrss.me that broke when Twitter refreshed their web UI in July 2019.

Instead twoot is self contained and handles all the processing.

Features

  • Fetch timeline of given users from twitter.com
  • Scrape html and formats tweets for post on mastodon
  • Emojis supported
  • Upload images from tweet to Mastodon (videos not supported)
  • Specify maximum age of tweet to be considered
  • Specify minimum delay before considering a tweet for upload
  • Remember tweets already tooted to prevent double posting

usage

twoot.py [-h] -t <twitter account> -i <mastodon instance> -m <mastodon
                account> -p <mastodon password> [-a <max age in days>]
                [-d <min delay in mins>]

arguments

Assuming that the Twitter handle is @Megabot and the Mastodon account is @megabot@botsin.space

Switch Description Example Req
-t twitter account name without '@' SuperDuperBot Yes
-i Mastodon instance domain name botsin.space Yes
-m Mastodon username superduperbot Yes
-p Mastodon password my_Sup3r-S4f3*pw Yes
-a Max. age of tweet to post (in days) 1 No
-d Min. delay before posting new tweet (in minutes) 15 No

Default max age is 1 day. Decimal values are OK.

Default min delay is 0 minutes.

installation

Create a folder and copy twoot.py in it.

Add command line to crontab.

For example, to run every 15 minutes starting at minute 1 of every hour and process the tweets posted in the last 5 days but at least 15 minutes ago:

1-59/15 * * * * /path/to/twoot.py -t SuperDuperBot -i botsin.space -m superduperbot -p my_Sup3r-S4f3*pw -a 5 -d 15