audiotext

About the Project

Audiotext transcribes the audio from an audio file, video file, microphone input, directory, or YouTube video into any of the 99 different languages it supports. You can transcribe using the Google Speech-to-Text API, the Whisper API, or WhisperX. The last two methods can even translate the transcription or generate subtitles!

You can also choose the theme you like best. It can be dark, light, or the one configured in the system.

Supported Languages

• Afrikaans
• Albanian
• Amharic
• Arabic
• Armenian
• Assamese
• Azerbaijan
• Bashkir
• Basque
• Belarusian
• Bengali
• Bosnian
• Breton
• Bulgarian
• Burmese
• Catalan
• Chinese
• Chinese (Yue)
• Croatian
• Czech
• Danish
• Dutch
• English
• Estonian
• Faroese
• Farsi
• Finnish
• French
• Galician
• Georgian
• German
• Greek
• Gujarati
• Haitian
• Hausa
• Hawaiian
• Hebrew
• Hindi
• Hungarian
• Icelandic
• Indonesian
• Italian
• Japanese
• Javanese
• Kannada
• Kazakh
• Khmer
• Korean
• Lao
• Latin
• Latvian
• Lingala
• Lithuanian
• Luxembourgish
• Macedonian
• Malagasy
• Malay
• Malayalam
• Maltese
• Maori
• Marathi
• Mongolian
• Nepali
• Norwegian
• Norwegian Nynorsk
• Occitan
• Pashto
• Polish
• Português
• Punjabi
• Romanian
• Russian
• Sanskrit
• Serbian
• Shona
• Sindhi
• Sinhala
• Slovak
• Slovenian
• Somali
• Spanish
• Sundanese
• Swahili
• Swedish
• Tagalog
• Tajik
• Tamil
• Tatar
• Telugu
• Thai
• Tibetan
• Turkish
• Turkmen
• Ukrainian
• Urdu
• Uzbek
• Vietnamese
• Welsh
• Yiddish
• Yoruba

Supported File Types

• .aac
• .flac
• .mp3
• .mpeg
• .oga
• .ogg
• .opus
• .wav
• .wma

• .3g2
• .3gp2
• .3gp
• .3gpp2
• .3gpp
• .asf
• .avi
• .f4a
• .f4b
• .f4v
• .flv
• .m4a
• .m4b
• .m4r
• .m4v
• .mkv
• .mov
• .mp4
• .ogv
• .ogx
• .webm
• .wmv

Project Structure

│   .gitignore
│   audiotext.spec
│   LICENSE
│   README.md
│   requirements.txt
│
├───.github
│   │   CONTRIBUTING.md
│   │   FUNDING.yml
│   │
│   ├───ISSUE_TEMPLATE
│   │       bug_report_template.md
│   │       feature_request_template.md
│   │
│   └───PULL_REQUEST_TEMPLATE
│           pull_request_template.md
│
├───docs/
│
├───res
│   ├───img
│   │       icon.ico
│   │
│   └───locales
│       │   main_controller.pot
│       │   main_window.pot
│       │
│       ├───en
│       │   └───LC_MESSAGES
│       │           app.mo
│       │           app.po
│       │           main_controller.po
│       │           main_window.po
│       │
│       └───es
│           └───LC_MESSAGES
│                   app.mo
│                   app.po
│                   main_controller.po
│                   main_window.po
│
└───src
    │   app.py
    │
    ├───controllers
    │       __init__.py
    │       main_controller.py
    │
    ├───handlers
    │       file_handler.py
    │       google_api_handler.py
    │       openai_api_handler.py
    │       whisperx_handler.py
    │       youtube_handler.py
    │
    ├───interfaces
    │       transcribable.py
    │
    ├───models
    │   │   __init__.py
    │   │   transcription.py
    │   │
    │   └───config
    │           __init__.py
    │           config_subtitles.py
    │           config_system.py
    │           config_transcription.py
    │           config_whisper_api.py
    │           config_whisperx.py
    │
    ├───utils
    │       __init__.py
    │       audio_utils.py
    │       config_manager.py
    │       constants.py
    │       dict_utils.py
    │       enums.py
    │       env_keys.py
    │       path_helper.py
    │
    └───views
        │   __init__.py
        │   main_window.py
        │
        └───custom_widgets
                __init__.py
                ctk_scrollable_dropdown/
                ctk_input_dialog.py

Built With

• CTkScrollableDropdown for the scrollable option menu to display the full list of supported languages.
• CustomTkinter for the GUI.
• moviepy for video processing, from which the program extracts the audio to be transcribed.
• OpenAI Python API library for using the Whisper API.
• PyAudio for recording microphone audio.
• pydub for audio processing.
• python-dotenv for handling environment variables.
• PyTorch for building and training neural networks.
• PyTorch-CUDA for enabling GPU support (CUDA) with PyTorch. CUDA is a parallel computing platform and application programming interface model created by NVIDIA.
• pytube for audio download of YouTube videos.
• SpeechRecognition for using the Google Speech-To-Text API.
• Torchaudio for audio processing tasks, including speech recognition and audio classification.
• WhisperX for fast automatic speech recognition. This product includes software developed by Max Bain. Uses faster-whisper, which is a reimplementation of OpenAI's Whisper model using CTranslate2.

Getting Started

Installation

1. Install FFmpeg to execute the program. Otherwise, it won't be able to process the audio files.

   To check if you have it installed on your system, run ffmpeg -version. It should return something similar to this:

   ffmpeg version 5.1.2-essentials_build-www.gyan.dev Copyright (c) 2000-2022 the FFmpeg developers
   built with gcc 12.1.0 (Rev2, Built by MSYS2 project)
   configuration: --enable-gpl --enable-version3 --enable-static --disable-w32threads --disable-autodetect --enable-fontconfig -