xonox 1.1.0

An alternative infrastructure-service for legacy NOXON(tm) devices

xonox

An alternative infrastructure-service for legacy NOXON(tm) devices.

Prerequisites

You need a device that is always-on, reachable by your radios and capable to run Python-scripts. Additionally, you need to redirect DNS entries to the device that runs xonox.

Compatible Devices

The following devices were reported as compatible:

• Noxon(tm) iRadio 300/360
• Noxon(tm) iRadio 400
• Noxon(tm) iRadio (no support for podcasts or favorites)
• Noxon(tm) 2 Audio (no support for podcasts or favorites)

Getting Started

Installation

Install the module and all of its dependencies via pip:

pip install xonox

Start Service

If you want xonox to listen on all bound IP-addresses:

python -m xonox

If you want xonox to listen only on a single IP-address you can use the --host parameter to specify it.

python -m xonox --host 192.168.3.3

Configure Your Environment

The NOXON(tm) devices locate their services via DNS. To allow them to find the alternative service, you need to configure your local DNS so that the following names point to the host that runs xonox.

• legacy.noxonserver.eu
• gate1.noxonserver.eu

Manage Your Station List

Add Stations

You can add stations to xonox by POSTing its metadata to the /station endpoint.

curl --location --request POST 'http://legacy.noxonserver.eu/station' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Radio Swiss Pop",
    "description": "Radio Swiss Pop Live Stream",
    "streamUrl": "http://stream.srg-ssr.ch/m/rsp/mp3_128"
}'

Please note that streamUrl needs to point to the MP3 stream and not to a playlist (M3U). If you don't know how to get this information for your favorite station, have a look at station list of the RadioBrowser project. Remember that the Noxon(tm) iRadios do not support HTTPS. Therefore you need to supply an HTTP-URL.

Get the List

curl --location --request GET 'http://legacy.noxonserver.eu/station'

Remove a Station

curl --location --request DELETE 'http://legacy.noxonserver.eu/station/0'

Bookmark/Preset/Favorite Support

Since version 0.0.7.2 xonox supports the preset-buttons of the iRadios. Due to technical challenges (see this comment) only one preset-list is created for all devices by default. This means that a created preset is available on all devices which are connected to the same server. Separate preset-lists per device are supported experimentally. If you want to try it, you can find more information in the 'Experimental Features' section later in this document.

Configuration File

By default, xonox writes its configuration and station-list to a file called xonox.conf inside the user's home directory. If this causes problems on your system, you can specify the storage directory using the --config-dir parameter.

Experimental Features

Per-Device Bookmarks/Favorites/Presets

You can disable the global preset-list by setting the property useGlobalPresetList to false:

curl --location --request POST 'http://legacy.noxonserver.eu/settings' \
--header 'Content-Type: application/json' \
--data-raw '{ "useGlobalPresetList": false }'

If you find want to re-enable the global preset list, set useGlobalPresetList to true.

Development

Poetry is used to build and package this project:

# install dependencies
poetry install
# run tests
poetry run pytest
# run xonox
poetry run python -m xonox
# create package
poetry build

Changelog

1.1.0

• Add support for Noxon(tm) 2 Audio and Noxon iRadio #13

1.0.1

• Fixed Management API: Get station and station-list does not work

1.0.0

• Use semantic versioning
• Added compatibility with Flask >= 2.3.0
• Use Poetry for building and packaging the project

0.0.7.2

• Added support for preset-buttons
• Order stations alphabetically

0.0.6

• Fixed Management API does not return JSON
• Fixed Non-unique station-IDs

0.0.5

• BREAKING CHANGE If the service shall bound to a specific ip-address, it must be provided via --host and not the positional parameter like in previous versions.
• Added possibility to configure the location of xonox.config via command-line parameter --config-dir.
• Fixed 'config not found'

0.0.4 (Withdrawn)

• Added persistence of the station list.

0.0.3

• First publicly available release

(c) 2024 TillW - Licensed to you under the AGPL v3.0