Skip to content
Mirrors a Twitter home timeline to one Mastodon account
Branch: master
Clone or download
Latest commit f7b63ed May 16, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Inital commit Mar 5, 2019 Update May 14, 2019
config.toml Switched to Go, now all media types work as well May 14, 2019
go.mod Small updates May 15, 2019
go.sum Small updates May 15, 2019
mirror.png Update May 14, 2019
twtlmirror.go Small updates May 15, 2019


This script takes all tweets from a user’s home timeline on Twitter and posts them to one Mastodon account. It makes use of the CW tag to display from which user the tweet originally came from. Media entities like photos, gifs and videos are mirrored as well.

Example use case: A few people I care about still use Twitter but I don’t want to check Twitter separately, so I’ve created a private and locked bot account on my own Mastodon instance to which this script mirrors my Twitter home timeline. This way I can keep up with their Tweets without them even having a Mastodon account or using a mirror script themselves. Of course it is not possibly to interact with them as actions taken on Mastodon are not replicated on Twitter.

Previously this tool was written in Python3, you can still find it in the history.

Example of a twtlmirror bot profile


From source

go get -u


  • Edit config.toml (Twitter and Mastodon API credentials)


./twtlmirror -config config.toml


  • This script works best when used in combination with systemd timers or cron.
  • The script creates a file (since_id) in the current working directory to save the last processed id. Make sure it is able to do so, or you it will process the same tweets over and over again.



You can’t perform that action at this time.