Skip to main content

MP3 song normalizer

Project description

Trimmer

GitHub version PyPI version Documentation Status Build Status Coverage Status

MP3 song normalizer

trimmer does the following things:

  1. Downloads songs from given youtube URL (thanks to youtube-dl)
  2. Trims down silence at the beginning & at the end of song (thanks to pydub)
  3. Normalizes volume level, applies fade-in & fade-out (thanks to pydub)
  4. Adds MP3 ID3v2 tags (thanks to eyed3)
  5. Creates mp3 file named: Artist - Title.mp3

Usage

Downloading MP3 from YouTube URL

Create trimmed, normalized, tagged mp3:

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

Usage example

Editing MP3

Trim down manually (e.g. long applause at the end of song)

trimmer "Rick Astley - Never Gonna Give You Up.mp3" --trim-end 30

Help

$ trimmer --help
trimmer v0.1.3 (cliglue v1.0.8) - Automatic song processing tool

Usage:
/mnt/data/Igrek/python/trimmer/venv/bin/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
  --upgrade                   - upgrade dependencies & exit

Installation

pip3 install trimmer

Requirements:

  • Python 3.6 (or newer) with pip

Upgrading

pip3 install --upgrade trimmer

Install locally in develop mode

./setup_venv.sh
. venv/bin/activate
python setup.py develop

TODO

  • idempotent trimming (not trimming fade-outs again)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trimmer-0.1.4.tar.gz (8.6 kB view hashes)

Uploaded Source

Built Distribution

trimmer-0.1.4-py3-none-any.whl (12.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page