kevinppaulo / babelgram-bot

A Telegram bot that accepts an Instagram username, and translates and synthesizes everything that is said in the user's IG Stories to your language.

babelgram-bot 🤖

Babelgram uses voice recognition and speech synthesis to translate Instagram's stories to your desired language using IBM Watson's Speech to Text, Translation and Text to Speech services.

How to run this project

1. Clone this project and install all dependencies using yarn install or npm -i
2. Create your Telegram bot using botfather.
3. Have a redis server running. See instructions for installing here
4. Have an accessible public domain to host your project. I recommend ngrok for local development and heroku for deploying.
5. You'll need an IBM Cloud account to use the speech to text, text to speech and language translator services. Don't worry, they have a free plan.
6. Grab your key and url from each of your services and put them in your .env file. An example .env is provided.
7. Speaking of .env, configure your bot token, public url, instagram username and password on your .env file.
8. Make your bot's webhook point to your domain. See setWebhook for more info.

commands

Babelgram listens for the following commands:

1. /start is sent every time a user starts a conversation with your bot. Doesn't really do anything;
2. /setvideolanguage sets the language of the video on instagram;
3. /setmylanguage sets the language that the video will be translated to;
4. /setvoice gives you a choice between male and female voices;

Notes

currently the bot expects you to set the webhook in the following format: https://your-domain.com/{yourSecretToken}/update/ where {yourSecretToken} is the WEBHOOK_SECRET configured in the .env file.