Back to the experienceListening · Unwind
USER GUIDE / 3.0.10

RLPlayer
User Manual

From initial launch to device selection, library management, and acoustic tuning. This manual helps you understand what the player is doing under the hood and diagnose root causes when issues arise. Complete your first playback setup, then explore PCM, DSD, EQ, and room correction chapters as needed.

Applies to Version 3.0.10 · Published November 1, 2026 · Windows Official Release
FROM FIRST LAUNCH TO DAILY USE
01
Setup & First Sound
Extract · Select Device · First Playback
02
Understanding the Signal Chain
Sample Rate · Filtering · Dither
03
DSD & Output
SDM · DoP · ASIO
04
Acoustic Tuning & Diagnostics
EQ · Calibration · Logs
Applicable Version 3.0.10 · Windows Official Release Chapters 22 Chapters + 2 Appendices Navigation Left sidebar table of contents, or tap "Contents" on mobile screens
Table of Contents · 23 Chapters
  1. 00Common Audio Terminology
  2. 01Installation & First Playback
  3. 02Understanding the Interface & Settings
  4. 03Finding Music & Managing Library
  5. 04Playback Queue & My Playlists
  6. 05Understanding Bit-Perfect Passthrough
  7. 06PCM Sample Rates & Three Policies
  8. 07PCM Configuration Examples
  9. 08Filtering, Dither & Protection
  10. 09SDM & DSD Output Settings
  11. 10Playing DSD Files & Selecting Transport
  12. 11Output Devices, Buffers & GPU Acceleration
  13. 12EQ & Headphone Presets
  14. 13Acoustic Calibration & Room Correction
  15. 14Now Playing, Lyrics & Audio Analysis
  16. 15Metadata & AI Music Curation
  17. 16Tag Writeback, Covers & Data Backup
  18. 17Network Streaming, Input & Capture
  19. 18Troubleshooting No Audio & Stuttering
  20. 19Logs, Diagnostics & One-Click Feedback
  21. 20Updates, Backups & Common UI Questions
  22. ACommon Shortcuts & Audio Formats
  23. BData Files & Feedback Channels
What Do You Want to Do?Where to Start
Start listening right awayChapter 1: Installation & First Playback
Preserve raw source samples untouchedChapter 5: Understanding Bit-Perfect Passthrough
Configure upsampling & sample ratesChapters 6–8: PCM & Filtering
Play or output DSD audioChapters 9–10: SDM & DSD Sources
Tune headphone or room acousticsChapters 12–13: EQ & Acoustic Calibration
Find tracks & organize libraryChapter 3: Finding Music & Managing Library
No sound or playback stutteringChapter 18: Troubleshooting No Audio & Stuttering
00

Common Audio Terminology

TermPlain English Explanation
PCMThe standard representation for digital audio. Files like WAV and FLAC typically follow this playback pipeline after decoding.
Sample RateHow many audio samples are captured per second. 44.1 kHz means 44,100 samples every second.
Bit DepthHow many bits of numerical precision represent each sample. Increasing output bit depth cannot recover nuances absent from the original recording.
DSD & SDMDSD is high-frequency 1-bit audio; SDM is the sigma-delta modulation process that converts multi-bit audio into such bitstreams.
BackendThe software pipeline connecting the player to hardware endpoints, such as WASAPI or ASIO.
DoP & NativeTwo transmission methods for DSD. DoP encapsulates DSD inside PCM-style frames, while Native routes directly via dedicated ASIO channels.
DSPDigital Sound Processing, encompassing upsampling, digital volume, EQ, convolution, and more.

Higher sample rates, higher modulator orders, or longer filters do not automatically guarantee better sound. Prioritize hardware compatibility and stable playback before evaluating your listening preferences.

01

Installation & First Playback

Preparing the Official Release

Download the complete win64 ZIP bundle, extract it, and double-click RLPlayer.exe. Keep the accompanying runtimes, WebView2Runtime, decoders, data, and tools intact in the same folder—do not isolate just the executable.

The official release includes built-in web runtimes, FFmpeg decoders, and necessary GPU runtime libraries; no separate ROCm, external codec packs, or development SDKs are required. Ensure your system has functional display and audio drivers; ASIO playback requires the manufacturer's ASIO driver.

Extract the application into a standard user-writable folder, such as an RLPlayer folder on a non-system drive. Settings and caches are written adjacent to the program directory; avoid running directly inside Program Files where administrator write permissions are enforced.

First-Time Playback Checklist

  1. Launch RLPlayer.exe and follow the prompt to add your music directory, or go to Settings → Advanced → Local Music Library to add folders.
  2. Open Settings → Output and select your active DAC, sound card, or audio endpoint. Avoid relying on "Default Device" to guess where sound will play.
  3. Select PCM output. Use WASAPI Shared to coexist with system audio, or WASAPI Exclusive / manufacturer ASIO for direct hardware access.
  4. In Settings → PCM, leave Source Sample Rate (Passthrough) and Prefer Same Family (Default) selected, then click "Save Settings."
  5. Lower the hardware volume on your amplifier, headphone amp, or active speakers first. Navigate to an album in the library and start playback, then gradually increase volume to a comfortable level.
  6. Monitor the bottom playback bar for progress, active output specifications, and status indicators. Open the Signal Path for detailed stage inspection.

Confirming a Successful Launch

The album library displays correctly; the target device appears in the device list; audio plays with advancing progress bars and zero error alerts. Initial indexing of large libraries or remote metadata fetch may take a moment, during which UI browsing remains fully responsive.

During WASAPI Exclusive playback, other system applications cannot output sound to the same device. Clicking × in the window title bar minimizes the app to the system tray; to exit completely, right-click the tray icon and select Exit.

