RPh Livecaster v1.0 — User Manual

Live AAC+ Audio Encoder for Icecast v2

Designed and optimized exclusively for Icecast v2 servers.


Table of Contents

  1. Overview
  2. System Requirements
  3. Installation & First Launch
    1. Windows SmartScreen Warning
  4. License Activation
    1. Entering a License Key
    2. Free Trial
    3. Offline Grace Period
    4. License Errors
  5. Main Window
    1. Title Bar
    2. Status LEDs (Internet / Encoder / Audio)
    3. Stereo VU Meter
    4. Info Panel (Quality, Server, Input)
    5. Stream Info
    6. Control Buttons
  6. Settings
    1. System Tab
    2. Server Tab
    3. Audio Tab (Encoder)
    4. DSP Tab (Audio Processing)
    5. About Tab
  7. Audio Processing Chain (DSP)
    1. Signal Flow Diagram
    2. Stage Reference
    3. DSP LED Meters
  8. Encoding & Streaming
    1. Codec Selection (Automatic)
    2. Starting a Stream
    3. Stopping a Stream
    4. Auto-Reconnect
    5. Buffering
  9. LED Reference Guide
    1. Main Window Status LEDs
    2. Server Tab LEDs
    3. Audio Tab VU LEDs
    4. DSP Tab Activity LEDs
  10. Error Messages & Troubleshooting
  11. Keyboard Shortcuts & Behavior
  12. Configuration File
  13. Portable Deployment

1. Overview

RPh Livecaster is a lightweight, professional-grade live audio encoder designed exclusively for Icecast v2 streaming servers. It captures audio from any Windows input device, applies an optional multi-stage DSP processing chain, encodes it as AAC+ (HE-AAC v1 / HE-AAC v2) or AAC-LC, and transmits it to your Icecast server in real time.

Key Features

2. System Requirements

RequirementMinimum
OSWindows 7 SP1 through Windows 11
CPUAny x64 processor (very low CPU usage)
RAM< 20 MB
Disk< 5 MB (portable)
AudioAny Windows audio input device
NetworkInternet connection for streaming
RuntimeVisual C++ Redistributable 2022

3. Installation & First Launch

RPh Livecaster is a portable, self-contained application — no installer required. The AAC encoding library is built into the executable.

Important: Only download RPhLivecaster.exe from the official source: https://download.radyoph.com. Do not trust copies obtained from any other website or third party.
  1. Copy RPhLivecaster.exe to any folder on your PC.
  2. Double-click RPhLivecaster.exe to launch.
  3. On first launch, the License Activation dialog appears.
  4. A config.dat file is automatically created in the same folder to store your settings.
Note: Only one instance of RPh Livecaster can run at a time. Attempting to launch a second instance will bring the existing window to the foreground.

Windows SmartScreen Warning (First Launch Only)

On the very first launch, Windows may display a SmartScreen warning that reads "Windows protected your PC" or "The app is not commonly downloaded and could be unsafe." This is normal and expected — here is why:

To proceed past the warning:

  1. Click "More info" (the text link below the warning message).
  2. Click "Run anyway".

This warning will only appear once. After you run the application the first time, Windows remembers your choice and will not prompt you again on subsequent launches.

4. License Activation

RPh Livecaster requires a valid license to operate. The license is validated against the lic.radyoph.com license server.

4.1 Entering a License Key

  1. At the activation dialog, enter your license key in the format XXXXX-XXXXX-XXXXX-XXXXX.
  2. Click Activate.
  3. The app verifies the key with the license server.
  4. On success, the app displays "Licensed to: [Your Name]" and launches automatically.

The license is bound to your machine (via Windows Machine GUID) to prevent unauthorized sharing.

4.2 Free Trial

  1. Click Start Free Trial at the activation dialog.
  2. Fill in your Full Name and Email Address.
  3. Click Start Free Trial again to submit.
  4. The request is sent to the license server for approval.
  5. If auto-approved, the app activates immediately with a trial license.
  6. If the server emails you a license key instead, the dialog will switch back to the key input view with the message: "Success! License key sent to [your email]. Check your inbox (and spam folder), then paste the key above." Enter the key and click Activate.

4.3 Offline Grace Period

After a successful validation, the license is cached locally (encrypted with Windows DPAPI in the registry). If your machine goes offline:

4.4 License Errors

Error MessageCauseFix
"Could not reach the license server."No internet or server downCheck your internet connection and try again
"License has expired."License validity period endedContact XciteMediaWorX to renew
"License is suspended."Admin suspended your licenseContact XciteMediaWorX support
"License has been revoked."License permanently revokedContact XciteMediaWorX for a new key
"Device limit exceeded."Too many machines using this keyDeactivate other devices or contact support
"An active license already exists for this email."Email already has a trialUse the license key that was emailed to you
"Free trial already used on this device."This PC already had a trialPurchase a full license
"Full name and email are required."Empty trial form fieldsFill in both fields

