This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Tag .mp3 and .m4a audio files from iTunes data automatically.

There are various standards in audio file tagging, and the fields they contain are huge mess, but since most of them are not being used by us normal people, to make things simpler, I chose 8 essential and common fields pragmatically:

  • Title
  • Album
  • Artist
  • Album Artist
  • Genre
  • Release Date
  • Track Number
  • Disc Number

By default, autotagger will only work with these 8 fields, anything not included will be ignored.

autotagger is currently tested under Mac OS X with Python 2.7.10, if you find anything wrong with this program, feel free to submit an issue.

TODO:

  • [ ] append album artwork in tracks

Installation

pip install autotagger

Usage

autotagger combines audio files with iTunes data, it uses track number (and disc number, if exists) to identify a song and match it with iTunes data. In short, the progress could be summarized in three steps:

  • Find the url of your album on iTunes, for example.
  • Make sure every song you want to tag has track number (and disc number, if its a multi-CD album) set properly. You can use a ID3 tagging tool like meta on OS X or mp3tag on Windows to achieve that.
  • Run autotagger command with data above.

autotagger --help to see detailed information about command line options.

Input/Paste songs manually

Use -u to indicate the iTunes album url:

autotagger -u https://itunes.apple.com/us/album/schole-compilation-vol.-1/id251480659

After running this command, autotagger will ask you to enter the file paths, you can copy them by right click on songs in finder and choose Copy Path

Then paste them in the terminal, and hit enter to continue.

You can also album id instead of url to make it clearer:

autotagger -i 251480659

Pass songs from pipeline

If you can get the song names from other command’s output, you can use pipeline mode to feed the input, add -p option to enable this feature:

find album -type f -name '*.mp3' | autotagger -i 251480659 -p

Clear other tags

If you want the songs to be tagged just the 8 fields other than anything else, add -c to enable that. By adding this option, only the 8 fields will be contained in the processed songs, any other fields will be removed.

autotagger -i 251480659 -c

Download artwork

Add -a option to download artwork, note this option will make the command stop tagging songs.

autotagger -i 251480659 -a

Screenshots

autotagger -i 251480659

find album -type f -name '*.mp3' | autotagger -i 251480659 -p

Release History

Release History

0.1.6

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.5

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
autotagger-0.1.6-py2-none-any.whl (9.7 kB) Copy SHA256 Checksum SHA256 2.7 Wheel May 27, 2016
autotagger-0.1.6.tar.gz (7.4 kB) Copy SHA256 Checksum SHA256 Source May 27, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting