analyze

Analyze command

(Re)analyze tracks from a remote Subsonic instance

usage: analyze [options]
 -a,--all                            Analyze all tracks, even if they are present in the database.
    --album-artist-filter <artist>   Filter analyzed tracks based on album artist name. This option is
                                     case-insensitive.
    --artist-filter <artist>         Filter tracks based on artist name. This option is case-insensitive.
 -d,--db <file>                      SQLite database location (default ./data/analysis.sqlite)
 -h,--help                           Display this help section
 -p,--password <pass>                Subsonic password (Required)
 -s,--url <url>                      Subsonic instance URL (Required)
 -t,--tensorflow-url <url>           Essentia analyzer URL (Default http://127.0.0.1:8000/)
 -u,--user <username>                Subsonic username (Required)

Required arguments:

• --password
• --url
• --user

analyze downloads a complete list of albums and songs from a Subsonic instance. After doing this, it downloads each song's audio file in order specified by the server (on Navidrome the default is from oldest to newest), and uploads the path to the downloaded audio file to the analyzer server. It then stores analysis results in the database that can be used to perform other tasks.

Note

For this command to work, the analyzer service has to be started.

Caution

For this command to work correctly, both the tool AND the analyzer service have to run on the same machine with a /tmp (or other system-defined temporary directory) shared between them.

Examples

Example music analysis command:

analyze -u demo -p demo -s "https://demo.navidrome.org" --artist-filter "2 Mello"

This command will download all available tracks on Navidrome's demo instances, filter the ones belonging to 2 Mello, and then analyze and store them in database.
You can check the analyzed tracks with the stats command