02

Understanding the Interface & Settings

Interface ZoneHow to Use
Left Sidebar NavigationAlbums, Artists, Tracks, Folders, and Streaming help you discover music; Playback Queue, History, Favorites, and My Playlists organize your listening sessions.
Top Search BarQuickly search by album, artist, or track title. Press Ctrl+F to focus the search input instantly.
Main Content ViewDisplays album details, track listings, settings tabs, or the active Now Playing view.
Bottom Playback BarPlay/Pause, Previous/Next, Stop, progress seek bar, volume slider, playback modes, and live status. Click the album cover thumbnail to open the Now Playing view.
Right Drawer PanelInspect the playback queue or lyrics; collapse the drawer to expand the main view.
Signal PathInspect source format, active output format, applied DSP stages, and bit-perfect verdicts. Press hotkey 'i' to open.

Settings Tabs Breakdown

TabPurpose & Configuration
Input / OutputInput handles recording and loopback capture; Output configures playback backend, device, channel mapping, buffer size, and loudness management.
PCM/SDMPCM configures output sample rate, bit depth, and upsampling filters; SDM handles DSD output rates, encapsulation, and modulators.
AdvancedThemes, UI language, GPU acceleration, local library directories, and audio analysis toggles.
EQ / CalibrationEQ handles manual parametric equalization and headphone presets; Calibration manages measurements, microphone calibration files, and external correction filters.
Metadata / StreamingMetadata completion and AI integration; network music servers and UPnP casting.
Diagnostics / About & UpdatesSubmit feedback, preview diagnostic payloads, inspect release versions, and check for updates.

Most settings take effect on the next track playback after clicking "Save Settings." PEQ parameter adjustments apply immediately and auto-save; instant actions like language switching follow page prompts.

03

Finding Music & Managing Library

Albums & Artists

The Album view is ideal for browsing by cover art. Click an album cover to view details, then select "Play Album" or "Add to Queue." "Add to Queue" appends tracks to the end of the current queue without interrupting active playback.

The Artist view displays albums and tracks grouped by musician or ensemble. Covers, artist portraits, and online biographies load asynchronously; temporary missing images never prevent audio playback.

Tracks & Folders

The Track view allows searching, sorting, and context actions. Click "+" in any row to append a track to the queue. Right-click to view details, add to queue, or launch track version comparisons.

The Folder view navigates music by physical file paths on disk. Recently added tracks not yet scanned into the database can be played directly from folders. CUE sheets appear as distinct virtual tracks while pointing to the single underlying audio file.

Adding & Rescanning Folders

  1. Navigate to Settings → Advanced → Local Music Library.
  2. Enter the folder path and click "Add Directory." You can add multiple library locations.
  3. When adding, moving files, or editing ID3 tags, click "Rescan All" to refresh your database.
  4. If tracks fail to appear, verify that the directory exists, network drives are mounted, and files are supported formats.

Favorites & Playback History

Click the heart icon next to any track to add it to "My Favorites." "History" lets you quickly revisit recently played songs; to permanently store custom track sequences, use "My Playlists."

The library database indexes physical file locations. If drive letters change, folders move, or you migrate to a new PC, ensure file paths remain valid and re-add or rescan directories. Backing up the database does not copy physical music files.

04

Playback Queue & My Playlists

The playback queue is an ordered track list with an active playback pointer. Adding, removing, and sorting operate directly on this list. Playlists are saved queues that can be restored at any time.

ActionOperation
Add single trackClick "+" on a track row, or right-click → Add to Queue; the Queue page also features "+ Add Tracks."
Add entire albumAlbum details → Add to Queue. To play the entire album immediately from track one, select Play Album.
Remove a trackClick "×" on the queue item, or right-click → Remove from Queue.
Reorder queueUse the queue sort menu to order by title, artist, album, duration, year, reverse list, or shuffle randomly.
Undo sorting"Undo Sort" appears after sorting; modifying the queue by adding or removing tracks invalidates this undo snapshot.
Clear queueClick Clear Queue and confirm.
Save queue for laterSave as Playlist, provide a name, and access it anytime from "My Playlists" in the left sidebar.

Playback Modes

The bottom playback bar toggles between Stop at End, Loop Album/Queue, Repeat One, and Shuffle. Shuffle Mode and "Shuffle Queue" are distinct: the former selects random playback order, while the latter reorders the physical queue items.

Saving & Restoring Queues

The active queue and saved playlists persist to local storage across application restarts. CUE track start and end boundaries are fully preserved. When backing up application data, retain queue and playlist configurations.

Practice Tip: Add three tracks to the queue, sort them by title, undo the sort, and save them as a test playlist. Confirm that "Queue Order" and "Now Playing Track" are two independent concepts.

05

Understanding Bit-Perfect Passthrough

Bit-perfect playback means audio samples are transmitted without numerical alteration across the specified path. It reflects data integrity, not an aesthetic sound quality score. EQ, volume attenuation, and upsampling are intentional DSP; displaying "Non Bit-Perfect" during their use is the expected behavior.

PCM Bit-Perfect Requires Meeting All Conditions Simultaneously

  • Output sample rate matches source sample rate. Selecting "Source Sample Rate" requests passthrough, but actual delivery depends on hardware clock support.
  • Software volume is set to 0 dB; no active channel trims, delay compensation, channel mixing, routing, or loudness DSP.
  • Dither/noise shaping is set to None, ReplayGain is disabled; no active PEQ, convolution IR, room correction, or pre-attenuation.
  • Output bit depth is greater than or equal to source bit depth. Losslessly zero-padding 16-bit samples into 24-bit words does not degrade precision, whereas truncating 24-bit to 16-bit alters audio data.
  • Use a direct hardware backend. WASAPI Shared routes through the Windows audio engine and cannot guarantee bit-perfect delivery.

