Skip to main content

An audio tagger based on Discogs metadata.

Project description

discogs-tag

An audio tagger based on Discogs metadata.

PyPI Version

Usage

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

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

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

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

Development

  • Install poetry
  • poetry install && poetry build && pip install .

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

discogs_tag-1.5.0.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

discogs_tag-1.5.0-py3-none-any.whl (8.1 kB view details)

Uploaded Python 3

File details

Details for the file discogs_tag-1.5.0.tar.gz.

File metadata

  • Download URL: discogs_tag-1.5.0.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.10.12 Linux/6.12.10-76061203-generic

File hashes

Hashes for discogs_tag-1.5.0.tar.gz
Algorithm Hash digest
SHA256 ca2ef20d35aaf277d6b56a1a2ad0e190cf52ffc5aad9069b70fd08035ad35d42
MD5 ca93dfd98a24ac6d094eaba338f9cf60
BLAKE2b-256 28c3f2c3cb2cbff3ff64c4e8723b514b34252d18f117ae86cbf0b7c783e85004

See more details on using hashes here.

File details

Details for the file discogs_tag-1.5.0-py3-none-any.whl.

File metadata

  • Download URL: discogs_tag-1.5.0-py3-none-any.whl
  • Upload date:
  • Size: 8.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.10.12 Linux/6.12.10-76061203-generic

File hashes

Hashes for discogs_tag-1.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3691bc6cfa22b0d6b4df8162513ae2ca84d8083a981116dd344be2f14e3903c3
MD5 57a19c8ae1c84cb3d0d31f6a5f44f527
BLAKE2b-256 e0efb6c382f86a8e7d6a977b4952017d1524e343da67e05063b5e418d8a93503

See more details on using hashes here.

Supported by

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