audinota 0.1.1

Basic Usage

# Simple transcription - output saved next to input file
$ audinota transcribe --input="podcast.mp3"

# Specify output directory
$ audinota transcribe --input="lecture.mp4" --output="/path/to/transcripts/"

# Specify exact output file
$ audinota transcribe --input="interview.wav" --output="result.txt"

# Overwrite existing files
$ audinota transcribe --input="audio.m4a" --output="existing.txt" --overwrite

Parameters

–input (required)

Path to the input audio file. Supports popular formats including:

• MP3, MP4, M4A (most common)

• WAV, FLAC, OGG (uncompressed/lossless)

• And many more formats supported by faster-whisper

–output (optional)

Controls where the transcription is saved:

• Not specified: Creates a .txt file next to the input file

  $ audinota transcribe --input="podcast.mp3"
  # Creates: podcast.txt

• Directory path: Creates a .txt file in the specified directory

  $ audinota transcribe --input="podcast.mp3" --output="/transcripts/"
  # Creates: /transcripts/podcast.txt

• File path: Uses the exact specified file path

  $ audinota transcribe --input="podcast.mp3" --output="my_transcript.txt"
  # Creates: my_transcript.txt

–overwrite (optional, default: False)

Boolean flag that controls file overwriting behavior:

• False (default): If output file exists, shows error and stops

• True: Overwrites existing output files without asking

File Conflict Resolution

Audinota intelligently handles file name conflicts:

Automatic Numbering

When output goes to a directory and files already exist:

$ audinota transcribe --input="audio.mp3" --output="/transcripts/"
# If /transcripts/audio.txt exists, creates /transcripts/audio_01.txt
# If both exist, creates /transcripts/audio_02.txt, etc.

File Path Conflicts

When –output specifies an existing file:

$ audinota transcribe --input="audio.mp3" --output="existing.txt"
# Error: Output file 'existing.txt' already exists. Use --overwrite

$ audinota transcribe --input="audio.mp3" --output="existing.txt" --overwrite
# Overwrites existing.txt

Real-World Examples

# Transcribe a podcast episode
$ audinota transcribe --input="episode_042.mp3"
# Output: episode_042.txt

# Batch processing to organized directory
$ mkdir transcripts
$ audinota transcribe --input="meeting_2024_01.m4a" --output="transcripts/"
$ audinota transcribe --input="meeting_2024_02.m4a" --output="transcripts/"
# Output: transcripts/meeting_2024_01.txt, transcripts/meeting_2024_02.txt

# Process lecture with custom naming
$ audinota transcribe --input="cs101_lecture.mp4" --output="notes/week1_lecture.txt"

# Replace previous transcription
$ audinota transcribe --input="revised_audio.wav" --output="final_transcript.txt" --overwrite

Performance Features

The CLI automatically provides:

• 🚀Parallel Processing: Utilizes all CPU cores for maximum speed

• 🧠Smart Segmentation: Automatically splits large files for optimal processing

• 🌍Language Detection: Automatically detects spoken language

• 📊Progress Feedback: Real-time status updates with emoji indicators

• 🔍Format Detection: Handles various audio formats without configuration

$ audinota transcribe --input="long_podcast.mp3"
🎵 Transcribing audio file: long_podcast.mp3
📝 Output will be saved to: long_podcast.txt
🔄 Loading audio data...
🚀 Starting parallel transcription...
💾 Saving transcription...
✅ Transcription completed successfully!
📄 Output saved to: file:///path/to/long_podcast.txt
📊 Text length: 15,847 characters