Using the One-Click Bit-Perfect Button

Settings → Output → "Switch to Bit-Perfect Passthrough" reconfigures active settings. If volume is not at 0 dB, the app will ask to reset software volume to 0 dB. 0 dB disables software attenuation and can result in significantly louder playback; turn down your hardware amplifier first. Declining volume reset leaves other settings adjusted, but bit-perfect status may not be achieved.

Verify via Status Indicators and Reasons

The bottom status badge and Signal Path distinguish Bit-Perfect, Processed, DSD Passthrough, Lossy Source, and Unconfirmed states. The Signal Path explicitly lists active DSP causes: Resampling, Volume, Dither, Preamp, EQ, etc. Matching input/output formats alone does not prove samples are unmodified.

Lossy files like MP3 and AAC permanently discard audio data during compression. The downstream audio chain cannot reconstruct lost acoustic information into an original lossless recording.

DirectSDM same-rate DSD passthrough requires meeting dedicated DSD conditions. PCM-to-DSD conversion and DSD remodulation alter bitstreams and do not constitute bit-perfect passthrough of raw source samples.

06

PCM Sample Rates & Three Policies

Understanding Two Sample Rate Families

The 44.1 kHz family spans 44.1, 88.2, 176.4, 352.8, and 705.6 kHz; the 48 kHz family spans 48, 96, 192, 384, and 768 kHz. 44.1→176.4 is same-family; 44.1→192 is cross-family. Any change in sample rate constitutes active resampling, even within the same clock family.

PolicyAutomatic Selection BehaviorManually Specified Cross-Family Rate
Prefer Same Family (Default)Automatically selects rates within the source file's clock family; prompts with reasons if no same-family rate exists.Permits explicitly chosen target rates if supported by hardware; clearly indicates active resampling.
Strict Same FamilyEnforces same-family rates exclusively; rejects playback if unavailable.Rejected. Manual settings cannot bypass policy restrictions.
Compatible ResamplingPrioritizes same-family rates; permits cross-family fallback when no same-family rate is available.Validates policy and hardware capabilities before applying target; conversion is explicitly disclosed.

How to Choose Output Sample Rate

OptionTechnical Meaning
Source Sample Rate (Passthrough)Preserves source sample rate whenever possible; subject to hardware capabilities and family policies. Does not independently guarantee bit-perfect delivery.
Auto (Highest by Family Policy)Selects the highest hardware-supported rate permitted by the active family policy.
Follow SystemUses the system audio engine mixer rate as reference, constrained by family policies and hardware validation.
Explicit Target RateE.g., 176400 or 192000 Hz. Represents an intentional manual override, never silently substituted if unsupported.

In Shared mode, Windows may lock the final output to the system mixer rate. RLPlayer verifies this actual hardware rate; if it violates current family policies, playback may be refused. Select a compatible Exclusive rate or switch to Compatible Resampling—silence does not mean the file is corrupted.

07

PCM Configuration Examples

Location: Settings → PCM. The screenshot below shows an authentic window build of the 3.0.9 official release for default PCM layout reference. Operational instructions apply to 3.0.10; this image does not illustrate the new SDM implementation.

RLPlayer 3.0.9 Settings → PCM: Source Sample Rate & Prefer Same Family

Fig. 1 RLPlayer 3.0.9 Source Sample Rate & Prefer Same Family

Three Common Scenarios

ScenarioConfiguration & Assessment
Preserve native 44.1 kHz file rateSource Sample Rate + Prefer Same Family; verify endpoint operates at 44.1 kHz. Confirm volume, dither, and EQ conditions.
Upsample 44.1 kHz to 176.4 kHzSelect 176400 Hz manually, or use Auto Highest on compatible gear. Operates as same-family resampling; not bit-perfect.
Explicitly output 44.1 kHz as 192 kHzPrefer Same Family allows this manual choice; Strict Same Family rejects it. If hardware lacks 192 kHz, select a supported rate.

When troubleshooting, change one setting at a time. Click Save, stop playback, and restart before verifying source vs. output rates in the Signal Path. Restoring defaults reverts to "Source Sample Rate" and "Prefer Same Family," resetting other customizations; note key parameters beforehand.

08

Filtering, Dither & Protection

1x and Nx Classify Filters by Source Sample Rate

1x applies to 44.1 / 48 kHz sources; Nx applies to 88.2 kHz and higher sources. Setting Nx to "Follow 1x" adopts the 1x filter. Selecting higher target rates does not automatically engage Nx filters. When source rate is preserved without resampling, configured filters do not intervene.

Start with Auto and Presets

If uncertain, choose "Auto (Recommended)" with "Follow Preset" phase. Default upsampling selects the optimal matching preset. Long filters require more computation and initialization latency; short filters are ideal for validating hardware and stream stability.

SettingFunction & Recommendations
Linear PhaseEqual delay across all frequencies; impulse response exhibits symmetric ringing before and after the peak.
Minimum PhaseImpulse energy is concentrated up front, eliminating pre-ringing; phase relationships vary across frequency.
Intermediate PhaseBalances characteristics between linear phase and minimum phase.
Prototype TapsFilter length. 0 automatically follows the preset; longer filters increase computational load without guaranteeing preferred sound.
Stopband Attenuation & Transition BandControls out-of-band rejection and transition edge sharpness; 0 uses preset defaults. These are design parameters; actual response depends on length and sample rates.
Two-Stage UpsamplingAutomatically selected based on preset or pipeline; manual toggles override auto behavior. Leave on Auto initially.

