mathdatech/twoot
1
0
Fork 0
mirror of https://gitlab.com/jeancf/twoot.git synced 2024-11-23 20:11:11 +00:00
Code Issues 1 Packages Projects Releases Wiki Activity
Bot to retrieve tweets from a Twitter feed and post them under a Mastodon account.
61 Commits 5 Branches 22 Tags 3.7 MiB
Python 100%
909183eb0a
Go to file
jeancf 909183eb0a Added comments and TODOs
2020-03-26 15:04:36 +01:00
.gitignore Added .gitignore 2020-03-22 11:58:15 +01:00
LICENSE Update LICENSE 2019-08-01 18:30:34 +00:00
README.md Corrected typo in README.md 2020-03-17 15:53:52 +01:00
twitterdl.py Adding twitter-video-downloader module 2020-03-25 17:40:07 +01:00
twoot.py Added comments and TODOs 2020-03-26 15:04:36 +01:00

README.md

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.

UPDATE 17 MAR 2020 Added command line switch (-r) to also post reply-to tweets on the mastodon account. They will not be included by default anymore.

UPDATE 06 MAR 2020 Added functionality to automatically get images from tweets considered as "sensitive content"

UPDATE 15 FEB 2020 Twoot has been rewritten to make use of the mobile twitter page without JavaScript after the breaking change of last week.

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
  • Can optionally post reply-to tweets on the mastodon account

usage

twoot.py [-h] -t <twitter account> -i <mastodon instance> -m <mastodon
                account> -p <mastodon password> [-r]
                [-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
-r Post reply-to tweets (ignored by default) N/A No
-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 beautifulsoup4 and mastodon python module: sudo pip install beautifulsoup4 Mastodon.py

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