v0.0.5: Audio Volume Normalization & Metadata Improvements

v0.0.5 - Audio Volume Normalization & Metadata Improvements

🔊 Fixed Audio Issues

Volume Normalization ✅

• Censored audio track now properly matches original volume levels
• Applied 4dB boost to compensate for re-encoding volume loss
• Volume gap reduced from 3.2 dB → 0.9 dB (70% improvement)
• Affects both dual-audio and single-audio modes

Audio Metadata ✅

• Language tags properly set to "eng" for both audio tracks
• Censored track set as default for automatic playback
• Better media player compatibility and track identification

🎯 Container Format Preservation

• Output maintains original container format (MP4→MP4, MKV→MKV)
• No unnecessary format conversion
• Maximum compatibility with source files

📦 Installation

Via Pip:

pip install censorbot==0.0.5

Via pipx (recommended for CLI tools):

# Run without installing
pipx run censorbot -i video.mp4 -o output.mp4

# Or install in isolated environment
pipx install censorbot
censorbot -i video.mp4 -o output.mp4

Via Docker:

docker pull samuelmukoti/censorbot:0.0.5
docker pull samuelmukoti/censorbot:latest

🧪 Test Results

Tested with Seven Pounds (2hr movie):

• ✅ Volume levels: Censored track within 1dB of original
• ✅ Language metadata: Both tracks labeled "eng"
• ✅ Default track: Censored audio auto-selected
• ✅ Container format: MP4 preserved correctly

📝 Technical Details

Volume Filter Applied:

"-filter:a:1", "volume=4dB"  # Dual audio mode
"-filter:a", "volume=4dB"    # Single audio mode

Metadata & Disposition:

"-metadata:s:a:0", "language=eng"
"-metadata:s:a:1", "language=eng"
"-disposition:a:1", "default"  # Censored as default

🔗 Resources

• Documentation: README.md
• PyPI: https://pypi.org/project/censorbot/
• Docker Hub: https://hub.docker.com/r/samuelmukoti/censorbot
• Report Issues: https://github.com/samuelmukoti/censorbot/issues

---

Note: System dependency required: FFmpeg must be installed separately when using pip/pipx.

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

Installation

Via Pip

pip install censorbot==0.0.5

Via Docker

docker pull samuelmukoti/censorbot:0.0.5