Dither & Oversampling Peak Protection

Dither introduces micro-level random noise during quantization to reduce harmonic distortion; noise shaping redistributes quantization noise to less sensitive frequency bands. 'Auto' selects dither based on output bit depth; 'None' disables it. Enabling dither forfeits bit-perfect passthrough.

Oversampling peak protection detects inter-sample peaks exceeding full-scale after interpolation, applying pre-attenuation when necessary. Active pre-attenuation indicates protective headroom management; the Signal Path displays the reason. Never ignore digital clipping simply to keep a bit-perfect badge lit.

When manually overriding phase, length, or transition bands, the original preset's nominal specifications no longer represent the modified filter. Decibel values in the UI reflect algorithmic targets, not DAC dynamic range or subjective quality scores.

09

SDM & DSD Output Settings

SDM converts multi-bit audio into high-frequency 1-bit streams. Playback succeeds only when your DAC, driver, and transport mode natively support the target DSD rate. Seeing DSD1024 in the dropdown does not guarantee your hardware can receive it.

  1. In Settings → Output, select your output device and backend, then set Output Mode to DSD.
  2. Navigate to Settings → SDM to configure target bitrate and encapsulation. Start with lower rates verified to work on your equipment.
  3. Use DoP when converting PCM sources to DSD; verify ASIO support before using Native with DSD sources.
  4. Leave filter and modulation parameters at default values, click Save Settings, and restart playback. Inspect the Signal Path for effective encapsulation, active bitrate, and protection status.
ParameterTechnical Meaning
Oversampling 1x/NxDedicated oversampling filter on the DSD output side. When left empty, follows PCM or the 1x filter above as annotated on the page.
Target BitrateCommon rates: DSD64 / 128 / 256 / 512 / 1024, requiring progressively higher compute power and hardware capabilities.
DoPEncapsulates DSD bitstreams inside PCM frames. DSD64 requires a 176.4 kHz carrier, DSD128 requires 352.8 kHz; higher rates demand higher carrier frequencies.
NativeTransmitted via dedicated ASIO native DSD channels. Driver support is required; WASAPI Shared cannot transport DSD / DoP.
Modulator Family & OrderBalances noise shaping against loop stability. Requested orders and effective safeguarded orders may differ.
Corner Frequency & DitherInfluences noise distribution and idle tones. Use defaults unless you have specific requirements.

Current Safeguards & Operational Scope

  • 1-bit Chebyshev output operates with 5th-order protection; requesting 7th order does not imply effective 7th-order output.
  • Standard DSD and AHM non-EC paths at 45.1584 MHz or 49.152 MHz with default 100 kHz corner frequencies operate at full 7th order when requested, no longer falling back to 5th order. Other corner frequencies and parameters remain constrained by stability guards; do not generalize this across arbitrary configurations.
  • AHM software modulation at 8-bit depth utilizes exactly 256 quantization levels; DoP and ASIO 1-bit transports in this project enforce 2-level quantization with explanatory notes. This does not indicate multi-level hardware output is currently supported.

Effective order, rate, and active processing in the Signal Path reflect true operational states. Protective order reductions do not indicate configuration save errors; real-time hardware acceptance of target DSD rates requires independent verification.

10

Playing DSD Files & Selecting Transport

Three Playback Paths

Your GoalConfiguration & Result
Play DSF / DFF on standard hardwareOutput PCM: Decodes DSD to PCM, then plays via PCM settings. Involves active conversion; not DSD passthrough.
DAC supports DoP with native DSD streamEnable DirectSDM, matching target rate to source rate at 0 dB volume, with zero EQ, convolution, or channel alterations. Bypasses PCM and modulation when conditions are met.
DAC and ASIO driver support Native DSDSelect ASIO + DSD + Native. Source must be DSF / DFF and comply with software DSP bypass limits.

Native is currently utilized for ASIO output of DSF / DFF files. Exact same-rate source and target achieve bit-perfect delivery; supported same-family integer rate conversions apply remodulation, forfeiting bit-level identity. PCM sources requiring DSD output should use DoP.

DSD-to-DSD rate conversion supports only supported same-family integer multipliers; cross-family, non-integer, or non-standard targets are explicitly rejected.

When DirectSDM Fails to Enter Passthrough

Verify source and target DSD bitrates match, software volume is 0 dB, and no EQ, IR, room correction, loudness, or channel processing is active. Failing any condition reverts to standard processing with reasons disclosed; standard paths may involve decoding and remodulation.

When Native DSD Is Unavailable

Confirm the device list selects the correct ASIO driver, and verify the driver's actual DSD capabilities. If the driver rejects Native DSD, the player may attempt DoP fallback if the hardware supports the required carrier. Parameter validation rejections indicate specific error conditions that must be resolved.

DSD to PCM Options

"DSD Source Decimator" includes FIR, IIR, and CIC options; Conversion settings (narrow, wide, XFi) govern retained bandwidth. These apply exclusively to DSD→PCM. Successful DirectSDM passthrough bypasses this decimation chain completely.

DoP must be recognized as DSD by the receiving DAC. Never audition DoP carriers as raw PCM; non-DoP hardware may decode the carrier as loud noise. During same-rate DSD passthrough, control volume safely at the DAC, headphone amp, or preamplifier.

11

Output Devices, Buffers & GPU Acceleration

Choosing Between WASAPI & ASIO

