Skip to content

analyze

Defective edited this page Jun 14, 2026 · 4 revisions

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.

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.

Clone this wiki locally