joejoe note 07/07/2019 on this fork NOTE 1: I don't know what I'm doing. I just made some changes to this project for myself, and I'm putting this up here. I also don't care to use Github, I'm busy. So if somehow this offends anyone tell me and I will delete the entire thing. Thank you to the guy whom made this originally; my intentions are to just "make some new code to add" and I don't care to take a master class in github right now.

joejoe usage note 07/07/2019 NOTE 2: To use this: Essentially follow the the original guy's notes BUT ... we are starting "my version" with the executution of toot.py NOT "run.py." So python3 toot.py when you want to run it on your server. ALSO we are using config.json for limited stuff, NOT the mastodon code and secret code... THAT all is in the newly created (for for this project), "list.txt." Self-explanatory but 0 at the start means to skip it, 1 means to post. ALSO the logging stinks, and it needs many changes, but it will get you started. ALSO if you want to follow-along some instructions (that I used originally tied to this project) go here as you work on this (remembering the rest of this note for differences): https://notes.ayushsharma.in/2018/09/tweet-toot-building-a-bot-for-mastodon-using-python

joejoe usage note 07/07/2019 NOTE 3: You'll need to make this directory "../temp_ids_alreadyposted_keep" from whereever you run the script.

joejoe usage note 07/07/2019 NOTE 4:

WHAT I ADDED: 1.) It will now loop through a list (list.txt) and toot those accounts, instead of just a one-off. 2.) A bunch of improvements in handling retweets, skipping post on Twitter if it's "pinned," etc. 3.) Will tweet only the "latest tweet" of the Twitter user. It actually tweets the latest two, which after checking to see if it already tweeted, should tweet only the latest one after the first tweet. It does this in case the first tweet is a "pin" so it doesn't keep retweeting that pinned tweat since we're only looking for the latest tweet. It would skip it since it already would have tweeted but still, it wouldn't go to the next otherwise. 4.) Who knows what else. Many changes and tweaks, all sloppy but all work which is what I was doing here. Making a proof of concept and something off which one can build.

Tweet-Toot is a small Python3 project to convert a tweet to a toot. It's basically a Twitter relay for Mastodon.

The way it works is this: add Tweet-Toot as a cron job, and it will repost new tweets to any Mastodon account you configure. Just clone this repo, configure the script, add it to a cron job, and it will get cracking.

Getting Tweet-Toot working is pretty easy. Before you can install it, you're going to need to do the following:

• Pick a Mastodon instance of your choice. You'll need this instance's URL.
• Create an app on this Mastodon instance and generate an access token.
• Get the Twitter URL of the account you want to watch.

Once you have the above, just follow these steps:

1. Clone this repository.
2. Install the Python3 libraries requests and beautifulsoup mentioned in the requirements.txt file.
3. In config.json, update the following:

• tweets.source_account_url: The source Twitter account.
• toots.host_instance: The HTTPS URL of your instance.
• toots.app_secure_token: The Mastodon app access token.

For example:

• tweets.source_account_url = https://twitter.com/SarcasmMother
• toots.host_instance = https://botsin.space
• toots.app_secure_token = XXXXX-XXXXX-XXXXX-XXXXX-XXXXX'

Once it's all setup, just run the main file like this:

python3 run.py

If all goes well, you'll see something like this:

