otty / dotfiles

All tools/beets

beets

The media library management system for obsessive music geeks.

Detected by beet | macOS, Linux, Windows |beets.io

Sync it beets.toml

Sync rules

What travels, what stays, what never leaves

beets in your home directory Every rule on this page, by file

directorylibrary

Each machine keeps its own copy of these.

discogs.user_tokendiscogs.apikeyspotify.client_secret

Lifted into your secret store; the rest of the file syncs.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/beets.tomlThe file this page is generated from

id = "beets"

name = "beets"

homepage = "https://beets.io"

description = "The media library management system for obsessive music geeks."

# The beet, from the documentation's static assets.

icon = "https://raw.githubusercontent.com/beetbox/beets/master/docs/_static/beets_logo_nobg.png"

detect = ["beet"]

# https://beets.readthedocs.io/en/stable/reference/config.html, "Location":

# the config file is ~/.config/beets/config.yaml on Unix,

# ~/Library/Application Support/beets/config.yaml on macOS and

# %APPDATA%\beets\config.yaml on Windows — the three spellings of one place,

# which is what [appData] names. (The same page notes macOS also honours

# ~/.config/beets, and $BEETSDIR overrides all of it.)

paths = ["[appData]/beets/config.yaml"]

# library.db (the library database) and state.pickle sit in the same directory

# and are data, not configuration. Neither is named above, so there is nothing

# to carve out of what is.

exclude = []

# config.yaml is not a credential end to end — it is the import policy, the

# path formats and the plugin list. Only the plugin keys are lifted out below.

secret = []

# The library location. "directory: The path to the directory where you'd like

# to keep your music" and "library: The path to the beets library file"

# (reference/config.html) — both absolute paths into this machine's disk, and

# the one thing in the file that does not survive a move to another machine.

# They are also where the user's music and library actually sit, which is the

# first thing they would need back after a rebuild, so both are kept: backup.

[[machine_lines]]

file = "[appData]/beets/config.yaml"

match = { key_path = ["directory", "library"] }

scope = "backup"

# Plugin credentials that live in the same file: the Discogs plugin documents

# `user_token` and `apikey`

# (https://beets.readthedocs.io/en/stable/plugins/discogs.html) and the Spotify

# plugin documents `client_secret`

# (https://beets.readthedocs.io/en/stable/plugins/spotify.html).

[[secret_paths]]

file = "[appData]/beets/config.yaml"

match = { key_path = ["discogs.user_token", "discogs.apikey", "spotify.client_secret"] }

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/beets. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits directory and library for you — that part is Otty’s own sync, or a template you write by hand.