Description
Radio 42 Control Center drives a radio server deployed with the Radio 42 Server playbook (Icecast + Liquidsoap + a small control API, all in Docker). It is the companion of the Simple Radio Forty Two player: the player is what your listeners use, the control center is what you use.
What you can do from the WordPress admin
- See what is on air: title, artist, cover, number of listeners.
- Know instantly whether the playlist is running or a host is live.
- Skip to the next track.
- Queue a sound to play right after the current track (jingles, announcements, requests).
- Upload sounds (several at once) and an optional cover for each, browse and search the library.
- Remove a sound from the playlist without deleting it, and put it back later. Delete it for good only when you want to.
- Get the exact settings a host needs to go live from BUTT or Mixxx (audio).
Recommended player: Simple Radio Forty Two
To let your visitors listen, use the free Simple Radio Forty Two plugin: add your stream URL as a station and put [sr42_radio] on a page. It shows the now-playing title and, since version 2.3, can switch between audio and video if your server has the video option on. Any Icecast-compatible player works too.
How it works
The plugin never exposes your server token to the browser. Every action goes through your WordPress server, which calls the radio API. The token is stored in the database (or in wp-config.php) and is never printed in a page.
A host who connects to the live port takes the air immediately, over the playlist; when they disconnect, the playlist resumes by itself.
Requirements
A running Radio 42 server (see the playbook repository) and its API URL and token.
Docs: docs/USER-GUIDE.md (English) and docs/MODE-DEMPLOI.md (French).
Installation
- Install and activate the plugin.
- Open Radio 42 Settings, enter the API URL (for example
https://radio.example.com:5000) and the API token chosen when you installed the server. - Click Test the saved connection.
- Open Radio 42 Control room.
Optionally, pin the connection in wp-config.php:
define( 'R42CC_API_URL', 'https://radio.example.com:5000' );
define( 'R42CC_API_TOKEN', 'your-token' );
FAQ
-
Does it work with any Icecast server?
-
No. It talks to the Radio 42 control API, which is installed by the Radio 42 Server playbook. Listeners can still use any Icecast-compatible player.
-
Who can use the control room?
-
Users with the
manage_optionscapability (administrators). Change it with ther42cc_capabilityfilter. -
Why are listeners delayed when a host speaks?
-
Icecast buffers the stream: expect 10 to 15 seconds between the host and the listeners.
-
What is the difference between “Remove from playlist” and “Delete”?
-
Removing a sound keeps the file on the server in a separate folder: it is never played, and you can put it back with one click. Delete erases it for good.
-
Can I remove a sound from the queue?
-
Not in this version: the broadcast engine can add to the queue but not edit it. Use “Next track” instead.
-
Which player should my visitors use?
-
Simple Radio Forty Two is the companion player (it reads the same stream and now-playing data). Any player that understands an Icecast stream also works.
-
Can the API be on another machine than WordPress?
-
Yes. Put it behind HTTPS (a reverse proxy) so the token does not travel in clear text.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Radio 42 Control Center” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Radio 42 Control Center” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.2.0
- Remove a sound from the playlist (kept on the server) and put it back; new “Removed from the playlist” section.
- Needs Radio 42 Server 2.1.0 or later.
- Docs:
docs/USER-GUIDE.md(English) anddocs/MODE-DEMPLOI.md(French).
0.1.0
- First release: on-air status, live indicator, skip, queue, library with upload and covers, host connection settings.