Radio Live Lyrics – WordPress Free
Version 1.0.0

WHAT IT DOES
- Reads Now Playing, Coming Up Next, playback position and duration from the RadioBOSS HTTP API (playbackinfo).
- Shows a dedicated live-stream player with Play, Stop, Mute and Volume.
- Looks up synced lyrics through LRCLIB when no local lyrics file exists.
- Falls back to plain lyrics when enabled.
- Stores successful LRCLIB results locally so the same song does not need to be fetched again.
- Supports manual .lrc and .txt uploads that take priority over automatic results.
- Shows a configurable background image and accent colors.
- Uses RadioBOSS CASTTITLE for non-music scheduler/teaser items so broadcast-facing task names can be shown instead of internal payloads.
- Keeps the RadioBOSS API password server-side.

INSTALLATION
1. WordPress > Plugins > Add Plugin > Upload Plugin.
2. Upload this ZIP and activate Radio Live Lyrics – Free.
3. Open Settings > Radio Live Lyrics.
4. Enter your station name, RadioBOSS API URL/password and public stream URL.
5. Create a WordPress page and add this shortcode:
   [radio_live_lyrics]

RADIOBOSS
Use the RadioBOSS HTTP API address and port that are reachable from your WordPress server. Enter the base URL only; do not append action=playbackinfo or the password.

LYRICS
Local .lrc and .txt files have first priority. Automatic LRCLIB results are cached locally. Successful lyrics remain cached until the automatic cache is cleared; negative results expire after the configured time.

SYNC
Start with a lyrics offset of 0.0 seconds. Positive values move lyrics forward; negative values delay them.

PRIVACY / SECURITY
The RadioBOSS API password is stored in the WordPress options database and is used only by server-side PHP requests. It is not sent to visitors by the plugin.

COPYRIGHT NOTE
Lyrics are copyrighted works. Availability through an API or local file does not by itself grant public-display rights. The station/operator is responsible for checking the licensing and rights requirements that apply to its use and jurisdiction.

REQUIREMENTS
- WordPress 6.x recommended
- PHP 7.4+ recommended
- PHP SimpleXML
- Outbound HTTPS access to LRCLIB for automatic lookup
- RadioBOSS HTTP API reachable from the WordPress server

LICENSE
GPL-2.0-or-later for the plugin code. Third-party services and lyric content remain subject to their own terms and rights.
