A Python-based Whisper AI transcriber bot for Telegram.

This is a Whisper AI-based transcriber Telegram Bot running on Python, designed to transcribe audio from various media sources supported by yt-dlp. While initially focused on YouTube, the bot now supports a broad range of sites listed here, leveraging a locally run OpenAI's Whisper model to process audio and return the transcription in multiple formats.

• Processes media URLs from a variety of sources supported by yt-dlp.
• Downloads audio using yt-dlp from supported sites including but not limited to YouTube.
• Uses a local model from the openai-whisper package for transcription.
• Transcribes audio using OpenAI's Whisper model
  • (see openai/whisper for more info)
• Returns transcription in text, SRT, and VTT formats.
• Handles concurrent transcription requests efficiently.

To set up the Whisper Transcriber Telegram Bot, follow these steps:

1. Clone the repository:

   git clone https://github.com/FlyingFathead/whisper-transcriber-telegram-bot.git
   cd whisper-transcriber-telegram-bot

2. Install the required Python packages:

   pip install -r requirements.txt

3. Set up your Telegram bot token either in config/bot_token.txt or as an environment variable TELEGRAM_BOT_TOKEN.

4. Run the bot:

   python src/main.py

After launching the bot, you can interact with it via Telegram:

1. Send a YouTube video URL to the bot.
2. The bot will acknowledge the request and begin processing.
3. Once processing is complete, the bot will send the transcription files to you.

• v0.10 - /help & /about commands added for further assistance
  • config.ini now has a list of supported models that can be changed as needed
• v0.09 - users can now change the model Whisper model with /model command
• v0.08 - auto-retry TG connection on start-up connection failure
  • can be set in config.ini with RestartOnConnectionFailure
• v0.07.7 - log output from whisper to logging
• v0.07.6 - update interval for logging yt-dlp downloads now configurable from config.ini
• v0.07.5 - 10-second interval update for yt-dlp logging
• v0.07.4 - fixes for non-youtube urls
• v0.07.2 - job queues fine-tuned to be more informative
• v0.07.1 - job queues introduced
• v0.07 - transcript queuing, more precise transcript time estimates
• v0.06 - better handling of details for all video sources, transcription time estimates
• v0.05 - universal video description parsing (platform-agnostic)
• v0.04.1 - version number printouts and added utils
• v0.04 - expanded support for various media sources via yt-dlp, supported sites listed here
• v0.03 - better logging to console, Whisper model + keep audio y/n can now be set in config.ini
• v0.02 - add video information to the transcript text file
  • (see: config.ini => IncludeHeaderInTranscription = True)
• v0.01 - initial commit

Contributions are welcome! If you have suggestions for improvements or bug fixes, please open an issue or submit a pull request.

• FlyingFathead - Project creator
• ChaosWhisperer - Contributions to the Whisper integration and documentation