Importing tweets for a Mastodon instance 🐦➡️🐘

Thats a simples script to import yours tweets from any Twitter account to a Mastodon account, in any instance.

Steps

For this tutorial, you'll need to install Node.js and Git.

• Node.js: Download | Node.js (nodejs.org)
• Git: Git - Downloads (git-scm.com)

#1 - Request your Twitter data in link below;

Go here for request your Twitter data. You'll recive a link to download a zip file. There will be tweets, images, information etc. It'll be in this configuration:

• twitter
  • assets (folder)
  • data (folder)
  • Your archive (html file)

#2 - Extract archive and look for tweets.js

Extract the file in your Desktop folder. Will be more easy for manipulate. Find the tweets.js file. It'll be, probably inside "data" folder and move it to Desktop.

#3 - Clone this repo

Clone this repo in your Desktop folder with the command:

git clone https://github.com/FGRibreau/import-tweets-to-mastodon.git

Or download the zip and extract in Desktop.

#4 - Set an API key from Mastodon

To request an API key from Mastodon, click here. Create an new application in "New Application". Set an Application Name (e. g.: api-mastodon-twitter) and, at the end of page, click in "Submit".

#5 - Set the environment variables

Windows

1. Copy your "Your access token" from developer's page in Mastodon;
2. Press "WIN + R" and write "cmd". Click ENTER;
3. Go to your Desktop folder;
4. Write

set MASTODON_API_BASEPATH=https://[YOUR-MASTODON-INSTANCE-DOMAIN] 

set MASTODON_API_KEY=YOUR_ACCESS_TOKEN_FROM_MASTODON

set TWITTER_TWEETJS_FILEPATH=tweets.js

Linux and MacOS

1. Same thing as Windows;
2. Open Terminal;
3. Got to your Desktop folder;
4. Write

export MASTODON_API_BASEPATH=https://[YOUR-MASTODON-INSTANCE-DOMAIN] 

export MASTODON_API_KEY=YOUR_ACCESS_TOKEN_FROM_MASTODON

export TWITTER_TWEETJS_FILEPATH=../tweets.js

#6 - Setting the script

In the terminal (or CMD), enter in "import-tweets-mastodon" folder, located in Desktop. Write

npm install

After this

node import.js

Need help?

• This project is open-sourced. Feel free to contribute;
• If you really want support please consider sponsoring me 👍