5. Main Window

The main window is a compact, dark-themed interface displaying all essential streaming information at a glance.

5.1 Title Bar

Exit Confirmation Dialog:
When you click the close button, a themed dialog appears asking "What would you like to do?" with two options:

5.2 Status LEDs (Internet / Encoder / Audio)

Three circular LED indicators in the upper area, each alternating between showing its status color and a text label every 2 seconds (staggered timing so they don't all change at once):

LEDLabel Green Yellow Orange Red Grey
LED 1InternetStable connectionNo internetChecking…
LED 2EncoderStreamingBuffering / reconnectingError or disconnectedIdle (not started)
LED 3AudioQuiet (-24 to -12 dBFS)Good (-12 to -3 dBFS)Excellent (-3 to -0.5 dBFS)Overmod (> -0.5 dBFS)Mute (< -24 dBFS)

The staggered cycle ensures only one LED transitions at a time, preventing visual chaos. The hold time is 3 seconds — brief status spikes are held to prevent rapid flickering.

5.3 Stereo VU Meter (LED Visualizer)

A professional-grade stereo LED VU meter with two rows of 31 LEDs each (Left and Right channels):

The meter uses true RMS metering with quarter-power scaling for wide dynamic range. Unlit LEDs show a dark-tinted version of their color (not black), mimicking real hardware LED meters.

The visualizer reflects the post-DSP audio level from the assigned input device, including any active processing stages.

5.4 Info Panel (Quality, Server, Input)

FieldDescriptionExample
Quality:Current codec and bitrateHE-AAC v1 @ 64 kbps
Server:Icecast server addresssound.amfm.link:8015/xfm
Input:Selected audio input deviceLine 1 (Breakaway Pipeline)

5.5 Stream Info

FieldDescriptionExample
Name:Stream name from Icecast serverXFM Roxas
Title:Current metadata / song titleArtist - Song Title
Listeners:Current listener count42
Start:Encoder start timestamp2026.03.04.10:30:00
Elapsed:Time since encoding started01:23:45
Data:Total data transmitted12.5 MB

The Name, Title, and Listeners fields are fetched from the Icecast server's status endpoint automatically (derived from your server address with port offset −5).

5.6 Control Buttons

ButtonStateColorIconAction
StartIdleGreyClick to begin encoding
OnlineConnectedGreenWi-FiActive stream indicator
OfflineDisconnectedRedWi-Fi crossedConnection lost
ReconnectingAuto-reconnectOrangePlug disconnectedAlternates with "Disconnected"
StopAlways visibleDarkStops encoding
SettingsAlways visibleDarkOpens Settings
Important: Clicking Settings while encoding is active shows a toast popup: "Stop encoding before changing settings." It auto-dismisses after 2 seconds.

6. Settings

The Settings window opens as a separate window locked on top of the main window — if you drag Settings, the main window moves with it. Settings has five tabs: System, Server, Audio, DSP, and About.

6.1 System Tab

Two-column layout of toggle switches:

Left ColumnRight Column
Start with Windows — Launch on startupEncode on launch — Auto-start encoding
Start minimized — Launch to taskbar/trayAuto reconnect — Infinite retry on disconnect
Minimize to tray — System tray instead of taskbar

6.2 Server Tab

Icecast v2 server configuration. Header: "Icecast v2 server configuration required."

FieldDescriptionPlaceholderLED
Address:Server in host:port/mountput.domain.here:port/mount Reachable   Unreachable   Empty
Password:Source passwordthe_password_here Accepted   Rejected   Empty
Metadata:Stream titlePersonalize Your Stream Title Here Has content   Empty

How validation works: Each field has a small LED to its right that validates in real-time as you type — no "Test" button needed.

Interpreting LED combinations:

AddressPasswordMeaning
Green GreenReady to stream — server reachable, credentials correct
Green RedServer reachable but wrong password
Green GreyServer reachable, no password entered yet
Red GreyServer unreachable or bad address format
Grey GreyNo address entered

The eye button (●) next to the password field toggles visibility.

Note: Icecast v2 does not require a username. The username source is used automatically.

6.3 Audio Tab (Encoder)

Configures the encoder and audio devices.

Codec / Sample Rate (automatic — displayed at top):

Bitrate RangeCodecSample Rate
16–32 kbpsHE-AAC v2 (aacPlus v2)32,000 Hz (forced)
40–48 kbpsHE-AAC v2 (aacPlus v2)44,100 Hz
64–96 kbpsHE-AAC v1 (aacPlus)Match input
128–192 kbpsAAC-LC (Standard AAC)Match input

Controls:

ControlDescription
Bitrate (dropdown)16, 24, 32, 40, 48, 64, 80, 96, 128, 160, 192 kbps
Stereo/Mono (dropdown)Stereo or Mono output
Listen (toggle)Real-time audio preview through an output device
Input (dropdown)Select audio input device
Output (dropdown)Select output device for Listen preview

Input / Output VU LEDs: Each dropdown has a strip of 9 small LEDs to its right showing signal level (green → yellow → orange → red).

Interactive Device Switching: Changing Input or Output takes effect immediately — no need to click OK.

Persistent Device Binding: RPh Livecaster remembers devices by Windows endpoint ID. Plugging/unplugging other USB devices will not change your selected input.

6.4 DSP Tab (Audio Processing)

10-stage audio processing chain with toggle switches, sliders, and real-time LED meters.

ToggleFunctionParameters
HPFHigh-Pass Filter — removes rumble below 70 HzFixed (2nd-order Butterworth)
GateNoise Gate — silences audio below −50 dBFSFixed (−50 dBFS, ~50ms ramp)
GainPre-amplifier−24 dB to +24 dB (slider)
AGCAutomatic Gain ControlSpeed: 1.0s (fast) to 5.0s (slow)
CompCompressorSpeed: 50ms (tight) to 300ms (soft), Threshold, Ratio, Makeup
Boost+1.5 dB output compensatorFixed
BassLow-shelf EQ @ 100 Hz, +3 dBFixed
WidthStereo Width enhancerFixed (mono below ~200 Hz)
OptCodec Camouflage — minimizes codec artifactsAuto-tuned to bitrate/codec
LimitPeak Limiter @ −1.0 dBFSFixed (no user control)

LED Status Indicators — two rows of 5 LEDs at the top of the DSP tab:

12345
Row 1HPFGateGainAGCComp
Row 2BoostBassWidthOptLimit

6.5 About Tab

7. Audio Processing Chain (DSP)

7.1 Signal Flow Diagram

Audio Input
    │
    ▼
┌─────────────┐
│ 1. HPF      │  High-Pass Filter @ 70 Hz (rumble cut)
└──────┬──────┘
       ▼
┌─────────────┐
│ 2. Gate     │  Noise Gate @ −50 dBFS
└──────┬──────┘
       ▼
┌─────────────┐
│ 3. Gain     │  Pre-amplifier (−24 to +24 dB)
└──────┬──────┘
       ▼
┌─────────────┐
│ 4. AGC      │  Automatic Gain Control (1.0s – 5.0s)
└──────┬──────┘
       ▼
┌─────────────┐
│ 5. Comp     │  Compressor (50ms – 300ms)
└──────┬──────┘
       ▼
┌─────────────┐
│ 6. Boost    │  +1.5 dB compensator
└──────┬──────┘
       ▼
┌─────────────┐
│ 7. Bass     │  Low-shelf EQ @ 100 Hz, +3 dB
└──────┬──────┘
       ▼
┌─────────────┐
│ 8. Width    │  Stereo Width enhancer
└──────┬──────┘
       ▼
┌─────────────┐
│ 9. Opt      │  Codec Camouflage (Preconditioner)
└──────┬──────┘
       ▼
┌─────────────┐
│10. Limit    │  Peak Limiter @ −1.0 dBFS
└──────┬──────┘
       ▼
  AAC Encoder → Icecast Server

7.2 Stage Reference

#StagePurposeWhen to Use
1HPFRemoves subsonic rumble, mic noise, HVAC humAlways recommended for mic inputs
2GateSilences dead air, hiss, room noiseTalk / voice formats
3GainAdjusts input level before processingInput too quiet or too loud
4AGCNormalizes volume across sourcesMusic playout with varying levels
5CompReduces dynamic rangeProfessional broadcast sound
6Boost+1.5 dB post-compression compensatorAfter Comp if output is too quiet
7BassAdds warmth to low endThin-sounding sources
8WidthEnhances stereo, keeps bass monoMusic streaming
9OptCodec Camouflage (adaptive LPF + transient preservation)Recommended for 64 kbps and below
10LimitHard ceiling at −1.0 dBFSHighly recommended — prevents clipping

7.3 DSP LED Meters

All DSP processing runs in the float domain (int16 → float → process → float → int16) to eliminate cumulative quantization noise. The LED meters measure RMS energy at each stage using quarter-power scaling for wide dynamic range visualization.

8. Encoding & Streaming

8.1 Codec Selection (Automatic)

BitrateCodecBest For
16–48 kbpsHE-AAC v2Ultra-low bitrate, speech, limited bandwidth
64–96 kbpsHE-AAC v1Standard internet radio streaming
128–192 kbpsAAC-LCHigh-quality music streaming

The default and recommended setting is 64 kbps HE-AAC v1 (aacPlus) — the industry standard for internet radio.

8.2 Starting a Stream

  1. Configure your server (Settings → Server tab).
  2. Select your audio input device (Settings → Audio tab).
  3. Click [Start] on the main window.
  4. The button changes to [Online] (green, Wi-Fi icon) when connected.
  5. Time, data, and stream info begin updating.

8.3 Stopping a Stream

Click [Stop]. The encoder disconnects and the button returns to [Start].

8.4 Auto-Reconnect

When Auto reconnect is enabled (Settings → System):

8.5 Buffering

RPh Livecaster uses a 5-second thread-safe ring buffer between the encoder and the network transmitter. This absorbs:

If the buffer overflows (outage > 5 seconds), the oldest data is discarded to keep the stream live.

9. LED Reference Guide

9.1 Main Window Status LEDs

LEDLabelColorMeaning
1Internet GreenStable internet connection
RedNo internet connection
GreyChecking connectivity…
2Encoder GreenConnected and streaming
OrangeBuffering or reconnecting
RedDisconnected or error
GreyIdle (not started)
3Audio GreenQuiet audio signal (-24 to -12 dBFS)
YellowGood audio signal (-12 to -3 dBFS)
OrangeExcellent audio signal (-3 to -0.5 dBFS)
RedOvermodulation (above -0.5 dBFS)
GreyMute (below -24 dBFS)

9.2 Server Tab LEDs

Field Green Red Grey
AddressValid syntax + reachableInvalid syntax or unreachableEmpty
PasswordAccepted (HTTP 200)Rejected (HTTP 401/403)Empty or not yet validated
MetadataHas contentEmpty

9.3 Audio Tab VU LEDs

StripPositionMeasures
Input VURight of Input dropdownRaw input level (before all DSP)
Output VURight of Output dropdownProcessed level (after Limiter)

Color zones: Green (0–60%) → Yellow (60–75%) → Orange (75–90%) → Red (90–100%)

9.4 DSP Tab Activity LEDs

LED 1LED 2LED 3LED 4LED 5
Row 1HPFGateGainAGCComp
Row 2BoostBassWidthOptLimit

10. Error Messages & Troubleshooting

Connection Errors

ErrorCauseFix
"Failed to connect to Icecast server"Server unreachable, wrong address, or firewallVerify host:port/mount format; check Server LED; verify server is running; check firewall
"Connection Failed: …"Icecast rejected the requestCheck password, mount point, and server config
"Start Failed: …"Audio device or codec errorCheck input device; try different bitrate; restart app

License Errors

ErrorCauseFix
"A valid license is required to start encoding."License expired or not activatedRestart app to re-activate, or contact support
"Your license is no longer valid."Background revalidation failedCheck internet and restart app

Audio Issues

SymptomCauseFix
No audio in VU meterWrong input deviceChange Input in Settings → Audio
Distorted / clippingInput too hot, no limiterEnable Limit in DSP; reduce Gain
Muffled / underwaterToo much processing at low bitrateDisable unnecessary DSP; enable Opt
Choppy / glitchyCPU overload or buffer underrunClose other apps; check CPU usage
Mono instead of stereoChannels set to MonoChange to Stereo in Settings → Audio

Network Issues

SymptomCauseFix
Encoder LED orange ("Buffering")Packet loss / high latencyCheck internet; 5s buffer absorbs brief outages
Encoder LED red ("Dropped Frames")Extended failure (>5s)Wait for auto-reconnect, or Stop and Start
"Reconnecting in Xs…" loopServer down or offlineVerify server status; check Internet LED

11. Keyboard Shortcuts & Behavior

KeyContextAction
EscapeExit / alert dialogCancel or dismiss
EnterAlert dialogDismiss (OK)
SpaceAlert dialogDismiss (OK)

The Settings window is locked to the main window — dragging Settings moves both windows together.

12. Configuration File

Settings are stored in config.dat (binary/encrypted) in the same folder as the executable. Automatically created on first launch and updated every time you click OK in Settings.

Stored settings:

License data is stored separately in the Windows Registry:
HKCU\Software\RadyoPH\RPhLivecaster
Encrypted with Windows DPAPI — cannot be copied to another machine.

13. Portable Deployment

  1. Pre-configure all settings on your machine.
  2. Click OK in Settings to save to config.dat.
  3. Copy RPhLivecaster.exe and config.dat together to the target machine.
  4. The client just launches RPhLivecaster.exe — all settings are pre-loaded.

With "Encode on launch" and "Start with Windows" enabled, the encoder starts streaming automatically on boot — fully hands-free.

FilePurpose
RPhLivecaster.exeMain application (AAC library built-in)
config.datEncrypted settings (auto-generated, pre-configured for deployment)
Tip: If the target PC has a different audio device, the app falls back to the Windows default input. The client can open Settings → Audio to select the correct device.