Skip to main content
Archived

This project has been archived by its maintainers, and is no longer receiving any updates.

Mopidy-Local-Images

Mopidy-Local-Images is a Mopidy local library and Web extension that allows Web clients access to album art embedded in local media files. It does so by acting as a proxy between Mopidy’s local scan command and the actual local library provider being used. Images are extracted from media files and stored as individual image files while scanning, and corresponding image URIs are inserted into Mopidy data models. Clients can then access these images through the Web extension. All other requests are delegated to the actual local library provider as-is.

Album art stored in separate files is also supported. External image files will be considered if they reside in the same directory as the scanned media files and file names match a configurable pattern.

Please note that support for local album art depends on whether your client supports album images as provided by Mopidy’s data model. For example, some clients will ignore any images provided by this extension, and will retrieve album art from external services instead.

Installation

Mopidy-Local-Images can be installed using pip by running:

pip install Mopidy-Local-Images

Configuration

Before starting Mopidy, you must change your configuration to switch to using Mopidy-Local-Images as your local library provider:

[local]
library = images

By default, Mopidy-Local-Images delegates any requests to the standard json local library provider. To use a third-party library, such as Mopidy-Local-SQLite, you have to set this in the local-images configuration section:

[local-images]
library = sqlite

Once this has been set, you need to clear and re-scan your library for images to be extracted:

mopidy local clear
mopidy local scan

This extension also provides some other configuration settings, but beware that these are subject to change for now:

[local-images]
enabled = true

# the actual local library provider to use
library = json

# the base URI for images; change this if you want to serve images
# using an alternative Web server, or when accessing Mopidy through a
# reverse proxy
base_uri = /images/

# the directory where local image files are stored; if not set,
# creates its own subdirectory in <core/data_dir>
image_dir =

# a list of file names to check for when searching for external album
# art; may contain UNIX shell patterns, i.e. "*", "?", etc.
album_art_files = *.jpg, *.jpeg, *.png

Project Resources

Latest PyPI version Number of PyPI downloads Travis CI build status Test coverage

License

Copyright (c) 2014, 2015 Thomas Kemmer and contributors.

Licensed under the Apache License, Version 2.0.

Known Bugs and Limitations

With Mopidy v0.19, using this extension will slow down mopidy local scan considerably, since every media file has to be scanned twice. This should no longer be a problem in Mopidy v1.0 and later versions.

Metadata

Release files for Mopidy-Local-Images 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Mopidy-Local-Images 1.0.0
File Size Uploaded
Mopidy-Local-Images-1.0.0.tar.gz 13.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Mopidy-Local-Images 1.0.0
File Interpreter ABI Platform
Mopidy_Local_Images-1.0.0-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 24.4 kB

Release files / Mopidy-Local-Images-1.0.0.tar.gz

Download URL Mopidy-Local-Images-1.0.0.tar.gz
Size 13.4 kB
Tags Source
SHA-256 checksum
How to use checksums
3ea10bcaa83a2f1af0f0c106747badf3b2cee3b288956d8cb31696165a98de06
BLAKE2b-256 checksum
How to use checksums
aca02b289611d80753f4d536fd3a57b06ee2d2f388f2c34fbca3d23fadd07f7a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / Mopidy_Local_Images-1.0.0-py2.py3-none-any.whl

Download URL Mopidy_Local_Images-1.0.0-py2.py3-none-any.whl
Size 11.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
a230de333f6ee93650c64e8fda8d955d5a27d429d3fd0202dcc532e4ad2728aa
BLAKE2b-256 checksum
How to use checksums
0d76e49b06e6d2a7aa4b94a407ab400e138acbd0e01791adfdc5492084da5411
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page