An alternative infrastructure-service for legacy NOXON(tm) devices
Project description
xonox
An alternative infrastructure-service for legacy NOXON(tm) devices.
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'
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.
Missing Features
xonox
is far way from completeness. These things are missing so far:
- Playlist support
- A GUI to manage the station list
- Support favorites/presets
Changelog
0.0.5 (Work in Progress)
- 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) 2022 TillW - Licensed to you under the AGPL v3.0
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.