discogs-tag 1.6.2
An audio tagger based on Discogs metadata.
Requires Python: <4.0,>=3.10

discogs-tag
===========

An audio tagger based on Discogs metadata.

[![PyPI Version](https://img.shields.io/pypi/v/discogs-tag.svg)](https://pypi.org/project/discogs-tag/)

# Usage
```shell
NAME
    discogs-tag

SYNOPSIS
    discogs-tag COMMAND

COMMANDS
    COMMAND is one of the following:

     version
       Return version information.

     tag
       Tag the audio files with the given Discogs release.

     copy
       Copy the audio tags from source to destination folders.

     rename
       Rename the audio files based on the given format string.
```
## tag
```shell
NAME
    discogs-tag tag - Tag the audio files with the given Discogs release.

SYNOPSIS
    discogs-tag tag RELEASE <flags>

DESCRIPTION
    The RELEASE can be one of the following:
        - A full Discogs release URL, e.g. https://www.discogs.com/release/16215626-Pink-Floyd-Wish-You-Were-Here
        - The numeric portion of the above, e.g. 16215626
        - A local file URI pointing to a release JSON file

    The SKIP and ONLY flags can take one or more of the following values, comma-separated:
        artist, composer, title, position, date, subtracks, album, genre, albumartist

        If subtracks are skipped, subtrack titles get appended to their parent track.

    The flag DOTS_AS_SUBTRACKS considers track numbers such as "9.1", "9.2", etc to be subtracks.

POSITIONAL ARGUMENTS
    RELEASE

FLAGS
    --dir=DIR
        Default: './'
    --dry=DRY
        Default: False
    -s, --skip=SKIP
        Type: Optional[]
        Default: None
    -o, --only=ONLY
        Type: Optional[]
        Default: None
    --dots_as_subtracks=DOTS_AS_SUBTRACKS
        Default: True
```
## copy
```shell
NAME
    discogs-tag copy - Copy the audio tags from source to destination folders.

SYNOPSIS
    discogs-tag copy SRC <flags>

DESCRIPTION
    The SKIP and ONLY flags can take one or more of the following values, comma-separated:
        artist, composer, title, position, date, subtracks, album, genre, albumartist

        If subtracks are skipped, subtrack titles get appended to their parent track.

POSITIONAL ARGUMENTS
    SRC

FLAGS
    --dir=DIR
        Default: './'
    --dry=DRY
        Default: False
    -s, --skip=SKIP
        Type: Optional[]
        Default: None
    -o, --only=ONLY
        Type: Optional[]
        Default: None
```
## rename
```shell
NAME
    discogs-tag rename - Rename the audio files based on the given format string.

SYNOPSIS
    discogs-tag rename FORMAT <flags>

DESCRIPTION
    The FORMAT string specifies how to rename the audio files and/or directories according to the following tags:
        %a Artist
        %z Album artist
        %b Album title
        %p Composer
        %d Disc number
        %g Genre
        %n Track number
        %t Track title
        %y Year
        /  Directory separator: Specifies subdirectories to be created starting from the given directory.
           Non-audio files will be moved to their existing subdirectories within the destination root which is assumed to be unique.

POSITIONAL ARGUMENTS
    FORMAT

FLAGS
    --dir=DIR
        Default: './'
    --dry=DRY
        Default: False
```

## release
```shell
NAME
    discogs-tag release - Download the specified Discogs release as JSON.

SYNOPSIS
    discogs-tag release RELEASE

DESCRIPTION
    The RELEASE can be one of the following:
        - A full Discogs release URL, e.g. https://www.discogs.com/release/16215626-Pink-Floyd-Wish-You-Were-Here
        - The numeric portion of the above, e.g. 16215626
        - A local file URI pointing to a release JSON file

POSITIONAL ARGUMENTS
    RELEASE
```
# Development
- Install [`poetry`](https://python-poetry.org/docs/#installation)
- `poetry install && poetry build && pip install .`