Transcription-Short / Reel / Tiktok (by FEU)

A Python application that downloads videos from TikTok, Instagram, and YouTube Shorts and transcribes them to text with French translation.

Features

• Download videos from TikTok, Instagram, and YouTube Shorts
• Offline transcription using Vosk
• Automatic translation from English to French
• Batch processing of multiple URLs
• Progress tracking for each operation with detailed status
• Simple and intuitive GUI

Requirements

• Python 3.7 or higher
• FFmpeg installed on your system (for audio extraction)
• Vosk speech recognition model

Installation

1. Clone or download this repository
2. Install the required Python packages:

pip install -r requirements.txt

3. Download a Vosk model from https://alphacephei.com/vosk/models

   • Recommended: vosk-model-en-us-0.22-lgraph for English
   • Extract the model and place it in the application directory
   • The model should be in a folder named vosk-model-en-us-0.22-lgraph

4. Install FFmpeg:

   • Windows: Download from https://ffmpeg.org/download.html and add to PATH
   • macOS: brew install ffmpeg
   • Linux: sudo apt install ffmpeg or equivalent for your distribution

Usage

1. Run the application:

python main.py

2. Enter TikTok, Instagram, or YouTube Shorts URLs in the text area (one URL per line)
3. Click "Download Videos" to download the videos
4. Once the videos are downloaded, click "Transcribe Videos" to transcribe them to text and translate to French
5. The transcriptions and translations will be saved in the transcriptions folder as text files

Supported URL Formats

• TikTok: https://www.tiktok.com/@username/video/1234567890123456789
• TikTok (with parameters): https://www.tiktok.com/@username/video/1234567890123456789?is_from_webapp=1&sender_device=pc
• TikTok (shortened): https://vm.tiktok.com/XXXXXXXX/
• Instagram: https://www.instagram.com/p/XXXXXXXXXX/
• Instagram Reels: https://www.instagram.com/reel/XXXXXXXXXX/ or https://www.instagram.com/reels/XXXXXXXXXX/
• Instagram Reels (with username): https://www.instagram.com/username/reel/XXXXXXXXXX/
• YouTube Shorts: https://www.youtube.com/shorts/XXXXXXXXXXX

Folders

• videos: Downloaded videos are stored here
• transcriptions: Transcribed text files are stored here

Troubleshooting

Video Download Issues

• Make sure the URL is valid and the video is publicly accessible
• Some videos may be region-locked or require authentication
• TikTok, Instagram, or YouTube may change their website structure, requiring updates to the downloader

Transcription Issues

• Make sure FFmpeg is installed and accessible in your PATH
• Ensure you have downloaded and extracted the Vosk model correctly
• The quality of transcription depends on the audio quality of the video
• For non-English videos, download an appropriate language model from the Vosk website

License

This project is licensed under the MIT License - see the LICENSE file for details.