Output ModeUse Cases & Constraints
WASAPI ExclusiveGrants the player exclusive ownership of the audio endpoint. Recommended for bit-perfect and audiophile output; other system sounds are muted during playback.
WASAPI SharedCoexists with browser, calls, and system audio. Final format is subject to the Windows mixer; does not guarantee bit-perfect delivery, and does not support DoP / DSD.
ASIOProfessional low-latency pipeline provided by audio hardware drivers. Verify driver installation and device capabilities; Native DSD requires dedicated driver support.
Null outputExecutes digital DSP without streaming audio to physical hardware. Useful for inspecting signal chains silently, but does not prove hardware sound output.

Buffers, Channels & Signal Levels

Smaller buffers reduce latency between user actions and sound, but increase the risk of buffer underruns. Begin with the default 100 ms for daily listening; try 200 ms if dropouts or clicking occur, and monitor statistics. If hardware throughput is insufficient, merely expanding buffer size will not resolve the issue.

Channel counts must match your audio files, driver capabilities, and physical wiring. Forcing stereo or multichannel can trigger active channel downmixing/upmixing; per-channel volume trims also modify digital samples. Volume ramping softens transitions but does not guarantee immunity from hardware-induced pops.

GPU Location & Status Interpretation

Location: Settings → Advanced → GPU. Options: Auto, AMD, NVIDIA, or Off. The GPU toggle for IR convolution resides on the Acoustic Calibration page. Runtimes are included in the bundle; GPU execution depends on local graphics hardware and driver availability.

GPU availability does not guarantee the active track is using GPU acceleration. A green node in the Signal Path indicates the stage actively executed on the GPU; if upsampling or convolution is inactive, an unlit indicator is normal. Missing backends or launch failures gracefully fall back to CPU.

If ultra-high sample rates or massive filters struggle with stability, reduce target rates or choose shorter filter presets. GPU acceleration applies to specific pipeline stages and cannot guarantee real-time playback across every extreme setting.

12

EQ & Headphone Presets

EQ intentionally reshapes frequency balance, such as taming room modes or adjusting headphone tonality. Each of the 20 PEQ bands offers configurable frequency, gain, Q factor, and filter type; higher Q narrows the affected bandwidth.

Understanding Bypass Semantics

Checking "Bypass" completely removes the PEQ engine from the processing pipeline. Unchecking it enables PEQ, but factory defaults (all 20 bands at 0 dB with 0 dB preamp) do not alter the audio signal. The Signal Path evaluates effective DSP; simply enabling an untouched EQ engine does not alter digital samples.

Manual Tuning Workflow

  1. Begin with subtle adjustments in a single frequency band rather than applying large boosts across multiple bands simultaneously.
  2. Drag filter nodes horizontally to adjust frequency and vertically to adjust gain; Shift + drag or mouse wheel adjusts Q factor. Double-click a node to reset it.
  3. Enter precise values in the parameter table when exact tuning is required. Select a row and use arrow keys for fine adjustments (hold Shift for accelerated steps).
  4. After boosting frequencies, click "Auto Preamp (Prevent Clipping)" to establish necessary headroom against digital clipping, then verify master volume.
  5. Adjustments apply immediately and auto-save; save as custom presets once satisfied. Use Bypass during A/B auditioning while monitoring loudness differences.

Headphone EQ & OPRA Integration

In Settings → EQ → Headphone EQ, search for your specific headphone model, select an author and target curve preset, then apply. Headphones with similar names, different revisions, or varying ear-pad styles should not be assumed identical.

Target curve previews illustrate general acoustic profiles, not laboratory measurements of your personal pair. Database presets offer reliable starting points; ear-pad seal, individual ear anatomy, and personal taste may warrant fine-tuning.

Active EQ alters digital audio samples, forfeiting bit-perfect passthrough. When comparing presets, match overall loudness to avoid mistaking increased loudness for superior sound quality.

13

Acoustic Calibration & Room Correction

Acoustic calibration compensates for playback system anomalies using measurements or external correction filters. Manual headphone EQ resides on the EQ tab; microphone calibration, room measurements, REW / AutoEq text, and WAV IR files reside in Settings → Acoustic Calibration.

Preparing Microphone Calibration

If your measurement microphone includes a factory calibration file, import the corresponding TXT or CSV first. Measurements can proceed without calibration files, but results will incorporate the microphone's native frequency response. Microphone calibration affects only measurement and correction filter synthesis—it does not apply an extra EQ layer during music playback.

Performing Room Acoustic Measurements

  1. Place the measurement microphone at your primary listening position (sweet spot) and select the appropriate input device, speaker outputs, and channel layout. Maintain a quiet environment during measurement.
  2. Open Room Correction → Start Wizard, select your layout, position the microphone, and follow each guided step.
  3. Confirm playback device, sweep duration, and test signal level. Frequency sweeps output audible sound at a default level of −20 dBFS; ensure a safe listening environment, check the acknowledgment box, and proceed.
  4. Avoid playing background audio or generating noise during sweeps; use the wizard's abort button if you need to stop early.
  5. Review the quality check and measured results upon completion to generate a correction profile for your layout. Start playback and inspect the Signal Path to confirm the correction profile is active.

Automatic Correction & External Files

Auto-apply correction is enabled by default, engaging only when a correction profile matches the active output layout. A 2.0 measurement will not be forced onto a 5.1 output. When specifying a custom IR file, the manual file takes precedence.

"Parametric EQ File" accepts Filter text exported from REW / AutoEq; "Impulse Response IR" accepts standard WAV files. These represent distinct correction methodologies and can be populated independently. Avoid stacking multiple correction files without clear purpose to prevent duplicate compensation.

Room correction requires calibrated physical hardware, accurate placement, and reliable acoustic measurements. Completing software computation does not automatically yield acoustic perfection in the room; active correction modifies digital samples and is not bit-perfect.

14

Now Playing, Lyrics & Audio Analysis

