███╗   ███╗ █████╗ ██╗   ██╗██╗      ██████╗ ██╗  ██╗ ██████╗ ███████╗████████╗
████╗ ████║██╔══██╗╚██╗ ██╔╝██║     ██╔═══██╗██║  ██║██╔═══██╗██╔════╝╚══██╔══╝
██╔████╔██║███████║ ╚████╔╝ ██║     ██║   ██║███████║██║   ██║███████╗   ██║   
██║╚██╔╝██║██╔══██║  ╚██╔╝  ██║     ██║   ██║██╔══██║██║   ██║╚════██║   ██║   
██║ ╚═╝ ██║██║  ██║   ██║   ███████╗╚██████╔╝██║  ██║╚██████╔╝███████║   ██║   
╚═╝     ╚═╝╚═╝  ╚═╝   ╚═╝   ╚══════╝ ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝   ╚═╝   

ElevenLabs Voice Converter

A simple desktop application for Linux that records audio and converts it using the ElevenLabs Speech-to-Speech API.

⭐ Features

• 🎙️ Real-time Recording: Record audio directly from your microphone
• ⏱️ Live Timer: See recording duration in real-time
• 🔄 Voice Conversion: Transform your voice using ElevenLabs AI
• 💾 Auto Organization: Files saved with timestamps automatically
• ✅ Error Handling: Comprehensive error messages and validation
• 🖥️ Simple GUI: Easy-to-use tkinter interface

Requirements

• Python 3.8 or higher
• Linux with GUI support (X11/Wayland)
• Audio input device (microphone)
• tkinter (usually included, but may require installation on some distributions)

System Dependencies

On Debian/Ubuntu-based systems:

sudo apt install python3-tk

🚀 Quick Start

Installation

1. Clone the repository:

git clone https://github.com/maylohost/elevenlabs.app.0.1.git
cd elevenlabs.app.0.1

2. Create a virtual environment (recommended):

python3 -m venv venv
source venv/bin/activate

3. Install Python dependencies:

pip install -r requirements.txt

Configuration

You need an ElevenLabs API key to use this application.

1. Get your API key from ElevenLabs

2. Set the environment variable before running:

export ELEVENLABS_API_KEY="your_api_key_here"

3. (Optional) Set a custom Voice ID:

export ELEVENLABS_VOICE_ID="your_voice_id_here"

To make it permanent, add these lines to your ~/.bashrc or ~/.profile:

echo 'export ELEVENLABS_API_KEY="your_api_key_here"' >> ~/.bashrc
source ~/.bashrc

Usage

Run the application:

python3 voice_converter_final.py

How to Use

1. Click "🎙️ Avvia / Ferma Registrazione" to start recording
2. Click the button again to stop recording
3. Click "📤 Invia a ElevenLabs" to convert the recorded audio
4. The converted audio will be saved automatically and the output folder will open

File Organization

• Recordings are saved in: ~/Appz/voiceelevenlabs/recordings/
• Converted files are saved in: ~/Appz/voiceelevenlabs/conversions/
• Files are automatically named with timestamps

Error Handling

The application includes robust error handling for:

• Missing or invalid API keys
• Network connection issues
• Timeout errors
• File permission problems
• Invalid audio files

📝 License

This project is open source and available under the MIT License.

👤 Author

maylohost

• GitHub: @maylohost

Notes

• The application requires an active internet connection to use the ElevenLabs API
• Large audio files may take longer to process
• Make sure you have sufficient API quota on your ElevenLabs account