AudioTTo

Audio Transcription, Slide Integration & LaTeX Notes Generation

Transform your audio recordings into structured, professional LaTeX notes instantly.

---

📖 Overview

AudioTTo is a powerful Python application designed to streamline the process of creating study notes. It takes audio recordings (lectures, meetings, etc.) and optionally PDF slides, then uses advanced AI to generate comprehensive LaTeX documents.

✨ Key Features

• 🎙️ Local Transcription: Uses Faster-Whisper for fast, accurate, and private audio transcription.
• ✂️ Efficient Processing: Automatically chunks audio for parallel processing, maximizing CPU usage.
• 🧠 AI-Powered Notes: Leverages Google Gemini AI to synthesize transcripts into structured LaTeX notes.
• 🖼️ Visual Integration: Extracts images from PDF slides and embeds them directly into the notes where relevant.
• 🚀 Modern UI: Includes a user-friendly web interface for easy drag-and-drop operation.

---

📸 App Screenshots

 

---

🛠️ Prerequisites

Before you begin, ensure you have the following:

• Python 3.9 or higher.
• A LaTeX Distribution installed and added to your PATH (required for PDF compilation):
  • Windows: MiKTeX or TeX Live
  • macOS: MacTeX
  • Linux: texlive-full
• A Google Gemini API Key. You can get one from Google AI Studio.

---

📦 Installation (Executable)

If you downloaded the standalone executable (.exe):

1. Download the latest version from the Releases page.
2. Prerequisites: You still need a working LaTeX distribution installed (see Prerequisites above).
3. Run: Just double-click AudioTTo.exe. No Python installation required!

---

⚙️ Installation (Source Code)

1. Clone the repository (or download usage files):

   git clone https://github.com/Manumarzo/AudioTTo.git
   cd AudioTTo

2. Install dependencies:

   pip install -r requirements.txt

---

🚀 How to Use

AudioTTo provides both a modern Web GUI and a classic CLI.

🖥️ Option 1: Web Interface (Recommended)

The easiest way to use AudioTTo.

1. Launch the application:

   python gui_app.py

2. Interact: A window will open automatically (or go to http://localhost:8000).
3. Configure: Click the Settings (⚙️) button to enter your Gemini API Key.
4. Process:
   • Drag & drop your Audio file.
   • (Optional) Drag & drop your Slides (PDF).
   • Click Start Processing.

💻 Option 2: Command Line Interface (CLI)

For automation or headless environments.

Set your API Key first: Create a file named .env in the root directory of the project. Open it with a text editor and add your API Key: env GEMINI_API_KEY=your_actual_api_key_here

Run the script:

# Basic transcription
python AudioTTo.py lecture.wav

# With slides
python AudioTTo.py lecture.wav --slides slides.pdf

# With specific slide pages
python AudioTTo.py lecture.wav --slides slides.pdf --pages 1-15

---

📂 Output Structure

All generated files are organized in the output/ directory:

output/
└── [Audio_Filename]/
    ├── [Audio_Filename]_trascrizione.txt  # Raw text transcript
    ├── [Audio_Filename]_appunti.tex       # Generated LaTeX source
    └── [Audio_Filename]_appunti.pdf       # Final compiled PDF

🧹 Intermediate files (chunks, noisy audio, logs) are automatically cleaned up.

---

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve AudioTTo.

🌟 Star History

☕ Support the Project

If you find AudioTTo useful and want to support its development, consider making a small donation! Your support helps keep the project alive and improving.

📄 License

This project is licensed under the MIT License.

---

Developed with ❤️ by Manumarzo