Manage music albums, automatically correct tags, organize and sync copies with interactive command line interface.
Project description
albums
Manage a library of music: validate and fix tags and metadata, rename files, adjust and embed album art, clean up and import albums, and sync parts of the library to digital audio players or portable storage
Overview
albums works with media files and tags, but primarily acts on "albums" rather
than individual files. Everything is done locally and an Internet connection is
not required. It's a command-line app but it is designed to be user friendly,
with interactive menus, rich text formatting, tables and even blocky graphics.
It can work with a single folder or scan a whole media library into its database to make subsequent operations fast. It has many automated checks and fixes for metadata related issues such as track numbering (sequence, totals, disc numbers), album-artist tags, embedding cover art, etc. It supports marking albums as part of "collections," for example to make a list of albums to sync to a digital audio player. It can also perform the sync.
Why use albums instead of other music library tools?
Use them all, you don't have to decide. If you have missing metadata or unidentified recordings and you want to use online databases to fill in the blanks, MusicBrainz Picard is good for that. For editing tags with some fancy features and automation, puddletag and MP3TAG (proprietary but no cost for Windows version) are nice, while EasyTAG is simple and quick.
The purpose of albums is finding and fixing metadata problems, resolving
inconsistencies and applying your preferred policies so that standard tags,
cover art, filenames are just right. albums has many individually configured
"checks" to find and sometimes automatically fix problems. You can review each
change, or only the ones that require a choice. The documentation describes what
each check does. albums can also help clean up and import new albums into your
library and keep digital audio players synced.
Supported Media
FLAC, Ogg Vorbis, MP3/ID3, M4A, ASF/WMA and AIFF containers/types are supported with standard tags. ASF/WMA embedded image support is read-only. Image files (PNG, JPEG, GIF, BMP, WEBP, TIFF, etc) in the album folder are scanned and can be automatically converted and embedded.
More formats and tag comprehension will likely be added if requested.
System Requirements
Requires Python 3.12+. Primarily tested on Linux and Windows. Should work on
almost any 64-bit x86 or ARM system with Linux, macOS or Windows. (32-bit and
wider OS support possible by dropping scikit-image library used for measuring
image similarity.)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file albums-0.9.2.tar.gz.
File metadata
- Download URL: albums-0.9.2.tar.gz
- Upload date:
- Size: 85.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
114227385847a64671ca3a77b5db1651a1869c3bd2f0fe2a5a992f9a004ce116
|
|
| MD5 |
ce13d5683e87b69086901f26b71695e3
|
|
| BLAKE2b-256 |
bbf0782a3e7da2dfbe10fcabca2d9404d9288934c40e3b3aaac41946eb0cab6d
|
Provenance
The following attestation bundles were made for albums-0.9.2.tar.gz:
Publisher:
publish.yml on 4levity/albums
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
albums-0.9.2.tar.gz -
Subject digest:
114227385847a64671ca3a77b5db1651a1869c3bd2f0fe2a5a992f9a004ce116 - Sigstore transparency entry: 1117840464
- Sigstore integration time:
-
Permalink:
4levity/albums@a9f5f149c1b1ade01d4210afe67c0868348ed846 -
Branch / Tag:
refs/tags/v0.9.2 - Owner: https://github.com/4levity
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a9f5f149c1b1ade01d4210afe67c0868348ed846 -
Trigger Event:
push
-
Statement type:
File details
Details for the file albums-0.9.2-py3-none-any.whl.
File metadata
- Download URL: albums-0.9.2-py3-none-any.whl
- Upload date:
- Size: 130.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5ed8f2e70eb7f0e33cab33e1d41c06c7acabfd8b13cbfd646cfc3c89e7105a8a
|
|
| MD5 |
2f13c735c35f479e323665c41b9ce0d4
|
|
| BLAKE2b-256 |
4114b1a80bfeb84057bb92158542d4405673bd833a4878c0af7021c18c843f3b
|
Provenance
The following attestation bundles were made for albums-0.9.2-py3-none-any.whl:
Publisher:
publish.yml on 4levity/albums
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
albums-0.9.2-py3-none-any.whl -
Subject digest:
5ed8f2e70eb7f0e33cab33e1d41c06c7acabfd8b13cbfd646cfc3c89e7105a8a - Sigstore transparency entry: 1117840472
- Sigstore integration time:
-
Permalink:
4levity/albums@a9f5f149c1b1ade01d4210afe67c0868348ed846 -
Branch / Tag:
refs/tags/v0.9.2 - Owner: https://github.com/4levity
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a9f5f149c1b1ade01d4210afe67c0868348ed846 -
Trigger Event:
push
-
Statement type: