mirror of
https://gitlab.com/jeancf/twoot.git
synced 2024-11-30 15:31:11 +00:00
58 lines
2.3 KiB
Markdown
58 lines
2.3 KiB
Markdown
I started twoot when [tootbot](https://github.com/cquest/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 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
|
|
``` |