chryses/audiomedia-checker repository overview

⁠AudioMedia Checker

AI-powered audio track language detection and automatic tagging for video files using OpenAI Whisper.

⁠🚀 Quick Start

# Analyze single file
docker run --rm \
  -v /path/to/movies:/data \
  chryses/audiomedia-checker:latest \
  --file "/data/Movie.mkv"

# Recursive folder analysis
docker run --rm \
  -v /path/to/library:/data \
  chryses/audiomedia-checker:latest \
  --folder "/data" \
  --recursive

# GPU-accelerated (10x faster)
docker run --rm --gpus all \
  -v /path/to/library:/data \
  chryses/audiomedia-checker:latest \
  --gpu \
  --folder "/data" \
  --recursive

⁠📖 What It Does

This Docker container automatically:

• ✅ Detects audio track languages using OpenAI Whisper AI
• ✅ Updates language metadata in MKV files
• ✅ Processes single files or entire folder trees
• ✅ Analyzes only untagged tracks (or all with --check-all-tracks)
• ✅ Supports 100+ languages with configurable confidence
• ✅ GPU acceleration for 5-10x faster processing
• ✅ Safe dry-run mode for testing

⁠⚙️ Key Arguments

⁠🎯 Whisper Models

⁠📁 Supported Formats

⁠Fully Supported (Read + Write)

• ✅ .mkv - Metadata updates applied

⁠Read-Only (Dry-Run Mode)

• 📖 .mp4, .avi, .mov, .m4v, .flv, .wmv, .webm
• Detection works, but no tag modifications

⁠💡 Usage Examples

⁠Basic Analysis

docker run --rm \
  -v /media/downloads:/data \
  chryses/audiomedia-checker:latest \
  --file "/data/MyMovie.mkv" \
  --verbose

⁠Recursive with Custom Settings

docker run --rm \
  -v /media/library:/library \
  chryses/audiomedia-checker:latest \
  --folder "/library" \
  --recursive \
  --confidence 75 \
  --model small

⁠Force Italian Language

docker run --rm \
  -v /media/italian:/data \
  chryses/audiomedia-checker:latest \
  --folder "/data" \
  --force-language ita

⁠GPU Acceleration

docker run --rm --gpus all \
  -v /media/library:/data \
  chryses/audiomedia-checker:latest \
  --gpu \
  --folder "/data" \
  --recursive \
  --model medium

Requirements: NVIDIA GPU + NVIDIA Container Toolkit⁠

⁠Safe Dry-Run Test

docker run --rm \
  -v /media/test:/data \
  chryses/audiomedia-checker:latest \
  --dry-run \
  --folder "/data" \
  --check-all-tracks \
  --verbose

⁠🔧 Integration Examples

⁠Post-Download Script

#!/bin/bash
docker run --rm \
  -v "$DOWNLOAD_DIR:/data" \
  chryses/audiomedia-checker:latest \
  --file "/data/$FILENAME"

⁠Cron Job (Daily Scan)

0 2 * * * docker run --rm -v /media:/data chryses/audiomedia-checker:latest --folder "/data" --recursive

⁠Sonarr/Radarr Custom Script

docker run --rm \
  -v "$(dirname "$sonarr_episodefile_path"):/data" \
  chryses/audiomedia-checker:latest \
  --file "/data/$(basename "$sonarr_episodefile_path")"

⁠🌍 Language Support

100+ languages detected automatically using ISO 639-2 codes:

• 🇬🇧 eng (English)
• 🇮🇹 ita (Italian)
• 🇫🇷 fra (French)
• 🇪🇸 spa (Spanish)
• 🇩🇪 deu (German)
• 🇯🇵 jpn (Japanese)
• 🇰🇷 kor (Korean)
• 🇷🇺 rus (Russian)
• 🇨🇳 chi (Chinese)
• ...and 90+ more

Use --help-languages to see full list.

⁠⚠️ Important Notes

⁠File Modifications

• ✅ MKV files modified in-place (no backup)
• ✅ Only metadata changed (streams untouched)
• 💡 Test with --dry-run first

⁠Performance

• 🐌 CPU: ~15-30s per file (base model)
• 🚀 GPU: ~3-5s per file (5-10x faster)
• 📊 Larger models = better accuracy, slower speed

⁠Resource Requirements

⁠🐛 Troubleshooting

⁠GPU Not Working

# Test NVIDIA runtime
docker run --rm --gpus all nvidia/cuda:11.8.0-base-ubuntu22.04 nvidia-smi

# If fails, install NVIDIA Container Toolkit
# https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/

⁠Permission Errors

# Run as your user
docker run --rm --user $(id -u):$(id -g) \
  -v /media:/data \
  chryses/audiomedia-checker:latest ...

⁠Low Confidence

1. Try larger model: --model medium
2. Lower threshold: --confidence 50
3. Use --force-language as fallback

⁠🏗️ Supported Architectures

• ✅ linux/amd64 (x86_64)
• ✅ linux/arm64 (ARM 64-bit)

⁠📚 Full Documentation

GitHub: Jorman/Scripts/AudioMediaChecker⁠

Complete README with advanced usage, troubleshooting, and integration examples.

⁠🙏 Powered By

• OpenAI Whisper⁠ - AI speech recognition
• MKVToolNix⁠ - MKV manipulation
• FFmpeg⁠ - Media processing

⁠📄 License

GNU General Public License v3.0

⁠💬 Support

• Issues: GitHub Issues⁠
• Discussions: GitHub Discussions⁠

Made with ❤️ for audio perfectionists

Auto-built via GitHub Actions | Source: GitHub⁠