Skip to content

🎵 Command line utilities for Ableton Live 12's browser

License

Notifications You must be signed in to change notification settings

17cupsofcoffee/LiveTagger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LiveTagger

LiveTagger is a utility which allows you to batch edit Ableton Live 12's library tags from the command line.

It allows you to quickly automate tasks that would be tedious to do via Live's UI - for example, with a single command, you can tag all files with 'Kick' in the name as kick drums, no matter how deeply nested they are in your sample folder.

Caution

  • This software is not endorsed or supported by Ableton.
  • Careless use (or bugs) may mess up your existing manual tagging.
  • Use at your own risk!

Installing

To download LiveTagger, go to the releases page and download the .zip file for your platform. Extract this into a location that is on your system PATH.

Alternatively, if you want to build from source, clone this repo and run cargo build.

Usage

Adding some tags to the files in the current folder is as simple as:

livetagger add "Drums|Hihat" "Drums|HiHat|Closed" --commit

This command has various options you can use to tweak the behaviour:

  • --include (or -i) allows you to specify which files will be processed, using a glob pattern. Some fun ways to use this:
    • To process nested folders, pass --include "**/*".
    • To process files containing the word 'Kick', pass --include "*Kick*".
  • --commit (or -c) makes the command save its changes.
    • Without this, the command will just log what files would be impacted.
    • I strongly suggest running without --commit before making any big changes, to make sure the command is going to do what you're expecting!
  • --backup (or -b) will create a backup of any files that are changed.
    • To restore a backup, go to the Ableton Folder Info subdirectory next to the files you tagged, and rename the .xmp.bak file to .xmp.

There are also several other commands available:

  • livetagger remove removes certain tags from the specified files.
  • livetagger remove-all removes all tags from the specified files.

For more detailed info on the options available, run livetagger --help.

Tag Naming

Live stores its tags in the format Category|Tag|Sub Tag, with the names matching what is displayed in the 'Edit' panel of Live's browser (including spaces).

If you specify a category/tag/subtag that does not exist, Live will create it automatically. Watch out for typos!

Notes

  • This tool works by manually modifying the XMP metadata files that Live creates. If Ableton change the format of those files, this tool may break!

About

🎵 Command line utilities for Ableton Live 12's browser

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project