ovos-media-provider-soundcloud

July 31, 2026 ยท View on GitHub

An OVOS MediaProvider plugin for SoundCloud. It replaces the deprecated OCP search skill ovos-skill-soundcloud.

The OCP pipeline used to broadcast ovos.common_play.query over the bus and wait for skills to answer. Now it loads MediaProvider plugins in-process, gates them by routing, and calls search() directly. This plugin wraps the nuvem_de_som SoundCloud client. Its orchestrator, SoundCloud.search(), already returns mediavocab.Release objects. The plugin drops artist and user identity hits (mediavocab.Entity), because a MediaProvider returns playable media, not identities.

Install

pip install ovos-media-provider-soundcloud

Routing

AxisValue
mediaMUSIC, PLAYLIST
playback_typeAUDIO
genre_filter(none)

Entry point

OCP finds the plugin through this entry point:

[project.entry-points."opm.media.provider"]
soundcloud = "ovos_media_provider_soundcloud:SoundcloudMediaProvider"

Configuration

KeyDefaultDescription
max_results10Maximum number of results returned per search.

License

Apache-2.0