Skip to content

Guide Configuration

github-actions[bot] edited this page Jul 6, 2026 · 4 revisions

Configuration Guide

The NoraBar settings window lets you adjust the HUD appearance and how the app stays resident. Settings are saved as soon as they change.

HUD Settings

Design Style

You can switch between Minimal Floating Pill and Productivity Command Island.

  • Minimal Floating Pill

    • A lightweight view around 450px wide.
    • Keeps the track title, artist, album art, waveform, and control buttons compact.
  • Productivity Command Island

    • A wider view around 560px wide.
    • Gives album art more space and makes playback time easier to read.

Show Progress Bar

Toggles the bar that shows the playback position.

When enabled, Minimal shows a thin progress bar, and Productivity shows a progress bar with the current position and total duration.

Synced Lyrics

Toggles synced lyrics in the HUD.

When enabled, NoraBar fetches synced lyrics from LRCLIB when available and displays the current lyric line in sync with playback. If lyrics are not found or a network error occurs, a short status message is shown.

Window Position

Lets you customize the horizontal position of the HUD.

Use Change Position to enter position edit mode, drag the HUD to the desired position, then finish editing. Use Reset to Default to return the HUD to the default centered position.

Run at System Startup

Creates NoraBar.lnk in the Windows Startup folder so NoraBar launches when you sign in. On the first run (when the settings file does not exist yet), this setting is enabled by default.

Startup launches pass the --startup argument, so only the HUD stays resident and the settings window does not open automatically.

Display Language

Switches the language used in the app. On the first run, "Japanese" is selected if the system language (OS language) is Japanese, and "English" is selected for other languages.

  • Japanese
  • English

This affects the settings window, tray menu, and right-click menu.

Reset Settings

Resets all settings to their default values.

Clicking "Reset All" shows a confirmation dialog. If confirmed, all settings—including language, design style, window position, progress bar, synced lyrics, and startup behavior—will be initialized. (Note: After reset, the startup behavior will be enabled, and the custom HUD position will be cleared.)

About

Check for Updates

Checks the latest release on GitHub Releases. If a newer version is found, a button appears to open the release page.

GitHub Repository

Opens the repository page that contains the NoraBar source code.

Open Source Licenses

Shows the licenses for third-party libraries used by NoraBar. The app currently includes CSCore and LRCLIB license information.

Settings File

Settings are saved here:

%AppData%\NoraBar\settings.json

The settings directory name is NoraBar, matching the app name.

Japanese Version

Clone this wiki locally