Mopidy-Local-SQLite 0.7.2

Installation

Install by running:

pip install Mopidy-Local-SQLite

Configuration

Before starting Mopidy, you must change your configuration to switch to using Mopidy-Local-SQLite as your preferred local library. It is also recommended to change the default scan_flush_threshold, to improve database access during a local scan:

[local]
library = sqlite
scan_flush_threshold = 100

Once this has been set you need to re-scan your library to populate the database:

mopidy local scan

This extension also provides some configuration settings of its own, but beware that these are still subject to change:

[local-sqlite]
enabled = true

# top-level directories for browsing, format is <name> <uri>
directories =
    Albums      local:directory?type=album
    Artists     local:directory?type=artist&role=artist
    Composers   local:directory?type=artist&role=composer
    Performers  local:directory?type=artist&role=performer
    Genres      local:directory?type=genre
    Years       local:directory?type=date&format=%25Y
    Tracks      local:directory?type=track

# encodings (in order of preference) to try when generating track
# names from file URIs
encodings = utf-8, latin-1

# database connection timeout in seconds
timeout = 10

# whether to use an album's musicbrainz_id for generating its URI
use_album_mbid_uri = true

# whether to use an artist's musicbrainz_id for generating its URI;
# disabled by default, since some taggers do not handle this well for
# multi-artist tracks [https://github.com/sampsyo/beets/issues/907]
use_artist_mbid_uri = false

# whether to extract images from local media files (experimental)
extract_images = false

# directory where extracted images are stored; if a relative path is
# given, names a subdirectory of <local/data_dir>/sqlite
image_dir = images

# base URI for images; if blank, the local file URI will be used
image_base_uri = /sqlite/images/

# file names to check for in the current directory when no embedded
# album art can be found; items may contain UNIX shell patterns
album_art_files = *.jpg, *.jpeg, *.png

Project Resources

• Issue Tracker

• Source Code

• Change Log

License

Copyright (c) 2014 Thomas Kemmer.

Licensed under the Apache License, Version 2.0.

Known Bugs and Limitations

The database schema does not support multiple artists, composers or performers for a single track or album (yet). Look out for “Ignoring multiple artists” warnings during a local scan to see if you are affected by this.