-
-
Notifications
You must be signed in to change notification settings - Fork 3
Dashboard
This page covers everything visible on the main dashboard: the Now Playing card, Listening History, Stats Logs, Settings, and the layout toggle.
You don't need to refresh the page. Updates arrive in real time:
- The RPC status badge updates whenever the connection state changes
- The Now Playing card refreshes every second
- New history entries appear at the top of the list as you listen
- New log entries appear at the top of the log list as they come in
A small badge in the dashboard shows whether the RPC connection is active.
| Badge | Meaning |
|---|---|
| 🟢 Connected | The app is successfully connected and sending data |
| 🔴 Disconnected | The connection is down — check that your desktop client is running |
The badge updates automatically whenever the connection state changes.
The music card shows what you're currently listening to.
| Element | What it shows |
|---|---|
| Cover art | Album/track artwork from your music source |
| Title | Song name |
| Artist | Artist name (hidden if it's the same as the source) |
| Source | The platform you're playing from (e.g. Spotify) |
| Progress bar | How far through the track you are — updates every second |
| Time elapsed | How long you've been listening to the current track |
| Duration | Total length of the track (only shown when available) |
When nothing is playing, the card shows placeholder text and the progress bar resets to zero.
The card updates automatically — you don't need to click anything.
The history panel shows a scrollable list of everything you've listened to, most recent at the top.
- Cover art — click it to open the song in your music app (if a link is available)
- How long ago — e.g. "3 minutes ago" — hover over it for the exact date and time
- Title, Artist, Source
By source (platform): A dropdown at the top of the history panel lets you filter by source (e.g. show only Spotify tracks). Select a source from the list to filter, or choose All to go back to seeing everything.
By search: Type in the search box to filter by song title or artist name. The list updates as you type.
History loads in batches. Scroll down to automatically load older entries — the list extends itself as you reach the bottom.
When you start playing a new song, it appears at the top of the history list in real time — no page refresh needed.
The Stats section shows you a bar chart of your listening history — how many minutes you listened or how many songs you played, day by day or month by month. You can also browse a summary of your top songs and artists.
[ Week | Month | Year ] ← | May 2025 | → [ Summary | Time | Songs ]
Three groups of buttons sit above the chart. Here's what each one does.
These three buttons control how much time the chart covers.
| Button | What you see |
|---|---|
| Week | 7 bars — one per day of the current week (Mon–Sun) |
| Month | One bar per day of the current month |
| Year | 12 bars — one per month of the current year |
Tip: The active button is highlighted. Click any of the three to switch instantly.
The arrow buttons let you go back in time to see older periods.
- ← (left arrow) — go to the previous week / month / year
- → (right arrow) — go forward (disabled when you're already at the current period — the button will appear faded)
-
Label in the middle — shows which period you're currently viewing, e.g.
May 2025or20 Apr – 26 Apr
These buttons change what the chart measures.
| Button | What it shows |
|---|---|
| Summary | Hides the chart and shows your Top Songs, Top Artists, and total stats for the period (see Summary View below) |
| Time | The chart shows minutes listened per bar |
| Songs | The chart shows number of songs played per bar |
- Each bar represents a day (in week/month view) or a month (in year view).
- Taller bars = more listening activity.
- Darker bars = lower values; lighter/brighter bars = higher values. The color scales automatically.
- Hover over a bar — a tooltip pops up showing the exact date and value (e.g. "143 minutes" or "27 songs").
Click any bar to open a detail panel below the chart. It shows:
- The date or month you clicked
- The total number of songs or total listening time for that day
- A breakdown by platform (e.g. Spotify, YouTube Music) showing how many tracks you played on each To close the panel, click the same bar again, or click anywhere else on the chart.
Inside the detail panel, each platform row has a chevron (v) on the right. Click the row to expand it and see the individual songs you listened to on that platform that day, sorted from most recent to oldest.
- Click the row again to collapse the list.
- Only one platform can be expanded at a time — opening another one automatically closes the previous.
Click the Summary button to switch to a full-period overview. The summary shows:
Two columns side by side
- Top Songs — your 5 most-played tracks in the current period, ranked by play count
- Top Artists — your 5 most-listened-to artists, ranked by how often you played their songs Each row shows:
- Rank number (1–5)
- Album/artist artwork — you can click the pencil icon on any image to replace it with a custom image URL
- Title and artist / play count
- A bar showing how the count compares to the #1 entry
Click any artist row (not the pencil icon) to drill down into that artist's top 10 songs for the period. A back button appears in the top-left to return to the main summary.
Two large numbers at the bottom of the summary:
- Minutes listened — total listening time for the period
- Tracks played — total number of song plays
Click Time or Songs in the mode toggle to hide the summary and return to the bar chart.
Inside the Summary view, a camera icon appears in the top-right corner. Click it to open the capture menu, which lets you save your summary as a PNG image.
| Option | Description |
|---|---|
| Wide | Two-column layout (songs left, artists right) — good for sharing |
| Tall | Stacked layout — better for portrait/mobile screenshots |
| Option | Width |
|---|---|
| Small | 1080 px |
| Medium | 1200 px |
| Large | 1320 px |
| Wide | 1400 px |
Click Save and the image downloads automatically to your device.
The capture menu closes if you click anywhere outside it.
The Logs panel shows a record of events and errors from the app — useful if something isn't working as expected.
- When — how long ago it happened, plus the exact timestamp in parentheses
- Type badge — colored label indicating the kind of log entry (e.g. error, warning, info)
- Message — a description of what happened
- Stack trace — technical detail shown below the message (only present on errors)
A dropdown at the top lets you filter by log type:
- All — show everything
- Error — show only errors
- Other types (info, warning, etc.) depending on what the app generates
Logs load in batches of 40. Scroll down to load older entries.
New log events appear at the top of the list automatically as they arrive.
Click the gear icon (⚙) in the corner to open Settings.
- Gear icon — opens the Settings panel (the main dashboard is hidden while settings are open)
- Back arrow (←) — closes settings and returns to the dashboard
Settings are loaded from the server and vary depending on your setup.
Each setting has a label and an optional note explaining what it does. If a setting has a minimum or maximum value, the field enforces those limits and shows an error if you go out of range.
At the top of the settings form there is a Language dropdown. Changing it saves your preference and reloads the page in the selected language.
- Click Save to apply your changes.
- A status message appears at the bottom of the panel confirming success or showing an error.
- After saving, the app reloads automatically (after ~5 seconds) to apply the new configuration.
Click Reset to restore all settings to their defaults. You'll be asked to confirm before anything changes. The page reloads automatically after a successful reset.
A toggle button in the top corner switches between two layout modes.
| Mode | Description |
|---|---|
| Single (default) | The layout will be single-column |
| Grid | The layout splits into two columns |
Your layout preference is saved automatically and restored when you reopen the dashboard.