vensder / language-tutor-bot

Language Tutor Telegram-Bot can help you to enrich your vocabulary and to learn phrases and pronunciation for any language.

Telegram Language Tutor Bot

This is a simple Language Tutor Bot which can help you to enrich your vocabulary and can help to learn phrases and pronunciation.

Actually you can learn any language and can have any native language - the bot is multilingual.

It is pretty easy to use it: just send the word or sentence to the Telegram channel, where is your bot added. And bot will translate it and will add the audio file to the telegram channel.

The audio file has the structure:

<the phrase in studying language>, <the phrase in your native language>, <the slow phrase in studying language>

If you send one word only and if the translation module returns the definitions and/or examples of the word, this text will be added to the audio file as well.

Run The Bot

Clone the repo:

git clone https://github.com/vensder/language-tutor-bot.git

Add the Python 3 virtual environment and install the modules:

cd language-tutor-bot
virtualenv -p python3 env
source ./env/bin/activate
pip install -r requirements.txt

To run the bot just rename example.config.py file to config.py and replace the fake Telegram Bot API token with the real one.

mv example.config.py config.py
./main.py

How to create the bot and how to obtain the token, check out here: https://core.telegram.org/bots/api

Also put the language codes into the config, corresponding to your native language and learning language. You can check them out here: https://cloud.google.com/translate/docs/languages

The benefit of having the audio files in the telegram group is that you can listen to all audio on your mobile device even if you are walking. The telegram media player will play all of them in the group.

Once you remember them, you can delete them and add new ones.

language-tutor-bot's Issues

Add the transcription if the word is one only.

Add the transcription to the captions with translation into the learning language.

Replace the tag Unknown artist

Replace the tag Unknown artist with the bot name.

Use mp3 tags with https://github.com/artcom-net/mp3-tagger

Add logging

Add the audio to the audio file with definitions and examples

Add the audio to the audio file with definitions and examples, if the passed one word only.

Send audio and text separately in different messages

Send audio and text separately in different messages, since the audio sometimes generating too long. Add the short translation and transcription to audio caption only.

Remove the language autodetection

Replace it with the learning language.

If the word is one only, add defenition and examples

I get error when run main.py

When rung ./main.py I get error. Could you help me!
Traceback (most recent call last):
File "./main.py", line 137, in
updater = Updater(telegram_token, use_context=True)
File "/home/ubuntu/language-tutor-bot/env/lib/python3.8/site-packages/telegram/ext/updater.py", line 237, in init
raise ValueError('token or bot must be passed')
ValueError: token or bot must be passed

split the multiline words and proceed them as the separated words.

If there are a few words passed with new lines, split them and proceed them as the separated words.