Metadata-Version: 2.4
Name: albums
Version: 0.1.6
Summary: Manage music albums, automatically correct tags, organize and sync copies with interactive command line interface.
License-Expression: GPL-3.0-or-later
License-File: COPYING
Keywords: flac,mp3,id3,vorbis,tags,music,library
Author: Ivan Cooper
Author-email: ivan@4levity.net
Requires-Python: >= 3.12
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Utilities
Requires-Dist: click (>=8.3.1,<9.0.0)
Requires-Dist: humanize (>=4.15.0,<5.0.0)
Requires-Dist: mutagen (>=1.47.0,<2.0.0)
Requires-Dist: pillow (>=12.1.0,<13.0.0)
Requires-Dist: platformdirs (>=4.5.1,<5.0.0)
Requires-Dist: pyyaml (>=6.0.3,<7.0.0)
Requires-Dist: rich (>=14.2.0,<15.0.0)
Requires-Dist: rich-click (>=1.9.5,<2.0.0)
Requires-Dist: simple-term-menu (>=1.6.6,<2.0.0)
Requires-Dist: xxhash (>=3.6.0,<4.0.0)
Project-URL: Changelog, https://4levity.github.io/albums/changelog/
Project-URL: Documentation, https://4levity.github.io/albums/
Project-URL: Homepage, https://github.com/4levity/albums
Project-URL: Issues, https://github.com/4levity/albums/issues
Project-URL: Repository, https://github.com/4levity/albums
Description-Content-Type: text/markdown

# albums

A rich text-based interactive tool to help manage a library of music, clean up
metadata tags and file organization, and sync parts of the library to digital
audio players

- [Read the documentation here](https://4levity.github.io/albums/)

## Overview

`albums` works with media files and tags, but primarily acts on "albums" rather
than individual files.

It scans the media library and creates a database. It supports adding albums to
"collections," for example to make a list of albums to sync to a digital audio
player. It can also perform the sync. There are automated checks and interactive
fixes for metadata related issues sich as track numbering (sequence, totals,
disc numbers), album-artist tags, etc.

## Supported Media

Most features require each album (soundtrack, mixtape...) to be in a folder.

Any album with recognized media files can be scanned. However, most of the check
features require `albums` to understand the tags. FLAC, Ogg Vorbis, and other
files with Vorbis comment metadata using standard names are supported. ID3 is
supported but many tags are ignored. Other media files have limited support and
checks may be skipped.

## System Requirements

Requires Python 3.12+. Developed/tested on Linux, will support other systems.

