This is an app for crossposting between Mastodon and Twitter. The app is made so that multiple users can connect to it using the OAuth interface from both Twitter and Mastodon and choose options on how the crosspost should work.
If you just want to use it, there's one running at https://crossposter.masto.donte.com.br, which you can use from whatever Mastodon server you are in
-
Post from Twitter to Mastodon
- You can choose between posting only your tweets, or also posting retweets and quotes.
- You can choose between posting retweets and quotes as links or as the old-style RTs, starting by RT @[email protected].
- Quotes bigger than 500 characters are automatically split in two toots, one replying to the other.
- Your own threads can also be crossposted!
- No other replies will be posted. There's no risk of filling your Mastodon timeline with replies to people that are not there.
- Possibility to add a content warning to all tweets being posted to Mastodon
- Infer content warnings: if your tweet begins with a line containing "content warning" it will be posted behind a content warning on Mastodon. More information about which formats are supported can be seen below at Experimental Content Warning recognition
-
Post from Mastodon to Twitter
- Any toot bigger than 280 characters will be posted with a link to the original toot. (Be careful, if you post your private toots, your followers might not be able to see the original post!)
- Mind your privacy: you can choose which privacy levels you want to crosspost. Only posting public toots, for instance.
- You can choose between posting boosts or not.
- Your own threads can also be crossposted, respecting to the choices you made regarding your privacy.
- No other replies will be posted. There's no risk of filling your twitter timeline with replies to people that are not there.
The crossposter will never follow anyone or post anything but the content you selected to be crossposted.
If you decide to crosspost from Twitter to Mastodon, remember to turn on notifications about when people mention you to avoid not seeing interactions!
The crossposter is made with multiple users in mind. For that reason, it can be quite a lot of moving parts if you want to self-host yourself. There's other good tools to self-host out there like https://github.com/AmauryCarrade/MastodonToTwitter and the others listed at the Bridges from/to other platforms section of the Mastodon apps. That being said, it should work even if you only want it for your own usage.
Ruby 2.5.1
Rails 5.1
Without extra configuration, a local postgres instance is needed. Node 6.11 is needed for statsd, can be installed using nvm.
The poster uses the ruby-filemagic gem for detecting the types of the files posted. Follow the instructions described in the README to install the needed library and headers.
Mastodon tokens are generated by the application, but for twitter you need to request an API Token from their side. You need consumer key (on our side TWITTER_CLIENT_ID) and consumer secret (on our side TWITTER_CLIENT_SECRET)
Note: If you are running side-by-side with Mastodon or other sidekiq-using software, you need to configure redis to avoid issues with mixed jobs. More info at the end.
You need to install Yarn and Ruby 2.5.1. Yarn has installation instructions for several OSs here: https://yarnpkg.com/lang/en/docs/install/ and Ruby can be installed either using RVM (https://rvm.io/rvm/install) or rbenv (https://github.com/rbenv/rbenv#installation). After you have ruby and yarn setup, you'll need to do:
# Install bundler
gem install bundler
# Use bundler to install Ruby dependencies
bundle install --deployment --without development test
# Use yarn to install node.js dependencies
yarn install --pure-lockfile
A separate user is recommended.
By default, the crossposter will use a statsd instance to send error and stats data to Librato. If you don't want that or want to setup something else, you need to change statsd-config.js
Before starting for the first time, you need to generate the assets and setup the database:
bundle exec rake db:setup # sets up the database
bundle exec rake assets:precompile # generates the assets
If you are not going to use Statsd/Librato, you can remove the line
statsd: node node_modules/.bin/statsd statsd-config.js
from Procfile.worker
An example nginx configuration can be found at util/nginx.conf. It assumes the crossposter is running at port 3000, in the directory /home/crossposter/live and the domain crossposter.example.com needs to be replaced by your own.
An example of the configuration file is provided at .env.example. To generate SECRET_KEY_BASE, you need to run bundle exec rake secret and copy the resulting hash. You need to configure an app on Twitter with permission to read and write. The credentials that they give you need to be added to TWITTER_CLIENT_ID and TWITTER_CLIENT_SECRET. \
If you're not using Librato, you don't need to fill any of the Librato variables.
To start the web app, the worker which will fetch tweets and toots in background and the statsd instance, you need to do:
bundle exec foreman start -e .env.production"
If you are using systemd, you can create a service with something like:
[Unit]
Description=crossposter-service
After=network.target
[Service]
Type=simple
User=crossposter
WorkingDirectory=/home/crossposter/live
ExecStart=/bin/bash -lc "bundle exec foreman start -e .env.production"
TimeoutSec=15
Restart=always
[Install]
WantedBy=multi-user.target
And put it on /etc/systemd/system/crossposter.service
And a second one like this:
[Unit]
Description=crossposter-sidekiq-service
After=network.target
[Service]
Type=simple
User=crossposter
WorkingDirectory=/home/crossposter/live
Environment="RAILS_ENV=production"
Environment="RAILS_MAX_THREADS=5"
ExecStart=/bin/bash -lc "bundle exec sidekiq -c 5 -q default"
TimeoutSec=15
Restart=always
[Install]
WantedBy=multi-user.target
And put it on /etc/systemd/system/crossposter-sidekiq.service
(note that RAILS_MAX_THREADS and the number of sidekiq threads should be the same)
These example files are provided in the config/systemd-services directory. You may copy these files (with necessary modifications, if applicable) to /etc/systemd/system/ to run the system in the background.
If you are running the crossposter on a server with other sidekiq/redis applications, you need extra configuration to make sure everything is separated.
For a more in-depth information, you can check out Sidekiq Wiki, but one thing you can do it's to use another redis db, which could be done by creating a file in config/initializers/sidekiq.rb with the content like
Sidekiq.configure_server do |config|
config.redis = { url: 'redis://redis.example.com:7372/2' }
end
Sidekiq.configure_client do |config|
config.redis = { url: 'redis://redis.example.com:7372/2' }
end
You need to replace all values with actual values relevant to your server.
Run RAILS_ENV=test bundle exec rake db:setup to create the test database (a postgres running locally is needed), and after that run the tests with bundle exec rake test (or COVERAGE=1 bundle exec rake test if coverage information is desired)
To start the project locally, you can do foreman start which will start both the webserver and the daemons. Or you can take a look at the procfile to start each of them separately (if you don't want the web interface to be accessible, for instance).
When posting from Twitter to Mastodon the Crossposter tries to detect content warnings in the tweets and post them over to Mastodon. The detected CW takes precedence over the default twitter one if exists. Some formats are supported and more can be added in the future, but currently, this are the ones that will be recognized:
CW: content warning
my tweet
TW: content warning
my tweet
CW/TW: content warning
my tweet
TW, CW, content warning
my tweet
Spoiler: content warning
my tweet
CN: content warning
my tweet
All of these posts will be posted in Mastodon with the same content: my tweet and will have a content warning of content warning. The crossposter attempts to remove any extra spaces between the CW: (or equivalent) tag.
This also works for quote-retweets. That is, if you are retweeting and you want to add a content warning to the tweet, you can just quote-retweet writing CW: content warning.
This does not work for several tweets in a thread. Each tweet needs to have it's own CW.
Even though this is an experimental feature, it cannot be disabled. The reason is that content warnings are important for people in Mastodon and the crossposter should still try to keep it in a good environment, even if bringing content from Twitter.