Command line toolfindoperaYour library, and the catalog behind it

A command line tool for an opera library and the database behind it. It names the folders on your disk from this catalog, and reads and edits the catalog itself.

Install

macOS and Linux

curl --proto '=https' --tlsv1.2 -LsSf https://findopera.com/install.sh | sh

Windows

irm https://findopera.com/install.ps1 | iex

Or take a binary from the releases page. Linux builds are statically linked, so they run on a NAS as well as on a desktop.

Your library

Each folder gets a text file of notes about its recording — cast, conductor, year, orchestra — so it says what it holds without anything being opened. The id in that filename is how the tool recognizes the folder again.

findopera annotate 10655    # write a recording's notes here
findopera init ~/Music      # settings, every option explained
findopera organize ~/Music  # what each folder would be called
findopera organize ~/Music --write

Nothing is written without --write, and nothing is ever deleted or overwritten.

The catalog

Everything here can be searched, read, added to and corrected — this is a community database, and the CLI is one of the ways in.

findopera search recording tosca --conductor 'de sabata'
findopera get recording 264
findopera describe singer      # what a new one needs, or --json for a schema
findopera create singer -m 'source and reason'

Every change wants a source and a reason, and every change is kept and can be undone.

Signing in

A token raises the rate limit and lets you contribute. login --new asks for a username and issues one for a fresh account; the name is public and rides along on every change you make.

findopera login --new --username tosca-1900

If you already have an account, do not make a second one — mint a token for the one you have on your account page and paste it in, so your terminal and your browser are the same editor.

findopera login < token.txt

Underneath

findopera graphql sends a query straight to the API, and findopera schema prints what may be asked for.

Something wrong?

findopera feedback reaches the same place the button at the bottom of every page does. Source and issues are on github.com/captbaritone/findopera-cli.