mopidy-somafm

Mopidy extension for SomaFM

Installation

Install by running:

python3 -m pip install mopidy-somafm

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

Configuration

Before starting Mopidy, you must add configuration for mopidy-somafm to your Mopidy configuration file:

[somafm]
encoding = aac
quality = highest

• encoding must be either aac, mp3 or aacp
• quality must be one of highest, fast, slow, firewall

If the preferred quality is not available for a channel, the extension will fallback to fast. And afterwards if the preferred encoding is not available for that quality, it will fallback to using mp3. It seems that all channels support the combination fast + mp3

You can also choose to use the channel DJ as the reported track artist (default behavior)::

[somafm]
dj_as_artist = true

Project resources

• Source code
• Issues
• Releases

Development

Set up development environment

Clone the repo using, e.g. using gh:

gh repo clone AlexandrePTJ/mopidy-somafm

Enter the directory, and install dependencies using uv:

cd mopidy-somafm/
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 .

Setup before first release

Before the first release, you must enable trusted publishing on PyPI so that the release.yml GitHub Action can create the PyPI project and publish releases to PyPI.

When following the instructions linked above, use the following values in the form at PyPI:

• Publisher: GitHub
• PyPI project name: mopidy-somafm
• Owner: AlexandrePTJ
• Repository name: mopidy-somafm
• Workflow name: release.yml
• Environment name: pypi (must match environment name in release.yml)

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: Alexandre Petitjean
• Current maintainer: Alexandre Petitjean
• Contributors