telegram-2-mastodon-receiver

This is the CLI tool that transports the history of the telegram channel to the mastodon account.

Dependencies

Java 19th or higher must be installed on your machine.

Usage

[1] Run the following command in the terminal to get the .jar file:

wget https://github.com/stanislaw-am-i/telegram-2-mastodon-receiver/releases/download/0.0.3/telegram-2-mastodon-receiver.jar

[2] Export your data from Telegram. How to do it you can check here: https://telegram.org/blog/export-and-more

[3] Set up the configuration file called config in your favorite text editor:

ACCESS_TOKEN=<Your access token>
BASE_URL=https://yourinstance.social
CHARACTER_LIMITATION=500
INTERVAL=60
PATH_TO_EXPORTED_DATA=Exported_Data_Dir/

Configuration file's content

• ACCESS_TOKEN is needed to authenticate a request to your Mastodon instance. Follow these steps to get your token:

  • Open a new browser tab and login in to your account at your Mastodon instance.
  • Click the gear icon (Preferences) icon to access your Mastodon preferences.
  • Click Development in the left menu.
  • Click the New Application button.
  • Enter an Application Name of your choice.
  • Uncheck all the Scopes check boxes, and then check only the following check boxes: write: statuses, write: media.
  • Click the Submit button.
  • Click the hyperlinked name of your application.
  • Copy your access token.

• BASE_URL This is your Mastodon instance. E.g.: https://mastodon.social

• CHARACTER_LIMITATION The default character limit is 500 characters on most instances.

• INTERVAL The value in seconds that sets the pause between each request. Zero is also valid. Many servers have sensitive settings for API requests by default. See more: https://docs.joinmastodon.org/api/rate-limits/

• PATH_TO_EXPORTED_DATA Path to directory with your exported Telegram data.

[4] Put the config file in the same directory as the .jar file.

[5] Then run this in terminal:

java -jar telegram-2-mastodon-receiver.jar