Now Playing View

Click the album art in the bottom playback bar to open the Now Playing page, offering a centralized view of format specifications, synchronized lyrics, biographical metadata, and audio analysis. Distinguish source format (native file specs) from output format (actual delivered audio).

AI metadata loads asynchronously in the background; the page displays cover art and track details immediately while biographies stream in. "Curating..." does not mean audio playback is waiting for AI.

Lyrics

Lyrics can be viewed in the right drawer and the Now Playing view. Timed lyrics scroll in sync with playback; manual scrolling temporarily detaches auto-follow before smoothly resuming. Missing lyrics, unindexed lyrics, and identified instrumentals represent distinct statuses. Online query results may occasionally mismatch release versions and cannot guarantee 100% accuracy.

Interpreting Analysis Results

Analysis MetricDiagnostic Value
Dynamics & LoudnessInspect dynamic range and integrated LUFS to understand overall mastering loudness and compression. Different musical genres should not be ranked solely by a single number.
Peaks & ClippingDetects indicators where audio or processing approaches full scale; does not evaluate physical speaker distortion.
Effective Bit Depth & NoiseCharacterizes the analyzed digital audio stream; does not prove the end-to-end recording chain quality.
Lossy Transcoding CluesSharp high-frequency cutoff or brickwall roll-off provides clues for further verification, but a single metric cannot definitively determine file provenance.

Two Tiers of Analysis Switches

Disabling the master switch in Settings → Advanced → Audio Analysis hides the analysis card and entries on the Now Playing view. Disabling only "Auto Analysis on Playback" allows manual on-demand analysis on the Now Playing view. Results are cached; auto analysis runs exclusively on local tracks, bypassing streaming, network shares, and Audio CDs.

Audio analysis is strictly read-only and requires no audible test tones. It provides diagnostic insights into file characteristics, not an automated verdict on album quality or sound fidelity.

15

Metadata & AI Music Curation

Metadata comprises "data about music": track titles, artists, albums, release years, cover art, and more. Local tags, public online databases, and AI curation represent distinct sources; online searches may occasionally confuse identically titled tracks.

Auto-Completion vs. AI Enrichment

Output ModeRequirements & Purpose
Auto-CompletionUses enabled public databases to fetch tags and artwork. Requires internet access, but does not invoke AI models.
AI EnrichmentUses configured LLM models to research and synthesize background context. Requires a valid API key, active connection, and account credits.
Local PlaybackDecoding and sound processing execute entirely locally; offline music plays seamlessly even when AI services are unreachable.

Configuring AI Integration

  1. Go to Settings → Metadata, enable Auto-Completion and AI Enrichment as desired, and expand Advanced Options.
  2. Paste your API key in the DeepSeek section, click "Save Key," then click "Test Connection." The UI displays a masked key string and never echoes plaintext.
  3. Click "Refresh Model List" to select models available on your account. If the list cannot be retrieved, enter the correct model ID manually as prompted.
  4. Reopen a track or album page to observe curation progress and error hints. Repeated views serve cached metadata without making redundant network calls.

Cost & Metadata Reliability

AI API calls may incur charges according to your provider's pricing tier. Model selections for curation and search/fetch tools serve distinct tasks; refer to UI hints and token usage records.

Distinguish between citations, external web links, and "AI Knowledge." Content labeled as model knowledge has not been verified against external web pages; verify track titles, tracklists, and durations when auditing release dates or authorship.

Online curation transmits track titles and album names required for queries to your configured provider. Your API key is stored securely in local app configuration—never share, screenshot, or distribute it.

16

Tag Writeback, Covers & Data Backup

Tag Writeback Modifies Metadata Inside Audio Files

The tag writeback feature in Settings → Metadata embeds fetched tags and album covers directly into audio files. This is enabled by default, offering "Preview Writeback" and "Execute Writeback." File verification and original backups safeguard your files, but independent backups remain strongly advised before batch operations.

  1. Run "Preview Writeback" on a familiar album first to verify track titles, artists, album names, and cover art.
  2. Confirm results are accurate before executing writeback; never treat unverified AI metadata as authoritative tags.
  3. If files are read-only, stored on disconnected network shares, or lack write permissions, resolve access permissions first.
  4. Rescan your library if necessary after completion. Original file backups are preserved in the metadata backup directory.

When Covers or Artist Portraits Are Missing

Check whether the audio file has embedded artwork, or if standard cover files (cover.jpg, folder.jpg, front.jpg) exist in the album folder, then check online metadata settings and network access. Manually assigning album artwork is best for correcting specific albums; avoid wiping all local databases for a single missing image.

What to Back Up

Data ItemBackup Considerations
Music FilesLibrary indexes cannot substitute for audio file backups. When tag writeback is executed, the audio files themselves are modified.
Settings & QueuePreserves configuration, music folder directories, active queue, saved playlists, and favorites.
Data Directory & CacheHouses the library database index, room correction profiles, and image caches; backing up the entire directory best preserves all relationships.
AI & Server ConfigurationsMay contain API keys, usernames, or passwords. Safeguard your personal migration backups, and never include them in public feedback.

When migrating to a new computer, drive letters, audio devices, and ASIO drivers often differ. Verify output devices and music folder paths before initiating playback.

17

Network Streaming, Input & Capture

Accessing Music from Your Personal Server

