mopidy-orfradio

Mopidy extension to access the Austrian ORF radio stations. It provides access to the live streams and the 7 day archive.

Note that timestamps from the API are somewhat inaccurate (especially on non-music segments). This can cause a slight glitch between tracks, or in very few extreme cases the beginning getting cut off. The implementation avoids cutting off the end of tracks, with the trade off of sometimes appending a few seconds from the next to the previous.

Installation

Install by running:

python3 -m pip install mopidy-orfradio

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

Configuration

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

[orfradio]

# Stations to display
#
# Default:
stations =
    oe1
    oe3
    fm4
    campus
    bgl
    ktn
    noe
    ooe
    sbg
    stm
    tir
    vbg
    slo

# Remove from list to automatically skip tracks of the type.
#
# Available types: [M]usik, [B]eitrag, [BJ]ournal, [N]achrichten,
# [J]ingle, [W]erbung, [S]onstiges
#
# Default:
archive_types =
    M
    B
    BJ
    N

# Live stream is available as 128 or 192 kbit/s. The archive always plays
# at 192 kbit/s.
#
# Default:
livestream_bitrate = 192

Project resources

• Source code
• Issues
• Releases

Development

Set up development environment

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

gh repo clone mopidy/mopidy-orfradio

Enter the directory, and install dependencies using uv:

cd mopidy-orfradio/
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: Tobias Girstmair, David Tischler
• Current maintainer: Tobias Girstmair
• Contributors