Trimmer

MP3 song normalizer

Do you find it annoying when songs on YouTube are recorded quietly and there is a long silence before and after the song?

Trimmer corrects this by generating the normalized MP3 for you:

1. Downloads a song from a URL on Youtube (thanks to youtube-dl and yt-dlp)
2. Trims down the silence at the beginning and at the end of a song (thanks to pydub)
3. Normalizes volume (detects clipping), and applies fade-in and fade-out (thanks to pydub)
4. Adds MP3 ID3 tags - both ID3v1 & ID3v2 (thanks to eyed3)
5. Creates an mp3 file with a unified name Artist - Title.mp3

Downloading MP3

Create trimmed, normalized and tagged mp3 from Youtube URL:

trimmer https://www.youtube.com/watch?v=dQw4w9WgXcQ

Editing MP3

trimmer "unknown001.mp3"

From this:
unknown001.mp3

trimmer does that:
Mike Oldfield - Tubular Bells Part I.mp3

You can also trim song manually using --trim-start and --trim-end (e.g. for cutting long applause at the end of song).

Installation

pip3 install trimmer

It requires Python 3.6 (or newer) with pip.

For Linux make sure that required libs are installed: apt install ffmpeg libavcodec-extra

For Windows you might need to put ffmpeg binaries to PATH.

Upgrading

Keep up-to-date frequently changing dependencies (due to Youtube API changes):

pip3 install --upgrade --upgrade-strategy eager trimmer

or do the same with:

trimmer --upgrade

Help

$ trimmer --help
trimmer v1.0.0 (nuclear v1.3.4) - MP3 song normalizer

Usage:
trimmer [OPTIONS] SOURCE

Arguments:
   SOURCE - song source (youtube URL or MP3 file)

Options:
  --version                   - Print version information and exit
  -h, --help [SUBCOMMANDS...] - Display this help and exit
  --artist ARTIST             - song artist
  --title TITLE               - song title
  --trim-start TRIM_START     - trim given seconds at the beginning
  --trim-end TRIM_END         - trim given seconds at the end
  --gain GAIN                 - increase volume by given dB
  --output OUTPUT             - output MP3 file (Artist - Title.mp3 by default)
  --no-normalize              - skip normalizing volume level
  --no-trim                   - skip trimming silence at the edges of song
  --no-fade                   - skip applying fade-in & fade-out
  --no-rename                 - skip renaming song to normalized filename (Artist - Title.mp3)

Install locally in develop mode

make setup
. venv/bin/activate