Settings → Streaming allows adding Navidrome / Subsonic or Emby servers. Enter the server URL (with http:// or https://), username, and password, then save and test the connection. You can store multiple servers, with one active at a time; your machine must have network access to the server.

Streaming to UPnP or DLNA Devices

  1. Ensure your PC and digital streamer, active speaker, or smart TV share the same local area network and that UPnP / DLNA MediaRenderer functionality is enabled on the target device.
  2. In the Streaming tab, click Discover Devices, select your target, and click "Cast Current Track." You can also cast directly from the Now Playing view.
  3. Monitor operational stages, target renderer, transport status, and streamed bytes. Being discovered on the network does not guarantee the device has started streaming playback.
  4. Stop network casting before switching back to local audio devices, and verify output settings.

Standard UPnP / DLNA streaming is supported; NAA has been completely removed. AirPlay, proprietary protocols, and UPnP are distinct technologies; an AirPlay badge alone does not imply UPnP compatibility. Inspect the Signal Path and active transmission telemetry to see streamed data formats and active DSP.

UPnP capability declarations and streaming telemetry help verify received audio specifications, but cannot audit internal volume, EQ, or secondary resampling inside the renderer hardware. Displaying "Unverified" must not be mistaken for proven end-to-end bit-perfect transmission.

Audio Capture & Loopback

Settings → Input handles microphone, line-in, or system loopback recording. WASAPI Input is supported; [none] disables capture. Select input device, channel offset, buffer, and recording duration, then follow on-screen prompts to start/stop.

Leaving the output path empty saves recordings to the default directory. Monitor captured frames, duration, peak, RMS, and overflow/underflow counters, then inspect files after completion. Passthrough monitoring routes captured audio to your output; placing a live microphone near speakers can cause acoustic feedback—lower volume and check wiring before enabling.

18

Troubleshooting No Audio & Stuttering

Troubleshooting No Audio: Narrow Down Methodically

  1. Confirm physical hardware is powered on, cables are securely connected, and input selectors are correct; verify that the bottom bar is not muted and that software and hardware volume levels are adequate.
  2. Check whether the playback progress bar advances and whether error messages appear. The Null Output backend processes audio without outputting sound to physical hardware.
  3. Navigate to Settings → Output to verify the active device and backend. Unplugging and reconnecting USB DACs can change endpoint identifiers in Windows.
  4. If the device is held in exclusive mode by another application, close the conflicting software or switch to Shared mode; avoid running multiple exclusive audio players simultaneously.
  5. Revert to PCM, source sample rate, device-supported bit depth, and stereo output. If rejected by rate family policies, explicitly configure your policy as outlined in Chapter 6.
  6. If playback still fails, retain log files and submit feedback as described in the next chapter. Avoid reporting "no sound" without error logs and hardware specifications.

Audio Stuttering, Clicking, or Abnormal Playback Speed

Such symptoms typically stem from device throughput bottlenecks, buffer underruns, or driver/computational stalls—do not assume they are digital clipping. Increase buffer size from 100 ms to 200 ms, lower target sample rates, select shorter filter presets, and monitor error counters.

Temporarily disable GPU acceleration and replay the identical track to isolate backend issues. Modify one parameter at a time and document results. Extremely long filters or high-multiplier DSD modulation may exceed your system's real-time hardware capabilities.

Exclusive Playback Unexpectedly Restarts

When an audio stream remains unresponsive for an extended period, watchdog safeguards trigger, falling back to WASAPI Shared and restarting playback from the beginning. Bit-perfect delivery is no longer maintained; inspect STARVING and FALLBACK_SHARED markers in the log. Shared mixer rates must still comply with family policies, which may prompt new restrictions.

DSD-Specific Troubleshooting

Confirm your DAC natively supports the target bitrate, DoP carrier, or Native DSD. WASAPI Shared cannot transport DSD; Native requires an ASIO driver with dedicated native DSD support. ISO / DST files are not identical to standard DSF tracks; convert them to supported standalone tracks when unsupported alerts appear.

19

Logs, Diagnostics & One-Click Feedback

Preserving Reproducible Diagnostic States

Record file format, playback timestamp, device name, backend, output mode, target rate, and observed symptoms. For example: "Brand DAC, WASAPI Exclusive, 44.1 kHz FLAC, manual 192 kHz, errors immediately upon clicking play." For audio anomalies, note whether pausing, skipping tracks, or restarting restores normal playback.

In-App Feedback Submission

  1. Navigate to Settings → Diagnostics. Choose a feedback category, enter a descriptive title, detailed explanation, and reproduction steps.
  2. Click "Preview Payload First" to audit diagnostic data and your submitted text.
  3. After reviewing, click "Submit Feedback." The application bundles release version, OS details, audio devices, settings, and sanitized log tails with sensitive data stripped.
  4. Check the submission result. Successful upload is confirmed only when the upload receipt is displayed; if credentials are missing or network calls fail, diagnostics are stored locally with the local file path and error details provided.
  5. When delivering diagnostics manually, locate the file at the local path specified in the result. Never transmit raw config files containing API keys.

Common Log Terminology

Log EventTechnical Meaning
START/ENDMarks the start and conclusion of a playback session. The error string on the END line is vital for root-cause diagnosis; a session end itself is not necessarily a failure.
RATE_FAMILY_BLOCKEDSource rate and target rate conflict with current sample rate family policies; verify policy and target rate settings.
EXPLICIT_REJECT/RATEPROBE_EMPTYManual target rate is unsupported by the endpoint, or device capabilities were not detected cleanly; do not assume automatic success.
DEVICE_IN_USE/DEVICE_LOSTAudio endpoint is locked by another process or the device was disconnected.
STARVING/FALLBACK_SHAREDSustained throughput starvation triggered fallback to Shared mode; examine timestamps, actual sample rates, and buffer statistics.
PLAY_ABORTPlayback was interrupted by a new play or stop command before a single audio frame could be output; check command sequencing.

Previewing diagnostics does not transmit data. Never publicly upload your entire local app data directory; automated redaction cannot substitute for your own audit of personal information in titles, descriptions, and screenshots.

20

Updates, Backups & Common UI Questions

Before and After Updating

Settings → About & Updates displays the active version and checks for updates. The download process retrieves differential package files and verifies hashes; restart the app when prompted upon completion. If network access to update servers is blocked, download official full bundles from trusted sources.

In-app updates are designed to replace program binaries while safeguarding personal configurations. Backing up settings, playlists, and acoustic calibration sets prior to updating remains recommended. When extracting a new full bundle into a separate directory, preserve the old folder until data migration and paths are verified.

Blank Screen or Application Launch Failure

Check whether the full bundle was extracted completely, verifying that WebView2Runtime and WebView2Loader.dll are present and not quarantined by antivirus software. Re-extract trusted official bundles into a standard user-writable directory; never download individual loose DLLs from unverified websites. Consult launcher.log to diagnose launch stalls.

Settings Saved but Values Do Not Take Effect

Confirm that you clicked "Save Settings," then stop and restart playback. Reopen Settings to audit values, inspecting the Signal Path for live hardware values rather than relying solely on dropdown menus. Restoring defaults wipes custom parameters; note essential settings beforehand.

AI or Image Queries Yielding No Results

Distinguish between local file readability, network reachability, and account authorization. For AI, check API keys, connection tests, model IDs, and account balances; for covers, verify embedded tags and folder images. Asynchronous background retrieval and caching may not update views immediately; do not mistake metadata latency for an audio glitch.

Track Version Comparison

Right-click any track to launch Version Comparison. Comparing files is designed for identical musical works or recordings; significant differences in edits, cuts, or durations can prevent proper alignment and similarity scoring. Results provide diagnostic comparison; a single numerical score cannot determine which master sounds superior.

Never delete your entire configuration directory or music library to troubleshoot an isolated UI issue. Preserve the diagnostic state, and apply reversible adjustments one at a time.

A

Common Shortcuts & Audio Formats

Keyboard Shortcuts

Verified against current UI scripts. When text boxes, dropdowns, or text areas have input focus, playback shortcuts will not intercept text input; selected rows in PEQ feature dedicated arrow-key navigation.

KeyOperation
SpacePlay / Pause
←/→Previous / Next Track
Shift+←/→Rewind / Fast Forward 5 Seconds
↑/↓Volume Up / Down by 1 dB
n/p/sNext Track / Previous Track / Stop
lLyrics
iSignal Path
Ctrl+FFocus Global Search Bar
EscCloses right drawer, Now Playing view, active modal dialog, or navigates back based on active hierarchy

Supported Audio Formats

CategorySupported Extensions
PCM & Common LosslessWAV, FLAC, AIFF, ALAC / M4A, WavPack, etc.; supported specifications depend on source files and output hardware.
Common Lossy FormatsMP3, AAC, OGG / Vorbis, Opus, etc., handled via bundled decoders.
DSDDSF, DFF; configured for PCM conversion, DoP, or Native DSD based on hardware. Compressed DST and ISO image archives are not supported standalone DSD tracks.
CUEDisplays and plays individual tracks based on accompanying audio images; a standalone CUE sheet cannot play without the referenced audio file.

When encountering unsupported alerts for ISO / SACD-ISO / DST, extract them into standard DSF / DFF tracks using specialized extraction tools. Audio CD support depends on optical drive hardware and specific OS subsystems, and should not be treated as a universal certified ripping solution across all drives.

B

Data Files & Feedback Channels

Standard Application Data Files & Directories

File or DirectoryPurpose & Configuration
rlplayer-settings.confGeneral user preferences and configurations.
rlplayer-library.confConfigured local music library directory paths.
rlplayer-playlist.txtActive playback queue; managed independently from saved playlists.
rlplayer-savedqueues.confNamed playlists and track orders.
rlplayer-favs.jsonFavorite tracks.
rlplayer-peq.txtActive 20-band PEQ parameters.
rlplayer-llm.confAI service configurations; may contain API keys, handle with care.
rlplayer-sources.confNetwork streaming server credentials and endpoints.
data/covercache/artistimgMusic database indexes, acoustic calibration profiles, and artwork caches.
rlplayer-meta/backupsTag writeback metadata records and original file backup archives.
rlplayer-playback.log/launcher.logPlayback runtime and launcher diagnostic logs.
recordingsDefault output directory for captured audio recordings when no path is specified.

Command-Line Tools & Offline Analysis

The tools folder in the full release bundle provides diagnostic and measurement utilities. Standard users should prioritize the graphical interface. The --analyze flag in rtaplay executes offline processing without initializing audio hardware; review documentation for other tools before feeding unknown test signals to active speakers or headphones.

Contact & Licensing

Community & Feedback QQ Group: 895816505 Issue Tracker: https://github.com/okhuoyanyan/RLPlayer-feedback/issues Official Website: https://rlplayer.rainlain.com

In-app feedback entry: Settings → Diagnostics. Preview payloads before submission; check local output paths if network calls fail. Software licensing and third-party notices are detailed in LICENSE, THIRD-PARTY-NOTICES.txt, and OPRA-NOTICE.txt in the release bundle.

The manual is organized around common user tasks. Arrows in settings paths denote navigation steps, e.g., "Settings → PCM" instructs opening Settings and clicking the PCM tab. This manual applies to RLPlayer 3.0.10. For DSP theory and empirical numerical proofs, see Technical Details (Whitepaper)。
RLPLAYER / EXPLORE

Get closer to the sound.

You’re on the Windows siteVisit the macOS site
GitHub ↗Free and open source · Local HiFi player