Skip to main content

Powerful, simple, audio tag editor

Project description

puddletag

Screenshot

puddletag is an audio tag editor (primarily created) for GNU/Linux similar to the Windows program, Mp3tag. Unlike most taggers for GNU/Linux, it uses a spreadsheet-like layout so that all the tags you want to edit by hand are visible and easily editable.

The usual tag editor features are supported like extracting tag information from filenames, renaming files based on their tags by using patterns and basic tag editing.

Then there’re Functions, which can do things like replace text, trim it, do case conversions, etc. Actions can automate repetitive tasks. Doing web lookups using Amazon (including cover art), Discogs (does cover art too!), FreeDB and MusicBrainz is also supported. There’s quite a bit more, but I’ve reached my comma quota.

Supported formats: ID3v1, ID3v2 (mp3), MP4 (mp4, m4a, etc.), VorbisComments (ogg, flac), Musepack (mpc), Monkey’s Audio (.ape) and WavPack (wv).

Dependencies

puddletag uses several third-party modules to performs its tasks:

How to install

PyPI

Puddletag is available on PyPI.

In addition to the full releases, every time we merge a PR or commit a change, we automatically release a new version on TestPyPI, so if you want to try a brand new feature or a recent bugfix, you can give these pre-releases a try.

There are several tools to install puddletag via PyPI, for example pip, pipx, pipenv, and several others. Choose the one that suits best your workflow, but we strongly recommend you create an isolated, local (f.e. by using pip install --local) environment when installing third-party software.

Distributions package

Here below is a list of the distributions and platforms where puddletag is available, and how to install it:

Debian

apt install puddletag

Contact: @sandrotosi

Gentoo
  1. overlay: https://github.com/istitov/stuff/
  2. add overlay: sudo layman -a stuff
  3. install: sudo emerge -av puddletag

Contact: @DolphinStKom

Arch Linux

puddletag is currently part of the AUR:

git clone https://aur.archlinux.org/puddletag.git
cd puddletag
makepkg -si
Fedora

Available since Fedora 32.

dnf install puddletag

Brew/MacOS

support needed, open an issue if interested in working on it

Source Code

If you seek the bleeding edge of puddletag, or wanting to contribute (we welcome all contributions!) you can install and/or run via source code.

First, you need to install the dependencies; this step is different depending on the distribution; on Debian you can run:

apt install python3 python3-mutagen python3-configobj python3-pyparsing python3-pyqt5 python3-pyqt5.qtsvg python3-unidecode

Then, clone the repo and run puddletag:

git clone 'https://github.com/puddletag/puddletag'
cd 'puddletag'
./puddletag

Alternatively you can use a virtual environment to install the dependencies, which only requires python and pip to be installed:

git clone 'https://github.com/puddletag/puddletag.git'
cd 'puddletag'
python3 -m 'venv' '.'
bin/pip3 install -r 'requirements.txt'
bin/python3 'puddletag'

License

puddletag is licensed under the GPLv3, which you can find in its entirety at http://www.gnu.org/licenses/gpl-3.0.html

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

puddletag-2.4.0.tar.gz (636.7 kB view details)

Uploaded Source

Built Distribution

puddletag-2.4.0-py3-none-any.whl (675.2 kB view details)

Uploaded Python 3

File details

Details for the file puddletag-2.4.0.tar.gz.

File metadata

  • Download URL: puddletag-2.4.0.tar.gz
  • Upload date:
  • Size: 636.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for puddletag-2.4.0.tar.gz
Algorithm Hash digest
SHA256 32d75b8f458ead1d0da72bea14f707cc07d5bd909d75a6d006de72379761ab88
MD5 7acbd1975bfd1335c44e574b0b4812d3
BLAKE2b-256 b22e3660d34f535b6a335e5e8b192c143f79b7aa57160d97acf346bb297f8a40

See more details on using hashes here.

File details

Details for the file puddletag-2.4.0-py3-none-any.whl.

File metadata

  • Download URL: puddletag-2.4.0-py3-none-any.whl
  • Upload date:
  • Size: 675.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for puddletag-2.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b15b0e7f353d8ae000d007e10fe095fdebbe12d8b9669551cea7baa02dbadd52
MD5 50d2c2fe5bdef8bd08384f5bb8f95979
BLAKE2b-256 05ab3129f6245de48159986f01af90ddd01c751c4ab141b65bac0eaf0e968bb3

See more details on using hashes here.

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