Tweet-Toot | 2018-09-06 22:59:10 _info > getTweets() => Fetched tweets for https://twitter.com/SarcasmMother.
Tweet-Toot | 2018-09-06 22:59:10 _info > __main__ => 20 tweets fetched.
Tweet-Toot | 2018-09-06 22:59:10 _info > tootTheTweet() => Tweet 1031642593594028032 was already posted. Skipping...
Tweet-Toot | 2018-09-06 22:59:10 _info > tootTheTweet() => Tweet 1031640753187958786 was already posted. Skipping...
Tweet-Toot | 2018-09-06 22:59:10 _info > tootTheTweet() => Tweet 1031632691500789761 was already posted. Skipping...
Tweet-Toot | 2018-09-06 22:59:10 _info > tootTheTweet() => New tweet 1031572182114004993 => "You discovered the ability to time travel. You go 30 years into the future expecting to meet your future self only to discover that you've been missing for 30 years.".
Tweet-Toot | 2018-09-06 22:59:11 _info > tootTheTweet() => OK. Posted tweet 1031572182114004993to Mastodon.
Tweet-Toot | 2018-09-06 22:59:11 _info > tootTheTweet() => Response: {"id":"100680004506399841","created_at":"2018-09-06T17:29:11.674Z","in_reply_to_id":null,"in_reply_to_account_id":null,"sensitive":false,"spoiler_text":"","visibility":"public","language":"en","uri":"https://botsin.space/users/motherofsarcasm/statuses/100680004506399841","content":"\u003cp\u003eYou discovered the ability to time travel. You go 30 years into the future expecting to meet your future self only to discover that you\u0026apos;ve been missing for 30 years.\u003c/p\u003e","url":"https://botsin.space/@motherofsarcasm/100680004506399841","replies_count":0,"reblogs_count":0,"favourites_count":0,"favourited":false,"reblogged":false,"muted":false,"pinned":false,"reblog":null,"application":{"name":"TweetToot","website":""},"account":{"id":"-----","username":"motherofsarcasm","acct":"motherofsarcasm","display_name":"Mother Of Sarcasm","locked":false,"bot":true,"created_at":"2018-08-20T15:07:42.747Z","note":"\u003cp\u003eFOLLOWS YOU\u003c/p\u003e","url":"https://botsin.space/@motherofsarcasm","avatar":"https://files.botsin.space/accounts/avatars/000/058/348/original/658f78e1f07e94fa.jpg","avatar_static":"https://files.botsin.space/accounts/avatars/000/058/348/original/658f78e1f07e94fa.jpg","header":"https://botsin.space/headers/original/missing.png","header_static":"https://botsin.space/headers/original/missing.png","followers_count":0,"following_count":1,"statuses_count":7,"emojis":[],"fields":[{"name":"Name","value":"Mother Of Sarcasm"},{"name":"Owner","value":"[email protected]"},{"name":"Twitter Relay","value":"\u003ca href=\"https://twitter.com/SarcasmMother\" rel=\"me nofollow noopener\" target=\"_blank\"\u003e\u003cspan class=\"invisible\"\u003ehttps://\u003c/span\u003e\u003cspan class=\"\"\u003etwitter.com/SarcasmMother\u003c/span\u003e\u003cspan class=\"invisible\"\u003e\u003c/span\u003e\u003c/a\u003e"}]},"media_attachments":[],"mentions":[],"tags":[],"emojis":[]}
Tweet-Toot | 2018-09-06 22:59:11 _info > __main__ => Tooted "You discovered the ability to time travel. You go 30 years into the future expecting to meet your future self only to discover that you've been missing for 30 years."
Tweet-Toot | 2018-09-06 22:59:11 _info > __main__ => Tooting less is tooting more. Sleeping...

The tutorial for this code can be found here: Tweet-Toot: Building a bot for Mastodon using Python.

I've added a Dockerfile with this repo so you can get up and running quickly.

1. Update the config.json with the Twitter account you want to relay.
2. Leave the toots.app_secure_token blank.
3. Build your container with the command below:

docker build --build-arg mastodon_token=<Mastodon_Token> --build-arg papertrail_token=<Papertrail_Token> -t <DockerHub_Repo>:<Repo_Tag> .

The container has support for sending logs to Papertrail. Just add your authentication token. You can get it from your Papertrail client installation command.

• The script is designed to toot once per invokation. I recommend timing your cron jobs according to the post frequency that you need instead of modifying the code.
• Mastodon instance admins are people too. Don't toot-blast your instance and make life harder for them.
• When configuring your bot, ensure you clearly display an account where you can be reached in case of issues.

Have fun :)