An open API service indexing awesome lists of open source software.

https://github.com/mopidy/mopidy-soundcloud

Mopidy extension for playing music from SoundCloud
https://github.com/mopidy/mopidy-soundcloud

mopidy mopidy-backend python soundcloud

Last synced: 10 months ago
JSON representation

Mopidy extension for playing music from SoundCloud

Awesome Lists containing this project

README

          

*****************
Mopidy-SoundCloud
*****************

.. image:: https://img.shields.io/pypi/v/Mopidy-SoundCloud
:target: https://pypi.org/project/Mopidy-SoundCloud/
:alt: Latest PyPI version

.. image:: https://img.shields.io/github/actions/workflow/status/mopidy/mopidy-soundcloud/ci.yml?branch=main
:target: https://github.com/mopidy/mopidy-soundcloud/actions
:alt: CI build status

.. image:: https://img.shields.io/codecov/c/gh/mopidy/mopidy-soundcloud
:target: https://codecov.io/gh/mopidy/mopidy-soundcloud
:alt: Test coverage

`Mopidy `_ extension for playing music from
`SoundCloud `_.

Status
======

This extension is not currently maintained and may not function correctly / at all.
See below for more details.

Maintainer wanted
=================

Mopidy-SoundCloud is currently not maintained by the Mopidy core
developers. It is in need of a maintainer.

If you want to be the maintainer of Mopidy-SoundCloud, please:

1. Make a good pull request improving a material part of the project.

2. Read and get familiar with all of the project's open issues.

3. 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::

sudo python3 -m pip install Mopidy-SoundCloud

See https://mopidy.com/ext/soundcloud/ for alternative installation methods.

Configuration
=============

#. You must register for a user account at https://soundcloud.com/

#. You need a SoundCloud authentication token for Mopidy from
https://mopidy.com/authenticate

#. 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
=================

- `Source code `_
- `Issue tracker `_
- `Changelog `_

Credits
=======

- Original author: `Janez Troha `_
- Current maintainer: None. Maintainer wanted, see section above.
- `Contributors `_