An alternative infrastructure-service for legacy NOXON(tm) devices.
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.
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)
Install the module and all of its dependencies via pip:
pip install xonox
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
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
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.
curl --location --request GET 'http://legacy.noxonserver.eu/station'
curl --location --request DELETE 'http://legacy.noxonserver.eu/station/0'
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.
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.
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.
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- Add support for Noxon(tm) 2 Audio and Noxon iRadio #13
- Use semantic versioning
- Added compatibility with Flask >= 2.3.0
- Use Poetry for building and packaging the project
- BREAKING CHANGE If the service shall bound to a specific ip-address, it must be provided via
--hostand not the positional parameter like in previous versions. - Added possibility to configure the location of
xonox.configvia command-line parameter--config-dir. - Fixed 'config not found'
- Added persistence of the station list.
- First publicly available release
(c) 2024 TillW - Licensed to you under the AGPL v3.0