4 Push your own content onto `Noxon iRadio`__ devices:
5 RSS feeds, text files and MediaTomb server structures.
7 This tool makes it possible to push own data into the menu
8 entries "Internet Radio", "Podcasts" and "My Noxon" without relying
9 on the official Terratec servers.
11 __ http://www.noxonradio.de/
20 - Customize the Noxon iRadio menus "Internet Radio", "Podcasts" and "My Noxon"
21 - Show Mediatomb UPnP server content in "Internet Radio", so that you
22 don't have to restart your iRadio because it does not find the UPnP server
23 after a day of standby
24 - Display text files and run shell scripts from the menu (home automation)
25 - Podcast RSS feed support
26 - Discoverable with your web browser
27 - Transcoding of non-mp3 file types to ``.mp3`` that iRadios can play
28 - Single file mode for children that want to listen to a single story
34 Simpy write a podcast's mp3 RSS feed URL into a ``.url`` file in
35 the ``var/`` directory structure, and your radio will show you a
36 folder with all episodes.
37 Enter an episode to play it.
39 The Noxon iRadios do only allow a single HTTP redirect when they access a URL
40 to play, but many podcast feeds send you for tracking purposes through 3 or
41 more redirects until you reach the final mp3 URL.
43 noxon-gateway resolves the redirections for the iRadio, so that this will
49 You have to know the URL to the podcast's mp3 RSS feed, e.g.
50 ``http://cast.example.org/news.rss``.
52 Create a file ``Cast News.url`` in ``var/podcasts/`` and write the RSS URL
56 When accessing the "Podcasts" menu from your noxon iRadio, you'll see a
57 directory ``Cast News`` that contains all podcast episodes.
62 Your kid only wants to listen to this one single story before sleeping.
63 You start it, set the 15 minute sleep timer and leave the room.
65 After 15 minutes the child comes out and complains that the radio switched
66 off within the second story and it wants to hear it to the end.
68 To get around such issues, you can enable "single file directories"
71 Each folder with audio files within this configured paths have a special
72 directory "Einzeln" (single), which have separate folders for each audio
73 file. Each of this separate folders only have the single audio file in them.
75 When playing this file, the iRadio will stop playing after the one file
81 This is the list of iRadios known to work with ``noxon-gateway``:
83 - `Noxon iRadio`__ (original white version)
84 - `Noxon iRadio cube`__
87 If you know of unlisted radios that do work with this tool, please tell me.
89 __ http://ftp.noxonradio.de/index.php?dir=NOXON%2FNOXON_iRadio%2F
90 __ http://ftp.noxonradio.de/index.php?dir=NOXON%2FNOXON_iRadio_Cube%2F
95 You can discover the noxon-gateway contents with your web browser.
96 Point your browser to the gateway's domain and start browsing:
98 .. image:: docs/screenshots/browsing.png
100 This works because the XML files delivered by noxon-gateway contain the
101 link to an XSLT__ file that converts the XML structure to HTML that
104 Works at least with Firefox 42 and Chromium 45.
106 __ http://www.w3.org/TR/xslt
109 ===================================
110 Customizing the directory structure
111 ===================================
112 The ``var/`` directory contains three directories you can fill with
115 ================ ==================
116 Menu item ``var/`` Directory
117 ================ ==================
118 Internet Radio ``internetradio``
119 Podcasts ``podcasts``
121 ================ ==================
123 You can put folders and files into this directories.
125 The ``internetradio`` directory is hard-coded to display the contents
126 of a MediaTomb UPnP server.
127 You can remove the check in ``index.php#handleRequest()`` if you do not
134 A directory is browsable by your Noxon radio
136 Text files are rendered as un-actionable lists, one list item per line.
138 Empty lines get removed, consecutive spaces get collapsed.
140 Podcast feed URL file.
142 Simply contains the URL to the podcast's MP3 RSS feed.
144 Script is shown as directory and gets executed when navigating
146 Output is shown as it is for ``.txt`` files.
148 I use it to control my house's heating system from the radio.
149 ``*.auto*`` (executable)
150 Script gets executed when browsing the folder.
151 The output is integrated into the directory listing with the same
152 rules as for ``.txt`` files.
154 You can use this to show the current time within the directory listing.
156 File extensions get removed for display purposes.
161 Files and directory are sorted alphabetically and get listed
164 You can prefix your files and directories with ``[0-9]+_``,
165 which lets you influence sorting and gets removed in the
168 Consider the following files::
180 (given that ``01_temp.auto.sh`` outputs the temperature string)
189 The following hosts must point to your server and be handled
194 gatekeeper.my-noxon.net
197 Configure this in your router or the DNS server your iRadio devices use.
202 To be able to browse a MediaTomb server, copy ``data/config.php.dist`` to
203 ``data/config.php`` and fill it with mediatomb web interface credentials.
205 You also have to install the `Services_Mediatomb`__ library via `PEAR`__::
207 $ pear channel-discover zustellzentrum.cweiske.de
208 $ pear install zz/services_mediatomb-alpha
210 __ http://zustellzentrum.cweiske.de/index.php?package=Services_MediaTomb
211 __ http://pear.php.net/
216 If you have non-mp3 files in your audio collection, install `ffmpeg`__
217 on the noxon-gateway server.
218 Transcoding will start automatically when the player accesses a file
219 that is not in ``audio/mpeg`` format.
221 __ http://ffmpeg.org/
230 The source code is available at http://git.cweiske.de/noxon-gateway.git/
231 and mirrored at https://github.com/cweiske/noxon-gateway.
236 This application is available under the `AGPL v3`__ or later.
238 __ http://www.gnu.org/licenses/agpl.html
243 Written by `Christian Weiske`__, cweiske@cweiske.de
245 __ http://cweiske.de/