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 @SuperDuperBot and the Mastodon account is @superduperbot@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

Make sure python3 is installed.

Twoot depends on sqlite3, beautifulsoup4 and mastodon python module: sudo pip install sqlite3 beautifulsoup4 mastodon

In your user folder, execute git clone https://gitlab.com/jeancf/twoot.git to clone repo with twoot.py script.

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