https://github.com/buckket/twtlmirror

Mirrors a Twitter home timeline to one Mastodon account
https://github.com/buckket/twtlmirror

fediverse golang mastodon mirror twitter

Last synced: 27 days ago
JSON representation

Mirrors a Twitter home timeline to one Mastodon account

• Host: GitHub
• URL: https://github.com/buckket/twtlmirror
• Owner: buckket
• License: gpl-3.0
• Created: 2019-03-05T12:11:53.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-10-11T23:08:05.000Z (about 1 year ago)
• Last Synced: 2024-04-13T13:50:07.891Z (7 months ago)
• Topics: fediverse, golang, mastodon, mirror, twitter
• Language: Go
• Size: 183 KB
• Stars: 7
• Watchers: 3
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# twtlmirror

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.

Rudimentary support to mirror favs and mentions back to Twitter is now implemented.

Previously this tool was written in Python3, you can still find it in the [history](https://github.com/buckket/twtlmirror/tree/d7a8d3dc5d398d3f8042051251619cb2a996c349).

![Example of a twtlmirror bot profile](mirror.png)

## Installation

### From source

```sh

go get -u github.com/buckket/twtlmirror

```

## Configuration

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

## Usage

```sh

./twtlmirror -config config.toml

```

## Notes

- This script works best when used in combination with systemd timers or cron.

- The script creates a SQLite database (twtlmirror.db) in the current working directory to save the last processed id.

  Make sure it is able to do so, or it will process the same tweets over and over again.

## License

GNU GPLv3+