Skip to main content

A script to automatically find a song's info.

Project description

Audfill

A python script to find song's info and rename them by looking them up on audd.io.

An API token is required to do more than 10 requests per day.

Installation

Requirements

  • Python >= 3.7
  • FFmpeg must be installed on the system and in the PATH
  • Python modules:
    • click
    • requests
    • validators
    • pydub

PIP

python -m pip install audfill

Local Installation

Run inside Audfill directory.

python -m pip install -e .

Usage

A sound file must always be specified. Most sound files are supported (anything that FFmpeg and Pydub supports).

Specifiying no options will send the request, but not do anything with the response.

An example to print information about a song:

audfill song.mp3 -i

Wildcards

Wildcards are supported and will loop though all files in a directory. The following example prints all the information about MP3s in the current directory.

audfill *.mp3 -i

Sources

This script is also capable of getting additional data from Apple Music, Spotify, Napster, and Deezer. To explicitly get info from these sources, use -s [source]. Data from sources listed first will be used for naming files. Sources will be implicitly added as necessary unless the minimum flag is specified (-n).

API Token

An API key can be specified with the option -t or can be read automatically with the environment variable AUDDIOKEY.

audfill song.mp3 -k exampleToken123

File naming

For use with renaming files or downloading art and previews. File extension will automatically be added, do not add your own extension.

  • Percent Symbol: %%
  • Filename: %f
  • Artist(s) %a
  • Composer: %c
  • Album: %b
  • Genre(s): %g
  • Title: %T
  • Short Title: %t
  • Explicit: %x
  • ISRC: %i
  • Disk Number: %k
  • Track Number: %#
  • Release Date:
    • Capital letters represent extended (ex. 1997, 03), lowercase letters represent short dates (ex. 97, 3)
      • %Y, %y
      • %M, %m
      • %D, %d

Example (Renames to Artist - Title.mp3):

audfill song.mp3 -r '%a - %T'

Running with Python

python audfill.py [filename] [options]

Running with Python PIP

python -m audfill [filename] [options]

Running executable

audfill [filename] [options]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Audfill, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size Audfill-1.0-py3-none-any.whl (3.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size Audfill-1.0.tar.gz (11.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page