This release is a pre-release and may not be stable for production use.
ovos-media
Warning: this is pre-release software. It is under active development, is not yet deployed in OpenVoiceOS, and its APIs may change without notice. It is published in the open for transparency. Do not depend on it in production yet.
The OVOS Virtual Media Player is a standalone daemon. It plays audio, video, and web content for OpenVoiceOS. It tracks playback state per session, integrates with MPRIS/D-Bus, and uses a pluggable backend architecture.
ovos-media implements OCP (OVOS Common Playback): one logical media player per
session that every media voice command targets. It handles both OVOS-initiated
playback ("play jazz") and transport control ("pause", "next", "stop the music"). It
also bridges to the host OS over MPRIS, so it can control playback OVOS did not
start, such as a browser tab or a desktop player, as long as that player speaks the
open standard. The concept is specified in
OVOS-OCP-1.
ovos-media is the modern replacement for the legacy audio service (the
ovos-ocp-audio-plugin bundled inside ovos-audio). It splits the monolith into
small, swappable pieces: the OCP pipeline finds media, providers supply catalogs,
backends play streams, extractors resolve URIs.
How it fits together
"play jazz on the kitchen speaker"
│
▼
ovos-core ─ OCP pipeline (ovos-ocp-pipeline-plugin)
│ classify media type + parse the request
│ query MediaProvider plugins, rank results
▼
ovos-media (this daemon)
│ pick a playback backend, manage the queue / now-playing,
│ expose state over the bus / MPRIS / GUI
▼
playback backend (opm.media.audio | .video | .web)
│ hand the URI to vlc / mpv / spotify / chromecast / browser …
▼
stream extractor (opm.ocp.extractor) resolves youtube//… , rss//… , file://…
Every arrow is a plugin boundary, so each piece can be replaced independently:
| Concern | Plugin group | Examples |
|---|---|---|
| Find media (catalogs/search) | opm.media.provider |
youtube, bandcamp, soundcloud, tunein, somafm, pyradios |
| Play audio | opm.media.audio |
vlc, mplayer, simple (cli), ffplay, spotify, chromecast, mass, mpris |
| Play video | opm.media.video |
vlc, mplayer, chromecast |
| Render web/webview | opm.media.web |
(rendered via the GUI WebView) |
| Resolve a stream URI | opm.ocp.extractor |
youtube, m3u, rss, files |
Search results flow as mediavocab.Release
objects: a typed catalog model shared across the whole media ecosystem. A
provider written once works for playback, MPRIS metadata, and the GUI alike.
Install
pip install ovos-media
Install at least one playback backend (audio is the minimum to hear anything):
pip install ovos-media-plugin-vlc # or -mplayer / -simple / -spotify / -chromecast
Enable it
ovos-media runs alongside ovos-audio (which keeps handling TTS). Turn off the
legacy audio service and run the daemon:
// mycroft.conf
{
"enable_old_audioservice": false
}
ovos-media # start the daemon
Ask OVOS to play something and the OCP pipeline routes the request here.
Configuration
All configuration lives under the "media" key in mycroft.conf. The essentials:
{
"media": {
// MPRIS / D-Bus integration (off by default)
"enable_mpris": false,
// let MPRIS pause/stop other media players on the system
"manage_external_players": false,
// order of preference per playback type; the first backend that can
// handle the URI wins. Users may also name a backend in the utterance.
"preferred_audio_services": ["vlc", "mplayer", "cli"],
"preferred_video_services": ["vlc"],
// declare the backends available to each playback type.
// "module" is the plugin's entry-point name; "aliases" are spoken names.
"audio_players": {
"vlc": { "module": "ovos-media-audio-plugin-vlc", "aliases": ["VLC"], "active": true },
"cli": { "module": "ovos-media-audio-plugin-cli", "aliases": ["Command Line"], "active": true }
},
"video_players": {
"vlc": { "module": "ovos-media-video-plugin-vlc", "aliases": ["VLC"], "active": true }
}
}
}
See docs/configuration.md for every option (per-backend config, MPRIS roles, GUI update interval, queue behaviour).
Documentation
Start at docs/index.md.
- Getting started: install, enable, first playback
- Architecture: the daemon, the bus API, the plugin boundaries
- Media providers: write a catalog/search plugin (
opm.media.provider) - Playback backends: audio/video/web backend plugins
- Configuration reference
- MPRIS / D-Bus
- Migrating from the legacy audio service
Status
ovos-media is the OCP-native playback stack and is opt-in today (enable it by
turning off the legacy audio service). Catalogs are supplied by
MediaProvider plugins (opm.media.provider). The
legacy OCP search skills still work during the transition.
Credits
The original OCP dataset used to train the media classifiers was sponsored by @NeonGeckoCom as part of The OCP Sprint. More recent media-metadata datasets are maintained by TigreGotico and published in the Media Metadata collection on Hugging Face.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ovos_media-0.3.3a3.tar.gz.
File metadata
- Download URL: ovos_media-0.3.3a3.tar.gz
- Upload date:
- Size: 41.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5eb1ece2b377324f1dad01b943fb79df349a3e54bd6efd94436a10b016d196dc
|
|
| MD5 |
79c6a7d916bf0f683a263f59856f6776
|
|
| BLAKE2b-256 |
13b6394cdd4c18a71f87d87de0c932a251a5968b06ac477a94502ed8a188ca1f
|
File details
Details for the file ovos_media-0.3.3a3-py3-none-any.whl.
File metadata
- Download URL: ovos_media-0.3.3a3-py3-none-any.whl
- Upload date:
- Size: 47.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e6117c9eb66bcec74941dd5e16098c59be49c0f2fa06e2fcd19674061559dc66
|
|
| MD5 |
c269fb4b1f2c82e065bdcbf5162e27ca
|
|
| BLAKE2b-256 |
3e5386cd8074be7c7cae522dd5bece7acebc743e0663d159024fcc49d1889125
|
