mopidy-soundcloud
Mopidy extension for playing music from SoundCloud.
Maintainer wanted
Mopidy-SoundCloud is currently kept on life support by the Mopidy core developers. It is in need of a more dedicated maintainer.
If you want to be the maintainer of Mopidy-SoundCloud, please:
-
Make 2-3 good pull requests improving any part of the project.
-
Read and get familiar with all of the project's open issues.
-
Send a pull request removing this section and adding yourself as the "Current maintainer" in the "Credits" section below. In the pull request description, please refer to the previous pull requests and state that you've familiarized yourself with the open issues.
As a maintainer, you'll be given push access to the repo and the authority to make releases to PyPI when you see fit.
Installation
Install by running:
python3 -m pip install mopidy-soundcloud
See https://mopidy.com/ext/soundcloud/ for alternative installation methods.
Configuration
First, you must register for a user acconut at https://soundcloud.com/.
Second, you need a SoundCloud authentication token for Mopidy from https://mopidy.com/authenticate.
Lastly, add the authentication token to the mopidy.conf config file:
[soundcloud]
auth_token = 1-1111-1111111
explore_songs = 25
Use explore_songs to restrict the number of items returned.
Troubleshooting
If you're having trouble with audio playback from SoundCloud, make sure you have
the "ugly" plugin set from GStreamer installed for MP3 support. The package is
typically named gstreamer1.0-plugins-ugly or similar, depending on OS and
distribution. The package isn't a strict requirement for Mopidy's core, so you
may be missing it.
Project resources
Development
Set up development environment
Clone the repo using, e.g. using gh:
gh repo clone mopidy/mopidy-soundcloud
Enter the directory, and install dependencies using uv:
cd mopidy-soundcloud/
uv sync
Running tests
To run all tests and linters in isolated environments, use tox:
tox
To only run tests, use pytest:
pytest
To format the code, use ruff:
ruff format .
To check for lints with ruff, run:
ruff check .
To check for type errors, use pyright:
pyright .
Making a release
To make a release to PyPI, go to the project's GitHub releases page and click the "Draft a new release" button.
In the "choose a tag" dropdown, select the tag you want to release or create a
new tag, e.g. v0.1.0. Add a title, e.g. v0.1.0, and a description of the changes.
Decide if the release is a pre-release (alpha, beta, or release candidate) or should be marked as the latest release, and click "Publish release".
Once the release is created, the release.yml GitHub Action will automatically
build and publish the release to
PyPI.
Credits
- Original author: Janez Troha
- Current maintainer: None. Maintainer wanted, see section above.
- Contributors
Metadata
Release files for mopidy-soundcloud 4.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mopidy_soundcloud-4.0.0.tar.gz | 410.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mopidy_soundcloud-4.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 423.1 kB
Release files / mopidy_soundcloud-4.0.0.tar.gz
| Download URL | mopidy_soundcloud-4.0.0.tar.gz |
|---|---|
| Size | 410.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
87c1e12fb360e6447aea2164337c3f2b373ef609b66a3b7d772f98a807798b3d
|
|
BLAKE2b-256 checksum How to use checksums |
a8057995f79b98d53bea8a4836d024d78307d234a30ac3ffe7e17d79dc7ffc3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 25, 2026.
Transparency logRelease files / mopidy_soundcloud-4.0.0-py3-none-any.whl
| Download URL | mopidy_soundcloud-4.0.0-py3-none-any.whl |
|---|---|
| Size | 12.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64e29584c5587268e42d0634cbaf4ced8442c81f80b1701b6ce033d49d59d326
|
|
BLAKE2b-256 checksum How to use checksums |
ebd07adcd7a6735563c6425b03456dfc02df63d7057ed2898918d99bcf4761e4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 25, 2026.
Transparency log
