From 4bd479a904b25e470758b8b72f1291ba861e00ea Mon Sep 17 00:00:00 2001
From: Thales <>
Date: Sun, 4 Oct 2026 15:21:28 +0100
Subject: [PATCH 1/2] feat(help): Guide in the rail makes the studio explain
 itself

Nothing in the studio said what its controls do, and a new user has to
press things to find out, which can start an extraction or delete a song.

Guide, in the rail below Trash, turns help mode on, and a pill at the
bottom says so. Pointing at a control, focusing it, or clicking it
outlines it and shows a box beside it with the control's own label and
what it does, in plain words. Nothing else is marked, so the screen
stays calm. While help mode is on, presses are taken by it, so
exploring never acts on the studio. Esc or Guide again turns it off.

The box covers the top bar, the rail, the song list, every lane control
(naming its instrument), the song facts, the waveforms and the bottom
bar. Settings lists every option, tab by tab, in one line each. Texts
are help.* keys in all ten languages.

Closes #757
---
 static/css/daw.css           |  36 ++
 static/index.html            |   9 +
 static/js/helpMode.js        | 334 +++++++++++++++
 static/js/i18n.js            | 770 +++++++++++++++++++++++++++++++++++
 static/js/main.js            |   2 +
 tests/e2e/help-mode.spec.mjs |  93 +++++
 6 files changed, 1244 insertions(+)
 create mode 100644 static/js/helpMode.js
 create mode 100644 tests/e2e/help-mode.spec.mjs

diff --git a/static/css/daw.css b/static/css/daw.css
index cb2090e9..d015e4a0 100644
--- a/static/css/daw.css
+++ b/static/css/daw.css
@@ -5669,3 +5669,39 @@ input, textarea { font-family: inherit; }
   box-shadow: 0 12px 32px rgba(0, 0, 0, 0.42);
 }
 .stem-overflow.open { display: flex; }
+
+/* Help mode. The Guide button in the rail, below Trash; while it is pressed,
+   a ring is drawn around what can be seen of the control being explained,
+   and its box sits beside it. The ring is a layer of its own, so nothing in
+   the page moves and no panel clips it. */
+.rail-guide[aria-pressed="true"] { color: var(--accent); background: var(--panel); }
+/* Only the control being explained is marked, so the screen stays calm; the
+   pill at the bottom says help mode is on. */
+.help-mode .help-target { cursor: help; }
+.help-ring {
+  position: fixed; z-index: 9998; pointer-events: none;
+  border: 2px solid var(--accent); border-radius: var(--radius-sm);
+  box-shadow: 0 0 0 4px color-mix(in srgb, var(--accent) 16%, transparent);
+}
+.help-pill {
+  position: fixed; z-index: 9999; left: 50%; bottom: 18px; transform: translateX(-50%);
+  max-width: calc(100vw - 32px);
+  background: var(--panel); border: 1px solid var(--accent); border-radius: 999px;
+  padding: 7px 16px; box-shadow: var(--shadow-panel);
+  color: var(--fg); font: 500 12.5px/1.4 var(--font-sans); text-align: center;
+  pointer-events: none;
+}
+.help-tip {
+  position: fixed; z-index: 10000;
+  width: max-content; max-width: min(300px, calc(100vw - 16px));
+  background: var(--panel); border: 1px solid var(--accent); border-radius: var(--radius);
+  padding: 10px 12px; box-shadow: var(--shadow-panel);
+  color: var(--fg-2); font: 400 13px/1.45 var(--font-sans);
+  pointer-events: none;
+}
+.help-tip b { display: block; margin-bottom: 2px; color: var(--fg); font-size: 13.5px; font-weight: 700; }
+.help-tip.long { max-width: min(560px, calc(100vw - 16px)); columns: 2 230px; column-gap: 20px; font-size: 12px; line-height: 1.4; }
+.help-tip.long b { column-span: all; margin-bottom: 6px; }
+.help-tip-h { break-after: avoid; margin-top: 8px; color: var(--accent); font-size: 10px; font-weight: 700; letter-spacing: 0.1em; text-transform: uppercase; }
+.help-tip-row { break-inside: avoid; margin-top: 3px; }
+.help-tip-row span { color: var(--fg); font-weight: 600; }
diff --git a/static/index.html b/static/index.html
index 56490e23..c863c3af 100644
--- a/static/index.html
+++ b/static/index.html
@@ -330,6 +330,15 @@
               <span data-i18n="nav.trash">Trash</span>
               <span class="rail-badge hidden" id="trashBadge" aria-hidden="true"></span>
             </button>
+            <!-- Help mode: the screen explains itself while this is pressed. -->
+            <button class="rail-btn rail-guide" type="button" id="helpModeBtn" aria-pressed="false"
+                    title="Explain the screen" aria-label="Explain the screen"
+                    data-i18n-title="help.button" data-i18n-aria-label="help.button">
+              <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                <path d="M2 5.5c3-1.3 6-1.3 10 1v13c-4-2.3-7-2.3-10-1z M22 5.5c-3-1.3-6-1.3-10 1v13c4-2.3 7-2.3 10-1z"/>
+              </svg>
+              <span data-i18n="help.railLabel">Guide</span>
+            </button>
             <div style="flex:1"></div>
             <!-- Notifications (#636). In the rail rather than at the end
                  of the top bar: that row is the import and split controls, so
diff --git a/static/js/helpMode.js b/static/js/helpMode.js
new file mode 100644
index 00000000..b24b561a
--- /dev/null
+++ b/static/js/helpMode.js
@@ -0,0 +1,334 @@
+// Help mode: Guide in the rail, below Trash, turns the studio into its own manual.
+// Pointing at any control listed in HELP, or clicking it, outlines it and shows
+// what it does; a pill at the bottom says help mode is on. Clicks are taken by help mode while it is on,
+// so exploring never starts an extraction or deletes a song. Esc or Guide
+// again turns it off.
+//
+// The box is titled with the control's own label, which the rest of the app
+// already translates, and its text comes from the help.* keys in i18n.js.
+
+import { t } from "./i18n.js";
+
+/** Lane controls name their instrument in the text ("Silences the Drums"). */
+const laneName = (el) => el.closest(".mx-row, .lane-header")?.querySelector(".mx-name")?.textContent.trim() || "";
+const chipName = (el) => el.textContent.trim();
+
+// Order matters only where selectors overlap: the first match wins.
+const HELP = [
+  ["#helpModeBtn", "help.helpMode"],
+  [".daw-brand a", "help.website"],
+  ["#uploadFileBtn", "help.upload"],
+  ["#url", "help.search"],
+  ["#stemAllBtn", "help.stemAll"],
+  [".stem-choice[data-stem]", "help.stemChip", chipName],
+  ['.vocal-mode-btn[data-mode="all"]', "help.vocalCombined"],
+  ['.vocal-mode-btn[data-mode="split"]', "help.vocalSplit"],
+  ["#autoSectionsBtn", "help.detectStructure"],
+  ['.daw-panel-toggle[data-panel="analysis"]', "help.analysisToggle"],
+  ['.daw-panel-toggle[data-panel="sections"]', "help.sectionsToggle"],
+  ["#submit", "help.extract"],
+  ["#fav-btn", "help.favorite"],
+  ["#np-details-btn", "help.songDetails"],
+  ["#sidebarCollapseBtn", "help.toggleLibrary"],
+  [".rail-favorites", "help.favorites"],
+  [".rail-library", "help.library"],
+  [".rail-lyrics", "help.lyrics"],
+  [".rail-trash", "help.trash"],
+  [".rail-queue", "help.queue"],
+  ["#notifBtn", "help.notifications"],
+  ["#friendsBtn", "help.recommend"],
+  ["#settingsBtn", "settings"],
+  ["#aboutBtn", "help.about"],
+  ["#catalogSearch", "help.searchLibrary"],
+  ["#newFolderBtn", "help.newFolder"],
+  ["#catalogList .cat-item.in-trash", "help.trashedSong"],
+  ["#catalogList .cat-item", "help.song"],
+  ["#sectionsAddBtn", "help.addSection"],
+  [".mx-fader", "help.volume", laneName],
+  [".lane-key-step.up", "help.laneKeyUp", laneName],
+  [".lane-key-step.down", "help.laneKeyDown", laneName],
+  [".lane-key-value", "help.laneKey", laneName],
+  [".mx-btn.mute", "help.mute", laneName],
+  [".mx-btn.solo", "help.solo", laneName],
+  [".lane-dl", "help.download", laneName],
+  ["#transport .daw-info-row", "help.songFacts", null, "help.songFactsTitle"],
+  ["#ruler-time", "help.waves", null, "help.wavesTitle"],
+  [".waves-column", "help.waves", null, "help.wavesTitle"],
+  ["#t-stop", "help.stop"],
+  ["#t-play", "help.play"],
+  ["#t-loop", "help.loop"],
+  ["#t-loop-start", "help.loopStart"],
+  ["#t-loop-end", "help.loopEnd"],
+  ["#t-speed-05", "help.speedHalf"],
+  ["#t-speed-075", "help.speedSlow"],
+  ["#t-speed-1", "help.speedNormal"],
+  ["#t-pitch-down", "help.keyDown"],
+  ["#t-pitch-up", "help.keyUp"],
+  ["#t-pitch-reset", "help.keyReset"],
+  ["#t-metro", "help.click"],
+  ["#t-metro-vol-btn", "help.clickVolume"],
+  ["#t-metro-more", "help.clickMore"],
+  ["#t-export-btn", "help.export"],
+];
+
+// Every option in Settings, by tab: the tab and option names are the dialog's
+// own keys, the one-line descriptions are help.set.*.
+const SETTINGS = [
+  ["settings.tab.general", [
+    ["settings.language.title", "help.set.language"],
+    ["settings.maxDuration.title", "help.set.maxDuration"],
+    ["settings.playlistLimit.title", "help.set.playlistLimit"],
+    ["settings.cookies.title", "help.set.cookies"],
+    ["settings.stemsLocation.title", "help.set.stemsLocation"],
+    ["settings.exportsLocation.title", "help.set.exportsLocation"],
+    ["settings.autoDelete.title", "help.set.autoDelete"],
+    ["settings.device.title", "help.set.device"],
+    ["settings.quality.title", "help.set.quality"],
+    ["settings.exportLogs.title", "help.set.exportLogs"],
+    ["settings.resetData.title", "help.set.resetData"],
+  ]],
+  ["settings.tab.songDetails", [
+    ["settings.acoustid.title", "help.set.acoustid"],
+    ["settings.discogs.title", "help.set.discogs"],
+    ["settings.transcribe.title", "help.set.transcribe"],
+  ]],
+  ["settings.tab.network", [
+    ["settings.network.allowTitle", "help.set.network"],
+    ["settings.network.port.title", "help.set.port"],
+  ]],
+  ["settings.tab.export", [
+    ["settings.export.sampleRate.title", "help.set.sampleRate"],
+    ["settings.export.videoQuality.title", "help.set.videoQuality"],
+  ]],
+  ["settings.tab.logs", [[null, "help.set.logs"]]],
+  ["settings.tab.registry", [[null, "help.set.registry"]]],
+];
+
+let on = false;
+let tipEl = null;
+let pillEl = null;
+let ringEl = null;
+let current = null;
+
+export function isHelpModeOn() {
+  return on;
+}
+
+/** The help entry for whatever is under the pointer, and the element it is for. */
+function findEntry(target) {
+  if (!(target instanceof Element)) return null;
+  for (const [sel, key, nameOf, titleKey] of HELP) {
+    const el = target.closest(sel);
+    if (el && isVisible(el)) return { el, key, nameOf, titleKey };
+  }
+  return null;
+}
+
+function isVisible(el) {
+  const r = el.getBoundingClientRect();
+  return r.width > 0 && r.height > 0;
+}
+
+/** The control's own label, which the app already translates. */
+function titleOf(entry) {
+  if (entry.titleKey) return t(entry.titleKey);
+  const { el } = entry;
+  const text = (el.innerText || "").trim().split("\n")[0].trim();
+  if (text && text.length <= 40) return text;
+  return el.getAttribute("aria-label") || el.getAttribute("placeholder") || el.getAttribute("title")
+    || el.querySelector("[aria-label]")?.getAttribute("aria-label") || text;
+}
+
+function fillTip(entry) {
+  tipEl.replaceChildren();
+  tipEl.classList.toggle("long", entry.key === "settings");
+  const title = document.createElement("b");
+  title.textContent = titleOf(entry);
+  tipEl.append(title);
+  if (entry.key !== "settings") {
+    const name = entry.nameOf ? entry.nameOf(entry.el) : "";
+    tipEl.append(t(entry.key, { name }));
+    return;
+  }
+  for (const [tabKey, rows] of SETTINGS) {
+    const h = document.createElement("div");
+    h.className = "help-tip-h";
+    h.textContent = t(tabKey);
+    tipEl.append(h);
+    for (const [nameKey, descKey] of rows) {
+      const row = document.createElement("div");
+      row.className = "help-tip-row";
+      if (nameKey) {
+        const n = document.createElement("span");
+        n.textContent = t(nameKey);
+        row.append(n, " ");
+      }
+      row.append(t(descKey));
+      tipEl.append(row);
+    }
+  }
+}
+
+/**
+ * What the eye sees of a control. A button is often much bigger than the icon
+ * in it (the heart is a 76px tall strip around a 16px icon), and a ring around
+ * the whole box reads as a stray bar. When the content is clearly smaller than
+ * the box, the ring goes around the content instead.
+ */
+function visibleRect(el) {
+  const r = el.getBoundingClientRect();
+  const range = document.createRange();
+  range.selectNodeContents(el);
+  const c = range.getBoundingClientRect();
+  const small = c.width > 0 && c.height > 0 && (c.width < r.width * 0.6 || c.height < r.height * 0.6);
+  // Otherwise the box and its content together: a rail label can hang below
+  // its button's own box, and the ring has to take it in.
+  const box = small ? c : c.width > 0 && c.height > 0
+    ? { left: Math.min(r.left, c.left), top: Math.min(r.top, c.top), right: Math.max(r.right, c.right), bottom: Math.max(r.bottom, c.bottom) }
+    : r;
+  const pad = small ? 6 : 3;
+  const left = box.left - pad, top = box.top - pad, right = box.right + pad, bottom = box.bottom + pad;
+  return { left, top, right, bottom, width: right - left, height: bottom - top };
+}
+
+/** The ring is its own layer over the page, so no panel can clip it. */
+function placeRing(rect) {
+  ringEl.style.left = `${Math.round(rect.left)}px`;
+  ringEl.style.top = `${Math.round(rect.top)}px`;
+  ringEl.style.width = `${Math.round(rect.right - rect.left)}px`;
+  ringEl.style.height = `${Math.round(rect.bottom - rect.top)}px`;
+  ringEl.hidden = false;
+}
+
+/** Beside the control, on whichever side has room, never over it. */
+function placeTip(r) {
+  const tr = tipEl.getBoundingClientRect();
+  const vw = window.innerWidth, vh = window.innerHeight, gap = 10, m = 8;
+  const fits = (x, y) => x >= m && y >= m && x + tr.width <= vw - m && y + tr.height <= vh - m;
+  const cx = Math.min(Math.max(m, r.left + r.width / 2 - tr.width / 2), vw - tr.width - m);
+  const cy = Math.min(Math.max(m, r.top + r.height / 2 - tr.height / 2), vh - tr.height - m);
+  const options = [
+    [r.right + gap, cy],
+    [r.left - gap - tr.width, cy],
+    [cx, r.bottom + gap],
+    [cx, r.top - gap - tr.height],
+  ];
+  // A large area, like the waveforms, takes the box inside its top edge.
+  const [x, y] = options.find(([x, y]) => fits(x, y)) ?? [cx, Math.max(m, Math.min(r.top + 12, vh - tr.height - m))];
+  tipEl.style.left = `${Math.round(x)}px`;
+  tipEl.style.top = `${Math.round(y)}px`;
+}
+
+function show(entry) {
+  if (current?.el === entry.el) return;
+  hide();
+  current = entry;
+  entry.el.classList.add("help-current");
+  fillTip(entry);
+  tipEl.hidden = false;
+  const rect = visibleRect(entry.el);
+  placeRing(rect);
+  placeTip(rect);
+}
+
+function hide() {
+  current?.el.classList.remove("help-current");
+  current = null;
+  if (tipEl) tipEl.hidden = true;
+  if (ringEl) ringEl.hidden = true;
+}
+
+/** Mark everything help mode can explain, including lanes added since. */
+function markTargets() {
+  for (const el of document.querySelectorAll(".help-target")) el.classList.remove("help-target");
+  if (!on) return;
+  for (const [sel] of HELP) {
+    for (const el of document.querySelectorAll(sel)) if (isVisible(el)) el.classList.add("help-target");
+  }
+}
+
+function onPointerOver(e) {
+  const entry = findEntry(e.target);
+  if (entry) show(entry);
+  else if (!tipEl.contains(e.target)) hide();
+}
+
+// Help mode takes every press except Guide itself, so pointing around the
+// studio can never act on it. A click shows that control's box, which is also
+// how help mode works on a touch screen.
+function swallow(e) {
+  if (e.target instanceof Element && e.target.closest("#helpModeBtn")) return;
+  e.preventDefault();
+  e.stopPropagation();
+  if (e.type === "click") {
+    const entry = findEntry(e.target);
+    if (entry) show(entry);
+    else hide();
+  }
+}
+
+function onFocus(e) {
+  const entry = findEntry(e.target);
+  if (entry) show(entry);
+}
+
+function onKey(e) {
+  if (e.key === "Escape") {
+    e.preventDefault();
+    e.stopPropagation();
+    setHelpMode(false);
+  }
+}
+
+const PRESS_EVENTS = ["pointerdown", "mousedown", "click", "dblclick", "dragstart", "contextmenu"];
+
+export function setHelpMode(next) {
+  if (next === on) return;
+  on = next;
+  document.body.classList.toggle("help-mode", on);
+  if (pillEl) {
+    pillEl.textContent = t("help.pill");
+    pillEl.hidden = !on;
+  }
+  const btn = document.getElementById("helpModeBtn");
+  btn?.setAttribute("aria-pressed", String(on));
+  if (on) {
+    document.addEventListener("pointerover", onPointerOver, true);
+    for (const type of PRESS_EVENTS) document.addEventListener(type, swallow, true);
+    document.addEventListener("keydown", onKey, true);
+    document.addEventListener("focusin", onFocus, true);
+    window.addEventListener("resize", hide);
+    document.addEventListener("scroll", hide, true);
+    markTargets();
+  } else {
+    document.removeEventListener("pointerover", onPointerOver, true);
+    for (const type of PRESS_EVENTS) document.removeEventListener(type, swallow, true);
+    document.removeEventListener("keydown", onKey, true);
+    document.removeEventListener("focusin", onFocus, true);
+    window.removeEventListener("resize", hide);
+    document.removeEventListener("scroll", hide, true);
+    hide();
+    markTargets();
+  }
+}
+
+export function initHelpMode() {
+  const btn = document.getElementById("helpModeBtn");
+  if (!btn || btn.dataset.ready === "1") return;
+  btn.dataset.ready = "1";
+  tipEl = document.createElement("div");
+  tipEl.className = "help-tip";
+  tipEl.id = "helpTip";
+  tipEl.setAttribute("role", "tooltip");
+  tipEl.hidden = true;
+  pillEl = document.createElement("div");
+  pillEl.className = "help-pill";
+  pillEl.setAttribute("role", "status");
+  pillEl.hidden = true;
+  ringEl = document.createElement("div");
+  ringEl.className = "help-ring";
+  ringEl.setAttribute("aria-hidden", "true");
+  ringEl.hidden = true;
+  document.body.append(ringEl, tipEl, pillEl);
+  btn.addEventListener("click", () => setHelpMode(!on));
+}
diff --git a/static/js/i18n.js b/static/js/i18n.js
index f10e4d40..da8e5472 100644
--- a/static/js/i18n.js
+++ b/static/js/i18n.js
@@ -442,6 +442,83 @@ const en = {
   "nav.weRecommendLine1": "We",
   "nav.weRecommendLine2": "Recommend",
   "nav.help": "Help",
+  "help.button": "Explain the screen",
+  "help.railLabel": "Guide",
+  "help.pill": "Help mode: point at anything to see what it does. Esc to leave.",
+  "help.helpMode": "Help mode is on. Point at anything, or click it, to see what it does. Press Esc or this button to leave.",
+  "help.website": "Opens stemdeck.app in your browser.",
+  "help.upload": "Pick an audio file from your computer to split into its instruments.",
+  "help.search": "Type a song name to search for it online, or paste a link. You can also drop an audio file here.",
+  "help.stemAll": "Extract every instrument the song has.",
+  "help.stemChip": "Click to include or leave out {name} when you extract.",
+  "help.vocalCombined": "Keeps all the singing in one Vocals lane.",
+  "help.vocalSplit": "Splits the singing into the lead voice and the backing voices.",
+  "help.detectStructure": "Experimental. When on, the next song you import gets its intro, verse and chorus marked for you.",
+  "help.analysisToggle": "Shows or hides the row of song facts: key, tempo, loudness and more.",
+  "help.sectionsToggle": "Shows or hides the sections bar, where the parts of the song are marked.",
+  "help.extract": "Starts splitting the song into its instruments. Each one gets its own lane below.",
+  "help.favorite": "Adds the open song to Favorites, or takes it out.",
+  "help.songDetails": "Details about the open song.",
+  "help.toggleLibrary": "Hides the song list to give the studio more room, or brings it back.",
+  "help.favorites": "Shows only the songs you gave a heart.",
+  "help.library": "Shows all your songs in the list.",
+  "help.lyrics": "Shows the words of the song, lit up line by line as it plays.",
+  "help.trash": "Deleted songs wait here until you empty the Trash. The number shows how many there are.",
+  "help.queue": "The songs waiting to be split, in the order they will be done.",
+  "help.notifications": "Messages from StemDeck, such as a new release or an import that failed.",
+  "help.recommend": "Artists, instrument makers and gear worth knowing. StemDeck takes no money from any of them.",
+  "help.about": "Links to the website, GitHub and Discord, and the credits.",
+  "help.searchLibrary": "Type part of a song's name to find it. Start with # to find songs by tag.",
+  "help.newFolder": "Makes a folder, so you can sort your songs.",
+  "help.trashedSong": "A deleted song. Hold it for a second to bring it back.",
+  "help.song": "Click a song to open it in the studio.",
+  "help.addSection": "Adds a section, like a verse or a chorus, to the sections bar.",
+  "help.volume": "Drag to make {name} louder or quieter.",
+  "help.laneKeyUp": "Moves only {name} up one semitone, the smallest step in music.",
+  "help.laneKeyDown": "Moves only {name} down one semitone, the smallest step in music.",
+  "help.laneKey": "The key of {name}. K means its original key; a number means how many semitones it moved.",
+  "help.mute": "Silences {name}, so you can play or sing that part yourself.",
+  "help.solo": "Plays only {name}, to hear it clearly.",
+  "help.download": "Saves {name} as its own audio file.",
+  "help.songFactsTitle": "Song facts",
+  "help.songFacts": "Found for you: the key, the tempo in BPM, loudness, length and how much of each instrument the song has.",
+  "help.wavesTitle": "Waveforms",
+  "help.waves": "Each instrument's sound, drawn over time. Click to jump to that moment. Drag across to loop that part.",
+  "help.stop": "Stops the song.",
+  "help.play": "Plays the song, or pauses it.",
+  "help.loop": "Turns looping on or off: the part between the two times beside it repeats. The L key does the same.",
+  "help.loopStart": "Where the loop begins, in seconds. Scroll over it to move it.",
+  "help.loopEnd": "Where the loop ends, in seconds. Scroll over it to move it.",
+  "help.speedHalf": "Plays at half speed. The pitch stays the same.",
+  "help.speedSlow": "Plays at three-quarter speed. Scroll over it to pick any speed from 0.50x to 0.99x.",
+  "help.speedNormal": "Plays at the song's own speed.",
+  "help.keyDown": "Moves the whole song down one semitone, the smallest step in music.",
+  "help.keyUp": "Moves the whole song up one semitone, the smallest step in music.",
+  "help.keyReset": "Puts every part back in the song's original key.",
+  "help.click": "Turns on a click that follows the song's tempo. The K key does the same.",
+  "help.clickVolume": "How loud the click is.",
+  "help.clickMore": "More settings for the click track.",
+  "help.export": "Saves what you hear as one audio file. Its menu also offers every part as a .zip, or only the looped part.",
+  "help.set.language": "The language of the app.",
+  "help.set.maxDuration": "The longest song it accepts, in minutes.",
+  "help.set.playlistLimit": "The most songs one playlist adds.",
+  "help.set.cookies": "Only needed if YouTube asks you to prove you are not a bot.",
+  "help.set.stemsLocation": "Where your separated songs are stored.",
+  "help.set.exportsLocation": "Where stems and loops you drag out of StemDeck go.",
+  "help.set.autoDelete": "Off unless you turn it on. Deletes songs after the number of days you set.",
+  "help.set.device": "Your graphics card or your processor, for separating.",
+  "help.set.quality": "Best gives cleaner stems and takes twice as long.",
+  "help.set.exportLogs": "Every log in one zip, to attach to a bug report.",
+  "help.set.resetData": "Deletes every song. It cannot be undone.",
+  "help.set.acoustid": "Recognises each song by its sound, with a free AcoustID key.",
+  "help.set.discogs": "Band profiles and releases, with a free Discogs token.",
+  "help.set.transcribe": "Writes down the words from the vocals when no lyrics are found.",
+  "help.set.network": "Open StemDeck on your phone or tablet, on the same Wi-Fi. Scan the QR code, or type the address shown.",
+  "help.set.port": "The port StemDeck runs on. Restart to apply.",
+  "help.set.sampleRate": "The sample rate of the audio files you export.",
+  "help.set.videoQuality": "The quality of the videos you export.",
+  "help.set.logs": "Where the logs are, and the application, backend and setup logs.",
+  "help.set.registry": "The list of finished songs StemDeck keeps on disk. Read only.",
 
   "search.ariaLabel": "Search library",
   "search.placeholder": "Search or #tag…",
@@ -1254,6 +1331,83 @@ const pl = {
   "nav.weRecommendLine1": "Pole-",
   "nav.weRecommendLine2": "camy",
   "nav.help": "Pomoc",
+  "help.button": "Wyjaśnij ekran",
+  "help.railLabel": "Przewodnik",
+  "help.pill": "Tryb pomocy: wskaż dowolny element, aby zobaczyć, co robi. Esc, aby wyjść.",
+  "help.helpMode": "Tryb pomocy jest włączony. Wskaż lub kliknij dowolny element, aby zobaczyć, co robi. Esc lub ten przycisk go wyłącza.",
+  "help.website": "Otwiera stemdeck.app w przeglądarce.",
+  "help.upload": "Wybierz plik audio z komputera, aby rozdzielić go na instrumenty.",
+  "help.search": "Wpisz nazwę utworu, aby wyszukać go w sieci, lub wklej link. Możesz też upuścić tu plik audio.",
+  "help.stemAll": "Wyodrębnia każdy instrument w utworze.",
+  "help.stemChip": "Kliknij, aby uwzględnić lub pominąć {name} przy wyodrębnianiu.",
+  "help.vocalCombined": "Zostawia cały śpiew na jednej ścieżce wokalu.",
+  "help.vocalSplit": "Dzieli śpiew na wokal główny i chórki.",
+  "help.detectStructure": "Eksperymentalne. Gdy włączone, następny importowany utwór dostanie oznaczone intro, zwrotki i refreny.",
+  "help.analysisToggle": "Pokazuje lub ukrywa wiersz danych utworu: tonację, tempo, głośność i więcej.",
+  "help.sectionsToggle": "Pokazuje lub ukrywa pasek sekcji, na którym oznaczone są części utworu.",
+  "help.extract": "Zaczyna rozdzielać utwór na instrumenty. Każdy dostaje własną ścieżkę poniżej.",
+  "help.favorite": "Dodaje otwarty utwór do Ulubionych albo go z nich usuwa.",
+  "help.songDetails": "Szczegóły otwartego utworu.",
+  "help.toggleLibrary": "Ukrywa listę utworów, by dać studiu więcej miejsca, albo ją przywraca.",
+  "help.favorites": "Pokazuje tylko utwory, którym dałeś serce.",
+  "help.library": "Pokazuje wszystkie twoje utwory na liście.",
+  "help.lyrics": "Pokazuje tekst utworu, podświetlany linijka po linijce podczas odtwarzania.",
+  "help.trash": "Usunięte utwory czekają tu, aż opróżnisz kosz. Liczba pokazuje, ile ich jest.",
+  "help.queue": "Utwory czekające na rozdzielenie, w kolejności, w jakiej zostaną przetworzone.",
+  "help.notifications": "Wiadomości od StemDeck, na przykład o nowej wersji albo nieudanym imporcie.",
+  "help.recommend": "Artyści, lutnicy i sprzęt warte poznania. StemDeck nie bierze pieniędzy od nikogo z nich.",
+  "help.about": "Linki do strony, GitHuba i Discorda oraz podziękowania.",
+  "help.searchLibrary": "Wpisz część nazwy utworu, aby go znaleźć. Zacznij od #, aby szukać po tagu.",
+  "help.newFolder": "Tworzy folder, w którym możesz porządkować utwory.",
+  "help.trashedSong": "Usunięty utwór. Przytrzymaj go przez sekundę, aby go przywrócić.",
+  "help.song": "Kliknij utwór, aby otworzyć go w studiu.",
+  "help.addSection": "Dodaje sekcję, na przykład zwrotkę lub refren, do paska sekcji.",
+  "help.volume": "Przeciągnij, aby {name} grało głośniej lub ciszej.",
+  "help.laneKeyUp": "Podnosi tylko {name} o półton, najmniejszy krok w muzyce.",
+  "help.laneKeyDown": "Obniża tylko {name} o półton, najmniejszy krok w muzyce.",
+  "help.laneKey": "Tonacja: {name}. K oznacza oryginalną tonację; liczba pokazuje, o ile półtonów ją przesunięto.",
+  "help.mute": "Wycisza {name}, żebyś mógł sam zagrać lub zaśpiewać tę partię.",
+  "help.solo": "Odtwarza tylko {name}, żeby było wyraźnie słychać.",
+  "help.download": "Zapisuje {name} jako osobny plik audio.",
+  "help.songFactsTitle": "Dane utworu",
+  "help.songFacts": "Wyznaczone dla ciebie: tonacja, tempo w BPM, głośność, długość i udział każdego instrumentu.",
+  "help.wavesTitle": "Przebiegi",
+  "help.waves": "Dźwięk każdego instrumentu w czasie. Kliknij, aby przejść do tego momentu. Przeciągnij, aby zapętlić ten fragment.",
+  "help.stop": "Zatrzymuje utwór.",
+  "help.play": "Odtwarza utwór albo go wstrzymuje.",
+  "help.loop": "Włącza lub wyłącza pętlę: fragment między dwoma czasami obok się powtarza. Klawisz L robi to samo.",
+  "help.loopStart": "Gdzie zaczyna się pętla, w sekundach. Przewiń nad nim kółkiem, aby ją przesunąć.",
+  "help.loopEnd": "Gdzie kończy się pętla, w sekundach. Przewiń nad nim kółkiem, aby ją przesunąć.",
+  "help.speedHalf": "Odtwarza w połowie prędkości. Wysokość dźwięku się nie zmienia.",
+  "help.speedSlow": "Odtwarza w trzech czwartych prędkości. Przewiń nad nim kółkiem, aby wybrać prędkość od 0.50x do 0.99x.",
+  "help.speedNormal": "Odtwarza w oryginalnej prędkości utworu.",
+  "help.keyDown": "Obniża cały utwór o półton, najmniejszy krok w muzyce.",
+  "help.keyUp": "Podnosi cały utwór o półton, najmniejszy krok w muzyce.",
+  "help.keyReset": "Przywraca każdą partię do oryginalnej tonacji utworu.",
+  "help.click": "Włącza klik, który podąża za tempem utworu. Klawisz K robi to samo.",
+  "help.clickVolume": "Jak głośny jest klik.",
+  "help.clickMore": "Więcej ustawień kliku.",
+  "help.export": "Zapisuje to, co słyszysz, jako jeden plik audio. Jego menu oferuje też każdą partię w .zip albo tylko zapętlony fragment.",
+  "help.set.language": "Język aplikacji.",
+  "help.set.maxDuration": "Najdłuższy przyjmowany utwór, w minutach.",
+  "help.set.playlistLimit": "Najwięcej utworów, jakie doda jedna playlista.",
+  "help.set.cookies": "Potrzebne tylko, gdy YouTube poprosi o potwierdzenie, że nie jesteś botem.",
+  "help.set.stemsLocation": "Gdzie zapisywane są rozdzielone utwory.",
+  "help.set.exportsLocation": "Dokąd trafiają ścieżki i pętle przeciągnięte poza StemDeck.",
+  "help.set.autoDelete": "Wyłączone, dopóki tego nie włączysz. Usuwa utwory po wybranej liczbie dni.",
+  "help.set.device": "Twoja karta graficzna lub procesor, do rozdzielania.",
+  "help.set.quality": "Best daje czystsze ścieżki i trwa dwa razy dłużej.",
+  "help.set.exportLogs": "Wszystkie logi w jednym zipie, do zgłoszenia błędu.",
+  "help.set.resetData": "Usuwa wszystkie utwory. Nie można tego cofnąć.",
+  "help.set.acoustid": "Rozpoznaje każdy utwór po brzmieniu, z darmowym kluczem AcoustID.",
+  "help.set.discogs": "Profile zespołów i wydania, z darmowym tokenem Discogs.",
+  "help.set.transcribe": "Spisuje tekst z wokalu, gdy nie znaleziono tekstu utworu.",
+  "help.set.network": "Otwórz StemDeck na telefonie lub tablecie w tej samej sieci Wi-Fi. Zeskanuj kod QR lub wpisz pokazany adres.",
+  "help.set.port": "Port, na którym działa StemDeck. Uruchom ponownie, aby zastosować.",
+  "help.set.sampleRate": "Częstotliwość próbkowania eksportowanych plików audio.",
+  "help.set.videoQuality": "Jakość eksportowanych filmów.",
+  "help.set.logs": "Gdzie są logi oraz logi aplikacji, serwera i instalacji.",
+  "help.set.registry": "Lista ukończonych utworów, którą StemDeck trzyma na dysku. Tylko do odczytu.",
 
   "search.ariaLabel": "Szukaj w bibliotece",
   "search.placeholder": "Szukaj lub #tag…",
@@ -2056,6 +2210,83 @@ const ja = {
   "nav.weRecommendLine1": "おす",
   "nav.weRecommendLine2": "すめ",
   "nav.help": "ヘルプ",
+  "help.button": "画面を説明",
+  "help.railLabel": "ガイド",
+  "help.pill": "ヘルプモード：項目を指すと、その働きが表示されます。Esc で終了。",
+  "help.helpMode": "ヘルプモードがオンです。項目を指すかクリックすると、その働きが表示されます。Esc かこのボタンで終了します。",
+  "help.website": "ブラウザで stemdeck.app を開きます。",
+  "help.upload": "パソコンから音声ファイルを選び、楽器ごとに分けます。",
+  "help.search": "曲名を入力してオンラインで検索するか、リンクを貼り付けます。音声ファイルをここにドロップすることもできます。",
+  "help.stemAll": "曲に含まれるすべての楽器を抽出します。",
+  "help.stemChip": "クリックすると、抽出に{name}を含めるか外すかを切り替えます。",
+  "help.vocalCombined": "歌声をすべて 1 つのボーカルレーンにまとめます。",
+  "help.vocalSplit": "歌声をリードボーカルとバックボーカルに分けます。",
+  "help.detectStructure": "実験的機能。オンにすると、次に取り込む曲のイントロ、Aメロ、サビに印が付きます。",
+  "help.analysisToggle": "キー、テンポ、ラウドネスなど、曲の情報の行を表示または非表示にします。",
+  "help.sectionsToggle": "曲のパートが示されるセクションバーを表示または非表示にします。",
+  "help.extract": "曲を楽器ごとに分け始めます。それぞれ下に専用のレーンができます。",
+  "help.favorite": "開いている曲をお気に入りに追加するか、外します。",
+  "help.songDetails": "開いている曲の詳細です。",
+  "help.toggleLibrary": "曲リストを隠してスタジオを広くするか、元に戻します。",
+  "help.favorites": "ハートを付けた曲だけを表示します。",
+  "help.library": "すべての曲をリストに表示します。",
+  "help.lyrics": "曲の歌詞を表示し、再生に合わせて 1 行ずつ光ります。",
+  "help.trash": "削除した曲は、ゴミ箱を空にするまでここに残ります。数字は曲の数です。",
+  "help.queue": "分離を待っている曲を、処理される順に並べています。",
+  "help.notifications": "新しいリリースや失敗した取り込みなど、StemDeck からのお知らせです。",
+  "help.recommend": "知っておきたいアーティスト、楽器職人、機材です。StemDeck はどこからもお金を受け取っていません。",
+  "help.about": "ウェブサイト、GitHub、Discord へのリンクとクレジットです。",
+  "help.searchLibrary": "曲名の一部を入力して探します。# から始めるとタグで探せます。",
+  "help.newFolder": "曲を整理するためのフォルダーを作ります。",
+  "help.trashedSong": "削除した曲です。1 秒長押しすると元に戻ります。",
+  "help.song": "曲をクリックするとスタジオで開きます。",
+  "help.addSection": "Aメロやサビなどのセクションをセクションバーに追加します。",
+  "help.volume": "ドラッグして{name}の音量を上げ下げします。",
+  "help.laneKeyUp": "{name}だけを半音上げます。半音は音楽で最も小さな音程の単位です。",
+  "help.laneKeyDown": "{name}だけを半音下げます。半音は音楽で最も小さな音程の単位です。",
+  "help.laneKey": "{name}のキーです。K は元のキー、数字は何半音動かしたかを示します。",
+  "help.mute": "{name}をミュートします。そのパートを自分で演奏したり歌ったりできます。",
+  "help.solo": "{name}だけを再生して、はっきり聞けるようにします。",
+  "help.download": "{name}を単独の音声ファイルとして保存します。",
+  "help.songFactsTitle": "曲の情報",
+  "help.songFacts": "キー、BPM で表したテンポ、ラウドネス、長さ、各楽器の割合を自動で調べています。",
+  "help.wavesTitle": "波形",
+  "help.waves": "各楽器の音を時間に沿って描いたものです。クリックでその位置へ移動し、ドラッグでその部分をループします。",
+  "help.stop": "曲を止めます。",
+  "help.play": "曲を再生、または一時停止します。",
+  "help.loop": "ループのオンとオフを切り替えます。横の 2 つの時間の間が繰り返されます。L キーでも同じです。",
+  "help.loopStart": "ループの開始位置(秒)です。上でスクロールすると動かせます。",
+  "help.loopEnd": "ループの終了位置(秒)です。上でスクロールすると動かせます。",
+  "help.speedHalf": "半分の速さで再生します。音の高さは変わりません。",
+  "help.speedSlow": "4 分の 3 の速さで再生します。上でスクロールすると 0.50x から 0.99x の間で選べます。",
+  "help.speedNormal": "曲本来の速さで再生します。",
+  "help.keyDown": "曲全体を半音下げます。半音は音楽で最も小さな音程の単位です。",
+  "help.keyUp": "曲全体を半音上げます。半音は音楽で最も小さな音程の単位です。",
+  "help.keyReset": "すべてのパートを曲の元のキーに戻します。",
+  "help.click": "曲のテンポに合わせたクリックをオンにします。K キーでも同じです。",
+  "help.clickVolume": "クリックの音量です。",
+  "help.clickMore": "クリックのその他の設定です。",
+  "help.export": "聞こえている音を 1 つの音声ファイルとして保存します。メニューから、全パートの .zip やループ部分だけも選べます。",
+  "help.set.language": "アプリの表示言語です。",
+  "help.set.maxDuration": "受け付ける曲の最大の長さ(分)です。",
+  "help.set.playlistLimit": "1 つのプレイリストで追加される曲の最大数です。",
+  "help.set.cookies": "YouTube にボットでないことの確認を求められたときだけ必要です。",
+  "help.set.stemsLocation": "分離した曲の保存場所です。",
+  "help.set.exportsLocation": "StemDeck からドラッグしたステムやループの保存先です。",
+  "help.set.autoDelete": "オンにしない限りオフです。指定した日数が過ぎた曲を削除します。",
+  "help.set.device": "分離に使うグラフィックカードまたはプロセッサーです。",
+  "help.set.quality": "Best はステムがよりきれいになり、時間が 2 倍かかります。",
+  "help.set.exportLogs": "すべてのログを 1 つの zip にまとめます。不具合の報告に添付できます。",
+  "help.set.resetData": "すべての曲を削除します。元に戻せません。",
+  "help.set.acoustid": "無料の AcoustID キーで、音から各曲を識別します。",
+  "help.set.discogs": "無料の Discogs トークンで、バンドのプロフィールとリリースを取得します。",
+  "help.set.transcribe": "歌詞が見つからないとき、ボーカルから歌詞を書き起こします。",
+  "help.set.network": "同じ Wi-Fi のスマートフォンやタブレットで StemDeck を開けます。QR コードを読み取るか、表示されたアドレスを入力します。",
+  "help.set.port": "StemDeck が動くポートです。再起動すると反映されます。",
+  "help.set.sampleRate": "書き出す音声ファイルのサンプルレートです。",
+  "help.set.videoQuality": "書き出す動画の画質です。",
+  "help.set.logs": "ログの保存場所と、アプリ、バックエンド、セットアップのログです。",
+  "help.set.registry": "StemDeck がディスクに保存している完了した曲の一覧です。読み取り専用です。",
 
   "search.ariaLabel": "ライブラリを検索",
   "search.placeholder": "検索または#タグ…",
@@ -2833,6 +3064,83 @@ const zhHans = {
   "nav.weRecommendLine1": "推",
   "nav.weRecommendLine2": "荐",
   "nav.help": "帮助",
+  "help.button": "讲解界面",
+  "help.railLabel": "指南",
+  "help.pill": "帮助模式：指向任何项目即可看到它的作用。按 Esc 退出。",
+  "help.helpMode": "帮助模式已开启。指向或点击任何项目即可看到它的作用。按 Esc 或此按钮退出。",
+  "help.website": "在浏览器中打开 stemdeck.app。",
+  "help.upload": "从电脑中选择一个音频文件，把它分离成各个乐器。",
+  "help.search": "输入歌名在线搜索，或粘贴链接。也可以把音频文件拖到这里。",
+  "help.stemAll": "提取歌曲中的所有乐器。",
+  "help.stemChip": "点击以在提取时包含或排除{name}。",
+  "help.vocalCombined": "把所有歌声保留在一条人声音轨中。",
+  "help.vocalSplit": "把歌声分成主唱和和声。",
+  "help.detectStructure": "实验功能。开启后，下一首导入的歌曲会自动标出前奏、主歌和副歌。",
+  "help.analysisToggle": "显示或隐藏歌曲信息行：调性、速度、响度等。",
+  "help.sectionsToggle": "显示或隐藏段落栏，歌曲的各个部分在那里标出。",
+  "help.extract": "开始把歌曲分离成各个乐器。每个乐器在下方有自己的音轨。",
+  "help.favorite": "把当前歌曲加入收藏，或移出收藏。",
+  "help.songDetails": "当前歌曲的详细信息。",
+  "help.toggleLibrary": "隐藏歌曲列表让工作室更宽敞，或重新显示。",
+  "help.favorites": "只显示你点了心的歌曲。",
+  "help.library": "在列表中显示你的所有歌曲。",
+  "help.lyrics": "显示歌词，播放时逐行点亮。",
+  "help.trash": "删除的歌曲会留在这里，直到你清空回收站。数字表示有多少首。",
+  "help.queue": "等待分离的歌曲，按处理顺序排列。",
+  "help.notifications": "来自 StemDeck 的消息，例如新版本或导入失败。",
+  "help.recommend": "值得认识的艺术家、乐器制作者和设备。StemDeck 不接受其中任何一方的钱。",
+  "help.about": "网站、GitHub 和 Discord 的链接，以及致谢。",
+  "help.searchLibrary": "输入歌名的一部分来查找。以 # 开头可按标签查找。",
+  "help.newFolder": "新建文件夹，用来整理歌曲。",
+  "help.trashedSong": "已删除的歌曲。按住一秒即可恢复。",
+  "help.song": "点击歌曲，在工作室中打开它。",
+  "help.addSection": "在段落栏中添加一个段落，例如主歌或副歌。",
+  "help.volume": "拖动以调大或调小{name}的音量。",
+  "help.laneKeyUp": "只把{name}升高一个半音，半音是音乐中最小的音程。",
+  "help.laneKeyDown": "只把{name}降低一个半音，半音是音乐中最小的音程。",
+  "help.laneKey": "{name}的调。K 表示原调；数字表示移动了几个半音。",
+  "help.mute": "将{name}静音，让你自己演奏或演唱这一部分。",
+  "help.solo": "只播放{name}，听得更清楚。",
+  "help.download": "把{name}保存为单独的音频文件。",
+  "help.songFactsTitle": "歌曲信息",
+  "help.songFacts": "已为你分析：调性、以 BPM 表示的速度、响度、时长，以及每种乐器的占比。",
+  "help.wavesTitle": "波形",
+  "help.waves": "每种乐器的声音随时间的变化。点击跳到那一刻，拖动可循环那一段。",
+  "help.stop": "停止播放。",
+  "help.play": "播放歌曲，或暂停。",
+  "help.loop": "开启或关闭循环：旁边两个时间之间的部分会重复。按 L 键效果相同。",
+  "help.loopStart": "循环的开始位置，单位为秒。在上面滚动即可移动。",
+  "help.loopEnd": "循环的结束位置，单位为秒。在上面滚动即可移动。",
+  "help.speedHalf": "以一半速度播放，音高不变。",
+  "help.speedSlow": "以四分之三速度播放。在上面滚动可选择 0.50x 到 0.99x 之间的任意速度。",
+  "help.speedNormal": "以歌曲原速播放。",
+  "help.keyDown": "把整首歌降低一个半音，半音是音乐中最小的音程。",
+  "help.keyUp": "把整首歌升高一个半音，半音是音乐中最小的音程。",
+  "help.keyReset": "把每一部分恢复到歌曲的原调。",
+  "help.click": "开启跟随歌曲速度的节拍声。按 K 键效果相同。",
+  "help.clickVolume": "节拍声的音量。",
+  "help.clickMore": "节拍声的更多设置。",
+  "help.export": "把你听到的内容保存为一个音频文件。菜单中还可以把每个部分打包为 .zip，或只导出循环部分。",
+  "help.set.language": "应用的显示语言。",
+  "help.set.maxDuration": "可接受的最长歌曲，单位为分钟。",
+  "help.set.playlistLimit": "一个播放列表最多添加的歌曲数。",
+  "help.set.cookies": "只有在 YouTube 要求你证明自己不是机器人时才需要。",
+  "help.set.stemsLocation": "分离后歌曲的存放位置。",
+  "help.set.exportsLocation": "从 StemDeck 拖出的音轨和循环的存放位置。",
+  "help.set.autoDelete": "默认关闭。开启后会在你设定的天数后删除歌曲。",
+  "help.set.device": "用于分离的显卡或处理器。",
+  "help.set.quality": "Best 的分离更干净，耗时是两倍。",
+  "help.set.exportLogs": "把所有日志打包成一个 zip，可附在错误报告中。",
+  "help.set.resetData": "删除所有歌曲，无法撤销。",
+  "help.set.acoustid": "使用免费的 AcoustID 密钥，按声音识别每首歌曲。",
+  "help.set.discogs": "使用免费的 Discogs 令牌，获取乐队资料和发行信息。",
+  "help.set.transcribe": "找不到歌词时，从人声中转写歌词。",
+  "help.set.network": "在同一 Wi-Fi 下用手机或平板打开 StemDeck。扫描二维码，或输入显示的地址。",
+  "help.set.port": "StemDeck 运行的端口。重启后生效。",
+  "help.set.sampleRate": "导出音频文件的采样率。",
+  "help.set.videoQuality": "导出视频的画质。",
+  "help.set.logs": "日志的位置，以及应用、后端和安装日志。",
+  "help.set.registry": "StemDeck 保存在磁盘上的已完成歌曲列表。只读。",
 
   "search.ariaLabel": "搜索资料库",
   "search.placeholder": "搜索或 #标签…",
@@ -3610,6 +3918,83 @@ const de = {
   "nav.weRecommendLine1": "Wir",
   "nav.weRecommendLine2": "empfehlen",
   "nav.help": "Hilfe",
+  "help.button": "Bildschirm erklären",
+  "help.railLabel": "Anleitung",
+  "help.pill": "Hilfemodus: Zeig auf etwas, um zu sehen, was es tut. Esc zum Beenden.",
+  "help.helpMode": "Der Hilfemodus ist an. Zeig auf etwas oder klick es an, um zu sehen, was es tut. Esc oder dieser Button beendet ihn.",
+  "help.website": "Öffnet stemdeck.app in deinem Browser.",
+  "help.upload": "Wähle eine Audiodatei auf deinem Computer, um sie in ihre Instrumente zu zerlegen.",
+  "help.search": "Gib einen Songnamen ein, um online danach zu suchen, oder füge einen Link ein. Du kannst auch eine Audiodatei hierher ziehen.",
+  "help.stemAll": "Extrahiert jedes Instrument, das der Song hat.",
+  "help.stemChip": "Klick, um {name} beim Extrahieren mitzunehmen oder wegzulassen.",
+  "help.vocalCombined": "Behält den ganzen Gesang in einer Vocals-Spur.",
+  "help.vocalSplit": "Teilt den Gesang in Leadstimme und Begleitstimmen.",
+  "help.detectStructure": "Experimentell. Wenn an, bekommt der nächste importierte Song Intro, Strophe und Refrain markiert.",
+  "help.analysisToggle": "Zeigt oder versteckt die Zeile mit den Songdaten: Tonart, Tempo, Lautheit und mehr.",
+  "help.sectionsToggle": "Zeigt oder versteckt die Abschnittsleiste, in der die Teile des Songs markiert sind.",
+  "help.extract": "Startet das Zerlegen des Songs in seine Instrumente. Jedes bekommt unten eine eigene Spur.",
+  "help.favorite": "Fügt den offenen Song zu den Favoriten hinzu oder nimmt ihn wieder heraus.",
+  "help.songDetails": "Details zum offenen Song.",
+  "help.toggleLibrary": "Blendet die Songliste aus, damit das Studio mehr Platz hat, oder holt sie zurück.",
+  "help.favorites": "Zeigt nur die Songs, denen du ein Herz gegeben hast.",
+  "help.library": "Zeigt alle deine Songs in der Liste.",
+  "help.lyrics": "Zeigt den Songtext, Zeile für Zeile hervorgehoben, während der Song läuft.",
+  "help.trash": "Gelöschte Songs warten hier, bis du den Papierkorb leerst. Die Zahl zeigt, wie viele es sind.",
+  "help.queue": "Die Songs, die auf das Zerlegen warten, in der Reihenfolge, in der sie drankommen.",
+  "help.notifications": "Nachrichten von StemDeck, etwa eine neue Version oder ein fehlgeschlagener Import.",
+  "help.recommend": "Künstler, Instrumentenbauer und Equipment, die man kennen sollte. StemDeck nimmt von keinem davon Geld.",
+  "help.about": "Links zur Website, zu GitHub und Discord, und die Credits.",
+  "help.searchLibrary": "Gib einen Teil des Songnamens ein, um ihn zu finden. Beginne mit #, um nach Tag zu suchen.",
+  "help.newFolder": "Legt einen Ordner an, damit du deine Songs sortieren kannst.",
+  "help.trashedSong": "Ein gelöschter Song. Halte ihn eine Sekunde lang gedrückt, um ihn zurückzuholen.",
+  "help.song": "Klick auf einen Song, um ihn im Studio zu öffnen.",
+  "help.addSection": "Fügt der Abschnittsleiste einen Abschnitt hinzu, etwa eine Strophe oder einen Refrain.",
+  "help.volume": "Zieh, um {name} lauter oder leiser zu machen.",
+  "help.laneKeyUp": "Hebt nur {name} um einen Halbton an, den kleinsten Schritt in der Musik.",
+  "help.laneKeyDown": "Senkt nur {name} um einen Halbton, den kleinsten Schritt in der Musik.",
+  "help.laneKey": "Die Tonart von {name}. K heißt Originaltonart; eine Zahl zeigt, um wie viele Halbtöne verschoben wurde.",
+  "help.mute": "Schaltet {name} stumm, damit du diesen Part selbst spielen oder singen kannst.",
+  "help.solo": "Spielt nur {name}, damit du es deutlich hörst.",
+  "help.download": "Speichert {name} als eigene Audiodatei.",
+  "help.songFactsTitle": "Songdaten",
+  "help.songFacts": "Für dich ermittelt: Tonart, Tempo in BPM, Lautheit, Länge und wie viel von jedem Instrument der Song hat.",
+  "help.wavesTitle": "Wellenformen",
+  "help.waves": "Der Klang jedes Instruments über die Zeit. Klick, um an diese Stelle zu springen. Zieh darüber, um diesen Teil zu loopen.",
+  "help.stop": "Stoppt den Song.",
+  "help.play": "Spielt den Song ab oder pausiert ihn.",
+  "help.loop": "Schaltet den Loop an oder aus: Der Teil zwischen den beiden Zeiten daneben wiederholt sich. Die Taste L tut dasselbe.",
+  "help.loopStart": "Wo der Loop beginnt, in Sekunden. Scroll darüber, um ihn zu verschieben.",
+  "help.loopEnd": "Wo der Loop endet, in Sekunden. Scroll darüber, um ihn zu verschieben.",
+  "help.speedHalf": "Spielt mit halber Geschwindigkeit. Die Tonhöhe bleibt gleich.",
+  "help.speedSlow": "Spielt mit drei Viertel der Geschwindigkeit. Scroll darüber, um jede Geschwindigkeit von 0.50x bis 0.99x zu wählen.",
+  "help.speedNormal": "Spielt in der Originalgeschwindigkeit des Songs.",
+  "help.keyDown": "Senkt den ganzen Song um einen Halbton, den kleinsten Schritt in der Musik.",
+  "help.keyUp": "Hebt den ganzen Song um einen Halbton an, den kleinsten Schritt in der Musik.",
+  "help.keyReset": "Setzt jeden Part zurück in die Originaltonart des Songs.",
+  "help.click": "Schaltet einen Klick an, der dem Tempo des Songs folgt. Die Taste K tut dasselbe.",
+  "help.clickVolume": "Wie laut der Klick ist.",
+  "help.clickMore": "Weitere Einstellungen für den Klick.",
+  "help.export": "Speichert, was du hörst, als eine Audiodatei. Sein Menü bietet auch jeden Part als .zip oder nur den geloopten Teil.",
+  "help.set.language": "Die Sprache der App.",
+  "help.set.maxDuration": "Der längste Song, der angenommen wird, in Minuten.",
+  "help.set.playlistLimit": "Die meisten Songs, die eine Playlist hinzufügt.",
+  "help.set.cookies": "Nur nötig, wenn YouTube verlangt, dass du beweist, kein Bot zu sein.",
+  "help.set.stemsLocation": "Wo deine zerlegten Songs gespeichert werden.",
+  "help.set.exportsLocation": "Wohin Stems und Loops gehen, die du aus StemDeck herausziehst.",
+  "help.set.autoDelete": "Aus, solange du es nicht einschaltest. Löscht Songs nach der Anzahl Tage, die du festlegst.",
+  "help.set.device": "Deine Grafikkarte oder dein Prozessor, für das Zerlegen.",
+  "help.set.quality": "Best liefert sauberere Stems und dauert doppelt so lange.",
+  "help.set.exportLogs": "Alle Logs in einer Zip-Datei, für einen Fehlerbericht.",
+  "help.set.resetData": "Löscht jeden Song. Lässt sich nicht rückgängig machen.",
+  "help.set.acoustid": "Erkennt jeden Song an seinem Klang, mit einem kostenlosen AcoustID-Schlüssel.",
+  "help.set.discogs": "Bandprofile und Veröffentlichungen, mit einem kostenlosen Discogs-Token.",
+  "help.set.transcribe": "Schreibt den Text aus dem Gesang mit, wenn kein Songtext gefunden wird.",
+  "help.set.network": "Öffne StemDeck auf deinem Handy oder Tablet im selben WLAN. Scanne den QR-Code oder tippe die angezeigte Adresse ein.",
+  "help.set.port": "Der Port, auf dem StemDeck läuft. Neustart zum Übernehmen.",
+  "help.set.sampleRate": "Die Abtastrate der Audiodateien, die du exportierst.",
+  "help.set.videoQuality": "Die Qualität der Videos, die du exportierst.",
+  "help.set.logs": "Wo die Logs liegen, und das Anwendungs-, Backend- und Setup-Log.",
+  "help.set.registry": "Die Liste der fertigen Songs, die StemDeck auf der Festplatte führt. Nur lesbar.",
 
   "search.ariaLabel": "Bibliothek durchsuchen",
   "search.placeholder": "Suchen oder #Tag…",
@@ -4398,6 +4783,83 @@ const pt = {
   "nav.weRecommendLine1": "Recomen-",
   "nav.weRecommendLine2": "damos",
   "nav.help": "Ajuda",
+  "help.button": "Explicar a tela",
+  "help.railLabel": "Guia",
+  "help.pill": "Modo ajuda: aponte para qualquer coisa para ver o que faz. Esc para sair.",
+  "help.helpMode": "O modo ajuda está ligado. Aponte ou clique em algo para ver o que faz. Pressione Esc ou este botão para sair.",
+  "help.website": "Abre stemdeck.app no seu navegador.",
+  "help.upload": "Escolha um arquivo de áudio do seu computador para separar em instrumentos.",
+  "help.search": "Digite o nome de uma música para buscar online, ou cole um link. Você também pode soltar um arquivo de áudio aqui.",
+  "help.stemAll": "Extrai todos os instrumentos da música.",
+  "help.stemChip": "Clique para incluir ou deixar de fora {name} na extração.",
+  "help.vocalCombined": "Mantém todo o canto em uma única faixa de Vocais.",
+  "help.vocalSplit": "Separa o canto na voz principal e nos backing vocals.",
+  "help.detectStructure": "Experimental. Ligado, a próxima música importada recebe a intro, os versos e os refrões marcados.",
+  "help.analysisToggle": "Mostra ou esconde a linha de dados da música: tom, andamento, volume e mais.",
+  "help.sectionsToggle": "Mostra ou esconde a barra de seções, onde as partes da música são marcadas.",
+  "help.extract": "Começa a separar a música em instrumentos. Cada um ganha sua própria faixa abaixo.",
+  "help.favorite": "Adiciona a música aberta aos Favoritos, ou a retira.",
+  "help.songDetails": "Detalhes da música aberta.",
+  "help.toggleLibrary": "Esconde a lista de músicas para dar mais espaço ao estúdio, ou a traz de volta.",
+  "help.favorites": "Mostra só as músicas que você marcou com coração.",
+  "help.library": "Mostra todas as suas músicas na lista.",
+  "help.lyrics": "Mostra a letra, iluminada linha por linha enquanto toca.",
+  "help.trash": "As músicas apagadas esperam aqui até você esvaziar a lixeira. O número mostra quantas há.",
+  "help.queue": "As músicas esperando para serem separadas, na ordem em que serão feitas.",
+  "help.notifications": "Mensagens do StemDeck, como uma nova versão ou uma importação que falhou.",
+  "help.recommend": "Artistas, luthiers e equipamentos que vale a pena conhecer. O StemDeck não recebe dinheiro de nenhum deles.",
+  "help.about": "Links para o site, GitHub e Discord, e os créditos.",
+  "help.searchLibrary": "Digite parte do nome de uma música para encontrá-la. Comece com # para buscar por tag.",
+  "help.newFolder": "Cria uma pasta para organizar suas músicas.",
+  "help.trashedSong": "Uma música apagada. Segure-a por um segundo para trazê-la de volta.",
+  "help.song": "Clique em uma música para abri-la no estúdio.",
+  "help.addSection": "Adiciona uma seção, como um verso ou um refrão, à barra de seções.",
+  "help.volume": "Arraste para deixar {name} mais alto ou mais baixo.",
+  "help.laneKeyUp": "Sobe só {name} um semitom, o menor passo na música.",
+  "help.laneKeyDown": "Desce só {name} um semitom, o menor passo na música.",
+  "help.laneKey": "O tom de {name}. K quer dizer o tom original; um número mostra quantos semitons ele mudou.",
+  "help.mute": "Silencia {name}, para você tocar ou cantar essa parte.",
+  "help.solo": "Toca só {name}, para ouvir com clareza.",
+  "help.download": "Salva {name} como um arquivo de áudio separado.",
+  "help.songFactsTitle": "Dados da música",
+  "help.songFacts": "Encontrados para você: o tom, o andamento em BPM, o volume, a duração e quanto há de cada instrumento.",
+  "help.wavesTitle": "Formas de onda",
+  "help.waves": "O som de cada instrumento ao longo do tempo. Clique para pular para esse momento. Arraste para repetir esse trecho em loop.",
+  "help.stop": "Para a música.",
+  "help.play": "Toca a música, ou pausa.",
+  "help.loop": "Liga ou desliga o loop: o trecho entre os dois tempos ao lado se repete. A tecla L faz o mesmo.",
+  "help.loopStart": "Onde o loop começa, em segundos. Role sobre ele para mudar.",
+  "help.loopEnd": "Onde o loop termina, em segundos. Role sobre ele para mudar.",
+  "help.speedHalf": "Toca na metade da velocidade. O tom continua o mesmo.",
+  "help.speedSlow": "Toca a três quartos da velocidade. Role sobre ele para escolher qualquer velocidade de 0.50x a 0.99x.",
+  "help.speedNormal": "Toca na velocidade original da música.",
+  "help.keyDown": "Desce a música inteira um semitom, o menor passo na música.",
+  "help.keyUp": "Sobe a música inteira um semitom, o menor passo na música.",
+  "help.keyReset": "Volta cada parte para o tom original da música.",
+  "help.click": "Liga um clique que segue o andamento da música. A tecla K faz o mesmo.",
+  "help.clickVolume": "O volume do clique.",
+  "help.clickMore": "Mais ajustes do clique.",
+  "help.export": "Salva o que você ouve em um único arquivo de áudio. O menu também oferece cada parte em um .zip, ou só o trecho em loop.",
+  "help.set.language": "O idioma do app.",
+  "help.set.maxDuration": "A música mais longa aceita, em minutos.",
+  "help.set.playlistLimit": "O máximo de músicas que uma playlist adiciona.",
+  "help.set.cookies": "Só é preciso se o YouTube pedir para você provar que não é um robô.",
+  "help.set.stemsLocation": "Onde suas músicas separadas ficam guardadas.",
+  "help.set.exportsLocation": "Para onde vão as faixas e loops que você arrasta para fora do StemDeck.",
+  "help.set.autoDelete": "Desligado a menos que você ligue. Apaga músicas depois do número de dias que você escolher.",
+  "help.set.device": "Sua placa de vídeo ou seu processador, para separar.",
+  "help.set.quality": "Best dá faixas mais limpas e leva o dobro do tempo.",
+  "help.set.exportLogs": "Todos os logs em um zip, para anexar a um relatório de bug.",
+  "help.set.resetData": "Apaga todas as músicas. Não pode ser desfeito.",
+  "help.set.acoustid": "Reconhece cada música pelo som, com uma chave grátis do AcoustID.",
+  "help.set.discogs": "Perfis de bandas e lançamentos, com um token grátis do Discogs.",
+  "help.set.transcribe": "Escreve a letra a partir da voz quando nenhuma é encontrada.",
+  "help.set.network": "Abra o StemDeck no seu celular ou tablet, no mesmo Wi-Fi. Leia o QR code ou digite o endereço mostrado.",
+  "help.set.port": "A porta em que o StemDeck roda. Reinicie para aplicar.",
+  "help.set.sampleRate": "A taxa de amostragem dos arquivos de áudio que você exporta.",
+  "help.set.videoQuality": "A qualidade dos vídeos que você exporta.",
+  "help.set.logs": "Onde ficam os logs, e os logs do aplicativo, do servidor e da instalação.",
+  "help.set.registry": "A lista de músicas prontas que o StemDeck guarda no disco. Só leitura.",
 
   "search.ariaLabel": "Pesquisar biblioteca",
   "search.placeholder": "Pesquisar ou #tag…",
@@ -5188,6 +5650,83 @@ const id = {
   "nav.weRecommendLine1": "Rekomen-",
   "nav.weRecommendLine2": "dasi",
   "nav.help": "Bantuan",
+  "help.button": "Jelaskan layar",
+  "help.railLabel": "Panduan",
+  "help.pill": "Mode bantuan: arahkan ke apa saja untuk melihat fungsinya. Esc untuk keluar.",
+  "help.helpMode": "Mode bantuan aktif. Arahkan atau klik apa saja untuk melihat fungsinya. Tekan Esc atau tombol ini untuk keluar.",
+  "help.website": "Membuka stemdeck.app di browser Anda.",
+  "help.upload": "Pilih file audio dari komputer Anda untuk dipisahkan menjadi instrumen.",
+  "help.search": "Ketik nama lagu untuk mencarinya secara online, atau tempel tautan. Anda juga bisa menjatuhkan file audio di sini.",
+  "help.stemAll": "Mengekstrak setiap instrumen dalam lagu.",
+  "help.stemChip": "Klik untuk menyertakan atau melewatkan {name} saat mengekstrak.",
+  "help.vocalCombined": "Menyimpan semua nyanyian dalam satu jalur Vokal.",
+  "help.vocalSplit": "Memisahkan nyanyian menjadi vokal utama dan vokal latar.",
+  "help.detectStructure": "Eksperimental. Jika aktif, lagu berikutnya yang Anda impor ditandai intro, bait, dan reff-nya.",
+  "help.analysisToggle": "Menampilkan atau menyembunyikan baris data lagu: kunci nada, tempo, kekerasan suara, dan lainnya.",
+  "help.sectionsToggle": "Menampilkan atau menyembunyikan bilah bagian, tempat bagian-bagian lagu ditandai.",
+  "help.extract": "Mulai memisahkan lagu menjadi instrumen. Masing-masing mendapat jalurnya sendiri di bawah.",
+  "help.favorite": "Menambahkan lagu yang terbuka ke Favorit, atau mengeluarkannya.",
+  "help.songDetails": "Detail tentang lagu yang terbuka.",
+  "help.toggleLibrary": "Menyembunyikan daftar lagu agar studio lebih luas, atau menampilkannya kembali.",
+  "help.favorites": "Hanya menampilkan lagu yang Anda beri hati.",
+  "help.library": "Menampilkan semua lagu Anda di daftar.",
+  "help.lyrics": "Menampilkan lirik lagu, menyala baris demi baris saat diputar.",
+  "help.trash": "Lagu yang dihapus menunggu di sini sampai Anda mengosongkan Sampah. Angkanya menunjukkan jumlahnya.",
+  "help.queue": "Lagu yang menunggu untuk dipisahkan, sesuai urutan pengerjaannya.",
+  "help.notifications": "Pesan dari StemDeck, seperti rilis baru atau impor yang gagal.",
+  "help.recommend": "Artis, pembuat instrumen, dan peralatan yang layak dikenal. StemDeck tidak menerima uang dari mereka.",
+  "help.about": "Tautan ke situs web, GitHub, dan Discord, serta kredit.",
+  "help.searchLibrary": "Ketik sebagian nama lagu untuk menemukannya. Mulai dengan # untuk mencari menurut tag.",
+  "help.newFolder": "Membuat folder untuk mengatur lagu Anda.",
+  "help.trashedSong": "Lagu yang dihapus. Tahan selama satu detik untuk mengembalikannya.",
+  "help.song": "Klik lagu untuk membukanya di studio.",
+  "help.addSection": "Menambahkan bagian, seperti bait atau reff, ke bilah bagian.",
+  "help.volume": "Geser untuk membuat {name} lebih keras atau lebih pelan.",
+  "help.laneKeyUp": "Menaikkan hanya {name} satu semitone, langkah terkecil dalam musik.",
+  "help.laneKeyDown": "Menurunkan hanya {name} satu semitone, langkah terkecil dalam musik.",
+  "help.laneKey": "Kunci nada {name}. K berarti kunci aslinya; angka menunjukkan berapa semitone digeser.",
+  "help.mute": "Membisukan {name}, agar Anda bisa memainkan atau menyanyikan bagian itu sendiri.",
+  "help.solo": "Hanya memutar {name}, agar terdengar jelas.",
+  "help.download": "Menyimpan {name} sebagai file audio tersendiri.",
+  "help.songFactsTitle": "Data lagu",
+  "help.songFacts": "Ditemukan untuk Anda: kunci nada, tempo dalam BPM, kekerasan suara, durasi, dan seberapa banyak tiap instrumen.",
+  "help.wavesTitle": "Bentuk gelombang",
+  "help.waves": "Suara tiap instrumen dari waktu ke waktu. Klik untuk melompat ke saat itu. Seret untuk mengulang bagian itu.",
+  "help.stop": "Menghentikan lagu.",
+  "help.play": "Memutar lagu, atau menjedanya.",
+  "help.loop": "Menyalakan atau mematikan pengulangan: bagian di antara dua waktu di sebelahnya diulang. Tombol L melakukan hal yang sama.",
+  "help.loopStart": "Tempat pengulangan dimulai, dalam detik. Gulir di atasnya untuk memindahkannya.",
+  "help.loopEnd": "Tempat pengulangan berakhir, dalam detik. Gulir di atasnya untuk memindahkannya.",
+  "help.speedHalf": "Memutar dengan setengah kecepatan. Nadanya tetap sama.",
+  "help.speedSlow": "Memutar dengan tiga perempat kecepatan. Gulir di atasnya untuk memilih kecepatan dari 0.50x sampai 0.99x.",
+  "help.speedNormal": "Memutar dengan kecepatan asli lagu.",
+  "help.keyDown": "Menurunkan seluruh lagu satu semitone, langkah terkecil dalam musik.",
+  "help.keyUp": "Menaikkan seluruh lagu satu semitone, langkah terkecil dalam musik.",
+  "help.keyReset": "Mengembalikan setiap bagian ke kunci nada asli lagu.",
+  "help.click": "Menyalakan ketukan yang mengikuti tempo lagu. Tombol K melakukan hal yang sama.",
+  "help.clickVolume": "Seberapa keras ketukannya.",
+  "help.clickMore": "Pengaturan lain untuk ketukan.",
+  "help.export": "Menyimpan apa yang Anda dengar sebagai satu file audio. Menunya juga menawarkan setiap bagian sebagai .zip, atau hanya bagian yang diulang.",
+  "help.set.language": "Bahasa aplikasi.",
+  "help.set.maxDuration": "Lagu terpanjang yang diterima, dalam menit.",
+  "help.set.playlistLimit": "Jumlah lagu terbanyak yang ditambahkan satu playlist.",
+  "help.set.cookies": "Hanya diperlukan jika YouTube meminta Anda membuktikan bahwa Anda bukan bot.",
+  "help.set.stemsLocation": "Tempat lagu yang sudah dipisahkan disimpan.",
+  "help.set.exportsLocation": "Tujuan stem dan loop yang Anda seret keluar dari StemDeck.",
+  "help.set.autoDelete": "Mati kecuali Anda menyalakannya. Menghapus lagu setelah jumlah hari yang Anda tentukan.",
+  "help.set.device": "Kartu grafis atau prosesor Anda, untuk memisahkan.",
+  "help.set.quality": "Best memberi stem yang lebih bersih dan butuh waktu dua kali lipat.",
+  "help.set.exportLogs": "Semua log dalam satu zip, untuk dilampirkan ke laporan bug.",
+  "help.set.resetData": "Menghapus semua lagu. Tidak bisa dibatalkan.",
+  "help.set.acoustid": "Mengenali tiap lagu dari suaranya, dengan kunci AcoustID gratis.",
+  "help.set.discogs": "Profil band dan rilisan, dengan token Discogs gratis.",
+  "help.set.transcribe": "Menuliskan lirik dari vokal saat lirik tidak ditemukan.",
+  "help.set.network": "Buka StemDeck di ponsel atau tablet Anda, di Wi-Fi yang sama. Pindai kode QR, atau ketik alamat yang ditampilkan.",
+  "help.set.port": "Port tempat StemDeck berjalan. Mulai ulang untuk menerapkan.",
+  "help.set.sampleRate": "Sample rate file audio yang Anda ekspor.",
+  "help.set.videoQuality": "Kualitas video yang Anda ekspor.",
+  "help.set.logs": "Lokasi log, serta log aplikasi, backend, dan penyiapan.",
+  "help.set.registry": "Daftar lagu selesai yang disimpan StemDeck di disk. Hanya baca.",
 
   "search.ariaLabel": "Cari pustaka",
   "search.placeholder": "Cari atau #tag…",
@@ -5965,6 +6504,83 @@ const fr = {
   "nav.weRecommendLine1": "Nos",
   "nav.weRecommendLine2": "recommandations",
   "nav.help": "Aide",
+  "help.button": "Expliquer l'écran",
+  "help.railLabel": "Guide",
+  "help.pill": "Mode aide : pointez sur un élément pour voir ce qu'il fait. Échap pour quitter.",
+  "help.helpMode": "Le mode aide est activé. Pointez ou cliquez sur un élément pour voir ce qu'il fait. Échap ou ce bouton pour quitter.",
+  "help.website": "Ouvre stemdeck.app dans votre navigateur.",
+  "help.upload": "Choisissez un fichier audio sur votre ordinateur pour le séparer en instruments.",
+  "help.search": "Tapez le nom d'un morceau pour le chercher en ligne, ou collez un lien. Vous pouvez aussi déposer un fichier audio ici.",
+  "help.stemAll": "Extrait tous les instruments du morceau.",
+  "help.stemChip": "Cliquez pour inclure ou exclure {name} lors de l'extraction.",
+  "help.vocalCombined": "Garde tout le chant dans une seule piste Voix.",
+  "help.vocalSplit": "Sépare le chant en voix principale et chœurs.",
+  "help.detectStructure": "Expérimental. Activé, le prochain morceau importé reçoit son intro, ses couplets et ses refrains marqués.",
+  "help.analysisToggle": "Affiche ou masque la ligne d'infos du morceau : tonalité, tempo, volume et plus.",
+  "help.sectionsToggle": "Affiche ou masque la barre des sections, où les parties du morceau sont marquées.",
+  "help.extract": "Lance la séparation du morceau en instruments. Chacun obtient sa propre piste en dessous.",
+  "help.favorite": "Ajoute le morceau ouvert aux Favoris, ou l'en retire.",
+  "help.songDetails": "Détails sur le morceau ouvert.",
+  "help.toggleLibrary": "Masque la liste des morceaux pour agrandir le studio, ou la fait revenir.",
+  "help.favorites": "Affiche seulement les morceaux auxquels vous avez donné un cœur.",
+  "help.library": "Affiche tous vos morceaux dans la liste.",
+  "help.lyrics": "Affiche les paroles, éclairées ligne par ligne pendant la lecture.",
+  "help.trash": "Les morceaux supprimés attendent ici jusqu'à ce que vous vidiez la corbeille. Le nombre indique combien il y en a.",
+  "help.queue": "Les morceaux qui attendent d'être séparés, dans l'ordre où ils seront traités.",
+  "help.notifications": "Messages de StemDeck, comme une nouvelle version ou un import qui a échoué.",
+  "help.recommend": "Artistes, luthiers et matériel à connaître. StemDeck ne reçoit d'argent d'aucun d'eux.",
+  "help.about": "Liens vers le site, GitHub et Discord, et les crédits.",
+  "help.searchLibrary": "Tapez une partie du nom d'un morceau pour le trouver. Commencez par # pour chercher par tag.",
+  "help.newFolder": "Crée un dossier pour ranger vos morceaux.",
+  "help.trashedSong": "Un morceau supprimé. Maintenez-le une seconde pour le récupérer.",
+  "help.song": "Cliquez sur un morceau pour l'ouvrir dans le studio.",
+  "help.addSection": "Ajoute une section, comme un couplet ou un refrain, à la barre des sections.",
+  "help.volume": "Faites glisser pour rendre {name} plus fort ou plus faible.",
+  "help.laneKeyUp": "Monte seulement {name} d'un demi-ton, le plus petit pas en musique.",
+  "help.laneKeyDown": "Descend seulement {name} d'un demi-ton, le plus petit pas en musique.",
+  "help.laneKey": "La tonalité de {name}. K signifie sa tonalité d'origine ; un nombre indique de combien de demi-tons elle a bougé.",
+  "help.mute": "Coupe {name}, pour que vous puissiez jouer ou chanter cette partie vous-même.",
+  "help.solo": "Joue seulement {name}, pour l'entendre clairement.",
+  "help.download": "Enregistre {name} comme fichier audio séparé.",
+  "help.songFactsTitle": "Infos du morceau",
+  "help.songFacts": "Trouvés pour vous : la tonalité, le tempo en BPM, le volume, la durée et la présence de chaque instrument.",
+  "help.wavesTitle": "Formes d'onde",
+  "help.waves": "Le son de chaque instrument dans le temps. Cliquez pour aller à ce moment. Faites glisser pour boucler ce passage.",
+  "help.stop": "Arrête le morceau.",
+  "help.play": "Lance le morceau, ou le met en pause.",
+  "help.loop": "Active ou désactive la boucle : le passage entre les deux temps à côté se répète. La touche L fait de même.",
+  "help.loopStart": "Où la boucle commence, en secondes. Faites défiler dessus pour la déplacer.",
+  "help.loopEnd": "Où la boucle finit, en secondes. Faites défiler dessus pour la déplacer.",
+  "help.speedHalf": "Joue à mi-vitesse. La hauteur ne change pas.",
+  "help.speedSlow": "Joue aux trois quarts de la vitesse. Faites défiler dessus pour choisir une vitesse de 0.50x à 0.99x.",
+  "help.speedNormal": "Joue à la vitesse d'origine du morceau.",
+  "help.keyDown": "Descend tout le morceau d'un demi-ton, le plus petit pas en musique.",
+  "help.keyUp": "Monte tout le morceau d'un demi-ton, le plus petit pas en musique.",
+  "help.keyReset": "Remet chaque partie dans la tonalité d'origine du morceau.",
+  "help.click": "Active un clic qui suit le tempo du morceau. La touche K fait de même.",
+  "help.clickVolume": "Le volume du clic.",
+  "help.clickMore": "Plus de réglages pour le clic.",
+  "help.export": "Enregistre ce que vous entendez dans un seul fichier audio. Son menu propose aussi chaque partie en .zip, ou seulement le passage en boucle.",
+  "help.set.language": "La langue de l'application.",
+  "help.set.maxDuration": "Le morceau le plus long accepté, en minutes.",
+  "help.set.playlistLimit": "Le nombre maximum de morceaux qu'ajoute une playlist.",
+  "help.set.cookies": "Utile seulement si YouTube vous demande de prouver que vous n'êtes pas un robot.",
+  "help.set.stemsLocation": "Où sont stockés vos morceaux séparés.",
+  "help.set.exportsLocation": "Où vont les pistes et boucles que vous faites glisser hors de StemDeck.",
+  "help.set.autoDelete": "Désactivé sauf si vous l'activez. Supprime les morceaux après le nombre de jours choisi.",
+  "help.set.device": "Votre carte graphique ou votre processeur, pour la séparation.",
+  "help.set.quality": "Best donne des pistes plus propres et prend deux fois plus de temps.",
+  "help.set.exportLogs": "Tous les journaux dans un zip, à joindre à un rapport de bug.",
+  "help.set.resetData": "Supprime tous les morceaux. Impossible à annuler.",
+  "help.set.acoustid": "Reconnaît chaque morceau à son son, avec une clé AcoustID gratuite.",
+  "help.set.discogs": "Profils de groupes et sorties, avec un jeton Discogs gratuit.",
+  "help.set.transcribe": "Écrit les paroles à partir du chant quand aucune n'est trouvée.",
+  "help.set.network": "Ouvrez StemDeck sur votre téléphone ou tablette, sur le même Wi-Fi. Scannez le QR code ou tapez l'adresse affichée.",
+  "help.set.port": "Le port sur lequel StemDeck tourne. Redémarrez pour appliquer.",
+  "help.set.sampleRate": "La fréquence d'échantillonnage des fichiers audio exportés.",
+  "help.set.videoQuality": "La qualité des vidéos exportées.",
+  "help.set.logs": "Où sont les journaux, et les journaux de l'application, du serveur et de l'installation.",
+  "help.set.registry": "La liste des morceaux terminés que StemDeck garde sur le disque. Lecture seule.",
 
   "search.ariaLabel": "Rechercher dans la bibliothèque",
   "search.placeholder": "Rechercher ou #tag…",
@@ -6927,6 +7543,83 @@ const es = {
   "nav.weRecommendLine1": "Reco-",
   "nav.weRecommendLine2": "mendamos",
   "nav.help": "Ayuda",
+  "help.button": "Explicar la pantalla",
+  "help.railLabel": "Guía",
+  "help.pill": "Modo ayuda: señala cualquier cosa para ver qué hace. Esc para salir.",
+  "help.helpMode": "El modo ayuda está activado. Señala o haz clic en algo para ver qué hace. Pulsa Esc o este botón para salir.",
+  "help.website": "Abre stemdeck.app en tu navegador.",
+  "help.upload": "Elige un archivo de audio de tu ordenador para separarlo en sus instrumentos.",
+  "help.search": "Escribe el nombre de una canción para buscarla en línea, o pega un enlace. También puedes soltar aquí un archivo de audio.",
+  "help.stemAll": "Extrae todos los instrumentos de la canción.",
+  "help.stemChip": "Haz clic para incluir o dejar fuera {name} al extraer.",
+  "help.vocalCombined": "Mantiene todo el canto en una sola pista de Voces.",
+  "help.vocalSplit": "Separa el canto en la voz principal y los coros.",
+  "help.detectStructure": "Experimental. Activado, la próxima canción que importes tendrá marcados la intro, las estrofas y los estribillos.",
+  "help.analysisToggle": "Muestra u oculta la fila de datos de la canción: tonalidad, tempo, volumen y más.",
+  "help.sectionsToggle": "Muestra u oculta la barra de secciones, donde se marcan las partes de la canción.",
+  "help.extract": "Empieza a separar la canción en sus instrumentos. Cada uno tiene su propia pista abajo.",
+  "help.favorite": "Añade la canción abierta a Favoritos, o la quita.",
+  "help.songDetails": "Detalles de la canción abierta.",
+  "help.toggleLibrary": "Oculta la lista de canciones para dar más espacio al estudio, o la vuelve a mostrar.",
+  "help.favorites": "Muestra solo las canciones a las que diste un corazón.",
+  "help.library": "Muestra todas tus canciones en la lista.",
+  "help.lyrics": "Muestra la letra, iluminada línea a línea mientras suena.",
+  "help.trash": "Las canciones borradas esperan aquí hasta que vacíes la papelera. El número indica cuántas hay.",
+  "help.queue": "Las canciones que esperan para separarse, en el orden en que se harán.",
+  "help.notifications": "Mensajes de StemDeck, como una nueva versión o una importación que falló.",
+  "help.recommend": "Artistas, luthiers y equipo que vale la pena conocer. StemDeck no recibe dinero de ninguno de ellos.",
+  "help.about": "Enlaces a la web, GitHub y Discord, y los créditos.",
+  "help.searchLibrary": "Escribe parte del nombre de una canción para encontrarla. Empieza con # para buscar por etiqueta.",
+  "help.newFolder": "Crea una carpeta para ordenar tus canciones.",
+  "help.trashedSong": "Una canción borrada. Mantenla pulsada un segundo para recuperarla.",
+  "help.song": "Haz clic en una canción para abrirla en el estudio.",
+  "help.addSection": "Añade una sección, como una estrofa o un estribillo, a la barra de secciones.",
+  "help.volume": "Arrastra para subir o bajar el volumen de {name}.",
+  "help.laneKeyUp": "Sube solo {name} un semitono, el paso más pequeño en música.",
+  "help.laneKeyDown": "Baja solo {name} un semitono, el paso más pequeño en música.",
+  "help.laneKey": "La tonalidad de {name}. K es su tonalidad original; un número indica cuántos semitonos se movió.",
+  "help.mute": "Silencia {name}, para que puedas tocar o cantar esa parte tú.",
+  "help.solo": "Reproduce solo {name}, para oírlo con claridad.",
+  "help.download": "Guarda {name} como un archivo de audio aparte.",
+  "help.songFactsTitle": "Datos de la canción",
+  "help.songFacts": "Calculados para ti: la tonalidad, el tempo en BPM, el volumen, la duración y cuánto hay de cada instrumento.",
+  "help.wavesTitle": "Formas de onda",
+  "help.waves": "El sonido de cada instrumento a lo largo del tiempo. Haz clic para saltar a ese momento. Arrastra para repetir esa parte en bucle.",
+  "help.stop": "Detiene la canción.",
+  "help.play": "Reproduce la canción, o la pausa.",
+  "help.loop": "Activa o desactiva el bucle: la parte entre los dos tiempos de al lado se repite. La tecla L hace lo mismo.",
+  "help.loopStart": "Dónde empieza el bucle, en segundos. Desplaza la rueda encima para moverlo.",
+  "help.loopEnd": "Dónde termina el bucle, en segundos. Desplaza la rueda encima para moverlo.",
+  "help.speedHalf": "Reproduce a media velocidad. El tono no cambia.",
+  "help.speedSlow": "Reproduce a tres cuartos de velocidad. Desplaza la rueda encima para elegir cualquier velocidad de 0.50x a 0.99x.",
+  "help.speedNormal": "Reproduce a la velocidad original de la canción.",
+  "help.keyDown": "Baja toda la canción un semitono, el paso más pequeño en música.",
+  "help.keyUp": "Sube toda la canción un semitono, el paso más pequeño en música.",
+  "help.keyReset": "Devuelve cada parte a la tonalidad original de la canción.",
+  "help.click": "Activa un clic que sigue el tempo de la canción. La tecla K hace lo mismo.",
+  "help.clickVolume": "El volumen del clic.",
+  "help.clickMore": "Más ajustes del clic.",
+  "help.export": "Guarda lo que oyes como un solo archivo de audio. Su menú también ofrece cada parte en un .zip, o solo la parte en bucle.",
+  "help.set.language": "El idioma de la aplicación.",
+  "help.set.maxDuration": "La canción más larga que acepta, en minutos.",
+  "help.set.playlistLimit": "El máximo de canciones que añade una lista de reproducción.",
+  "help.set.cookies": "Solo hace falta si YouTube te pide demostrar que no eres un bot.",
+  "help.set.stemsLocation": "Dónde se guardan tus canciones separadas.",
+  "help.set.exportsLocation": "Adónde van las pistas y bucles que arrastras fuera de StemDeck.",
+  "help.set.autoDelete": "Desactivado salvo que lo actives. Borra canciones tras el número de días que elijas.",
+  "help.set.device": "Tu tarjeta gráfica o tu procesador, para separar.",
+  "help.set.quality": "Best da pistas más limpias y tarda el doble.",
+  "help.set.exportLogs": "Todos los registros en un zip, para adjuntar a un informe de error.",
+  "help.set.resetData": "Borra todas las canciones. No se puede deshacer.",
+  "help.set.acoustid": "Reconoce cada canción por su sonido, con una clave gratuita de AcoustID.",
+  "help.set.discogs": "Perfiles de bandas y lanzamientos, con un token gratuito de Discogs.",
+  "help.set.transcribe": "Escribe la letra a partir de la voz cuando no se encuentra ninguna.",
+  "help.set.network": "Abre StemDeck en tu móvil o tableta, en la misma Wi-Fi. Escanea el código QR o escribe la dirección que aparece.",
+  "help.set.port": "El puerto en el que funciona StemDeck. Reinicia para aplicarlo.",
+  "help.set.sampleRate": "La frecuencia de muestreo de los archivos de audio que exportas.",
+  "help.set.videoQuality": "La calidad de los vídeos que exportas.",
+  "help.set.logs": "Dónde están los registros, y los registros de la aplicación, del servidor y de la instalación.",
+  "help.set.registry": "La lista de canciones terminadas que StemDeck guarda en el disco. Solo lectura.",
 
   "search.ariaLabel": "Buscar en la biblioteca",
   "search.placeholder": "Busca o #etiqueta…",
@@ -7738,6 +8431,83 @@ const ko = {
   "nav.weRecommendLine1": "이런 곳도",
   "nav.weRecommendLine2": "추천해요",
   "nav.help": "도움말",
+  "help.button": "화면 설명",
+  "help.railLabel": "가이드",
+  "help.pill": "도움말 모드: 아무 항목이나 가리키면 하는 일을 보여 줘요. Esc로 나가요.",
+  "help.helpMode": "도움말 모드가 켜져 있어요. 아무 항목이나 가리키거나 클릭하면 하는 일을 보여 줘요. Esc나 이 버튼으로 끌 수 있어요.",
+  "help.website": "브라우저에서 stemdeck.app을 열어요.",
+  "help.upload": "컴퓨터에서 오디오 파일을 골라 악기별로 나눠요.",
+  "help.search": "곡 이름을 입력해 온라인에서 찾거나 링크를 붙여 넣어요. 오디오 파일을 여기에 놓을 수도 있어요.",
+  "help.stemAll": "곡에 있는 모든 악기를 추출해요.",
+  "help.stemChip": "클릭해서 추출할 때 {name}을(를) 넣거나 뺄 수 있어요.",
+  "help.vocalCombined": "모든 노래를 보컬 레인 하나에 담아요.",
+  "help.vocalSplit": "노래를 리드 보컬과 백 보컬로 나눠요.",
+  "help.detectStructure": "실험 기능이에요. 켜면 다음에 가져오는 곡의 인트로, 벌스, 코러스가 표시돼요.",
+  "help.analysisToggle": "키, 템포, 음량 등 곡 정보 줄을 보이거나 숨겨요.",
+  "help.sectionsToggle": "곡의 구간이 표시되는 섹션 막대를 보이거나 숨겨요.",
+  "help.extract": "곡을 악기별로 나누기 시작해요. 악기마다 아래에 레인이 생겨요.",
+  "help.favorite": "열린 곡을 즐겨찾기에 넣거나 빼요.",
+  "help.songDetails": "열린 곡의 자세한 정보예요.",
+  "help.toggleLibrary": "곡 목록을 숨겨 스튜디오를 넓게 쓰거나 다시 보여 줘요.",
+  "help.favorites": "하트를 누른 곡만 보여 줘요.",
+  "help.library": "목록에 모든 곡을 보여 줘요.",
+  "help.lyrics": "곡의 가사를 보여 주고, 재생에 맞춰 한 줄씩 밝혀 줘요.",
+  "help.trash": "삭제한 곡은 휴지통을 비울 때까지 여기에 있어요. 숫자는 곡 수예요.",
+  "help.queue": "분리를 기다리는 곡이에요. 처리될 순서대로 있어요.",
+  "help.notifications": "새 버전이나 실패한 가져오기 같은 StemDeck의 알림이에요.",
+  "help.recommend": "알아 두면 좋은 아티스트, 악기 제작자, 장비예요. StemDeck은 이들 누구에게서도 돈을 받지 않아요.",
+  "help.about": "웹사이트, GitHub, Discord 링크와 크레딧이에요.",
+  "help.searchLibrary": "곡 이름 일부를 입력해 찾아요. #으로 시작하면 태그로 찾아요.",
+  "help.newFolder": "곡을 정리할 폴더를 만들어요.",
+  "help.trashedSong": "삭제한 곡이에요. 1초 동안 누르고 있으면 되살아나요.",
+  "help.song": "곡을 클릭하면 스튜디오에서 열려요.",
+  "help.addSection": "벌스나 코러스 같은 구간을 섹션 막대에 추가해요.",
+  "help.volume": "끌어서 {name} 소리를 키우거나 줄여요.",
+  "help.laneKeyUp": "{name}만 반음 올려요. 반음은 음악에서 가장 작은 음 간격이에요.",
+  "help.laneKeyDown": "{name}만 반음 내려요. 반음은 음악에서 가장 작은 음 간격이에요.",
+  "help.laneKey": "{name}의 키예요. K는 원래 키이고, 숫자는 몇 반음 옮겼는지 보여 줘요.",
+  "help.mute": "{name} 소리를 꺼서 그 부분을 직접 연주하거나 부를 수 있게 해요.",
+  "help.solo": "{name}만 재생해서 또렷하게 들려줘요.",
+  "help.download": "{name}을(를) 별도의 오디오 파일로 저장해요.",
+  "help.songFactsTitle": "곡 정보",
+  "help.songFacts": "자동으로 찾아 줘요: 키, BPM 단위의 템포, 음량, 길이, 그리고 악기별 비중이에요.",
+  "help.wavesTitle": "파형",
+  "help.waves": "악기마다 소리를 시간에 따라 그린 거예요. 클릭하면 그 순간으로 가고, 끌면 그 부분을 반복해요.",
+  "help.stop": "곡을 멈춰요.",
+  "help.play": "곡을 재생하거나 일시 정지해요.",
+  "help.loop": "반복을 켜거나 꺼요. 옆의 두 시간 사이가 반복돼요. L 키도 같아요.",
+  "help.loopStart": "반복이 시작하는 곳이에요(초). 위에서 스크롤하면 옮길 수 있어요.",
+  "help.loopEnd": "반복이 끝나는 곳이에요(초). 위에서 스크롤하면 옮길 수 있어요.",
+  "help.speedHalf": "절반 속도로 재생해요. 음높이는 그대로예요.",
+  "help.speedSlow": "4분의 3 속도로 재생해요. 위에서 스크롤하면 0.50x에서 0.99x까지 고를 수 있어요.",
+  "help.speedNormal": "곡의 원래 속도로 재생해요.",
+  "help.keyDown": "곡 전체를 반음 내려요. 반음은 음악에서 가장 작은 음 간격이에요.",
+  "help.keyUp": "곡 전체를 반음 올려요. 반음은 음악에서 가장 작은 음 간격이에요.",
+  "help.keyReset": "모든 부분을 곡의 원래 키로 되돌려요.",
+  "help.click": "곡의 템포를 따라가는 클릭을 켜요. K 키도 같아요.",
+  "help.clickVolume": "클릭 소리의 크기예요.",
+  "help.clickMore": "클릭의 다른 설정이에요.",
+  "help.export": "들리는 그대로 오디오 파일 하나로 저장해요. 메뉴에서 모든 부분을 .zip으로, 또는 반복 구간만 저장할 수도 있어요.",
+  "help.set.language": "앱의 언어예요.",
+  "help.set.maxDuration": "받아들이는 가장 긴 곡 길이예요(분).",
+  "help.set.playlistLimit": "재생목록 하나가 추가하는 최대 곡 수예요.",
+  "help.set.cookies": "YouTube가 봇이 아님을 확인해 달라고 할 때만 필요해요.",
+  "help.set.stemsLocation": "분리한 곡을 저장하는 곳이에요.",
+  "help.set.exportsLocation": "StemDeck 밖으로 끌어낸 스템과 루프가 저장되는 곳이에요.",
+  "help.set.autoDelete": "직접 켜기 전에는 꺼져 있어요. 정한 날짜가 지나면 곡을 삭제해요.",
+  "help.set.device": "분리에 쓰는 그래픽 카드나 프로세서예요.",
+  "help.set.quality": "Best는 스템이 더 깨끗하고 시간이 두 배 걸려요.",
+  "help.set.exportLogs": "모든 로그를 zip 하나로 묶어요. 버그 신고에 첨부할 수 있어요.",
+  "help.set.resetData": "모든 곡을 삭제해요. 되돌릴 수 없어요.",
+  "help.set.acoustid": "무료 AcoustID 키로 소리를 듣고 곡을 알아봐요.",
+  "help.set.discogs": "무료 Discogs 토큰으로 밴드 프로필과 발매 정보를 가져와요.",
+  "help.set.transcribe": "가사를 찾지 못하면 보컬에서 가사를 받아 적어요.",
+  "help.set.network": "같은 Wi-Fi에 있는 휴대폰이나 태블릿에서 StemDeck을 열어요. QR 코드를 찍거나 표시된 주소를 입력해요.",
+  "help.set.port": "StemDeck이 실행되는 포트예요. 다시 시작하면 적용돼요.",
+  "help.set.sampleRate": "내보내는 오디오 파일의 샘플 레이트예요.",
+  "help.set.videoQuality": "내보내는 동영상의 화질이에요.",
+  "help.set.logs": "로그 위치와 앱, 백엔드, 설치 로그예요.",
+  "help.set.registry": "StemDeck이 디스크에 보관하는 완료된 곡 목록이에요. 읽기 전용이에요.",
 
   "search.ariaLabel": "라이브러리 검색",
   "search.placeholder": "검색 또는 #태그…",
diff --git a/static/js/main.js b/static/js/main.js
index fccb50fd..684d650f 100644
--- a/static/js/main.js
+++ b/static/js/main.js
@@ -21,6 +21,7 @@ import { initI18n, applyTranslations, t, plural, onLanguageChange } from "./i18n
 import { initFooterFit, refitFooter } from "./footerFit.js";
 import { initArtistInfo } from "./artistInfo.js";
 import { initLyrics } from "./lyrics.js";
+import { initHelpMode } from "./helpMode.js";
 
 // ─── Stem choice toggles on the import page ───
 //
@@ -456,6 +457,7 @@ wireAppShellControls();
 initFooterFit();
 initArtistInfo();
 initLyrics();
+initHelpMode();
 // Re-measure after a language switch. Measured across en/fr/de/pl the strip
 // came out the same width in all four, because the group labels are 10px
 // uppercase and narrower than the controls under them, so this is not the
diff --git a/tests/e2e/help-mode.spec.mjs b/tests/e2e/help-mode.spec.mjs
new file mode 100644
index 00000000..d11d7e83
--- /dev/null
+++ b/tests/e2e/help-mode.spec.mjs
@@ -0,0 +1,93 @@
+// Help mode: Guide in the rail, below Trash, makes the studio explain itself. Every
+// control it covers shows an outline, pointing at one shows a box with its
+// name and what it does, and a click while help mode is on explains instead of
+// acting.
+
+import { test, expect } from "@playwright/test";
+
+import { openStudio } from "./helpers.mjs";
+
+const tip = (page) => page.locator("#helpTip");
+
+async function helpOn(page) {
+  await page.locator("#helpModeBtn").click();
+  await expect(page.locator("body")).toHaveClass(/help-mode/);
+  await expect(page.locator("#helpModeBtn")).toHaveAttribute("aria-pressed", "true");
+  await expect(page.locator(".help-pill")).toBeVisible();
+}
+
+test.describe("help mode", () => {
+  test("Guide turns it on, and Esc or Guide turns it off", async ({ page }) => {
+    await openStudio(page);
+    await helpOn(page);
+    await page.keyboard.press("Escape");
+    await expect(page.locator("body")).not.toHaveClass(/help-mode/);
+    await helpOn(page);
+    await page.locator("#helpModeBtn").click();
+    await expect(page.locator("body")).not.toHaveClass(/help-mode/);
+    await expect(page.locator(".help-target")).toHaveCount(0);
+    await expect(page.locator(".help-pill")).toBeHidden();
+  });
+
+  test("pointing at a control explains it, under its own label", async ({ page }) => {
+    await openStudio(page);
+    await helpOn(page);
+    await page.locator("#t-speed-075").hover();
+    await expect(tip(page)).toBeVisible();
+    await expect(tip(page).locator("b")).toHaveText("0.75x");
+    await expect(tip(page)).toContainText("three-quarter speed");
+    await expect(page.locator("#t-speed-075")).toHaveClass(/help-current/);
+  });
+
+  test("a lane's control names its instrument", async ({ page }) => {
+    await openStudio(page);
+    await helpOn(page);
+    const drumsMute = page.locator(".mx-row, .lane-header").filter({ hasText: "Drums" }).locator(".mx-btn.mute").first();
+    await drumsMute.hover();
+    await expect(tip(page)).toContainText("Silences Drums");
+  });
+
+  test("a click explains instead of acting", async ({ page }) => {
+    await openStudio(page);
+    await helpOn(page);
+    const fav = page.locator("#fav-btn");
+    await expect(fav).toHaveAttribute("aria-pressed", "false");
+    await fav.click();
+    await expect(tip(page)).toContainText("Favorites");
+    await expect(fav).toHaveAttribute("aria-pressed", "false");
+
+    // Off again, the same click works.
+    await page.keyboard.press("Escape");
+    await fav.click();
+    await expect(fav).toHaveAttribute("aria-pressed", "true");
+  });
+
+  test("Settings lists every tab and its options", async ({ page }) => {
+    await openStudio(page);
+    await helpOn(page);
+    await page.locator("#settingsBtn").hover();
+    for (const text of ["General", "Song details", "Network", "Export", "Logs", "Registry", "Port", "Compute device", "Make StemDeck available on your network"]) {
+      await expect(tip(page)).toContainText(text);
+    }
+  });
+
+  test("every outlined control has a title and a real explanation", async ({ page }) => {
+    await openStudio(page);
+    await helpOn(page);
+    const targets = page.locator(".help-target");
+    const count = await targets.count();
+    expect(count).toBeGreaterThan(40);
+    const bad = [];
+    for (let i = 0; i < count; i++) {
+      const el = targets.nth(i);
+      if (!(await el.isVisible())) continue;
+      // Hover the centre of the box, which for the small lane steppers is the
+      // only point not shared with a neighbour.
+      await el.hover({ force: true });
+      const title = (await tip(page).locator("b").textContent())?.trim();
+      const text = (await tip(page).textContent())?.trim();
+      if (!title || !text || /help\.|\{name\}/.test(text) || text === title) bad.push({ i, title, text });
+    }
+    expect(bad).toEqual([]);
+  });
+});

From 2bec18c0b0d94bd4ad289c5318fe85261b6f59aa Mon Sep 17 00:00:00 2001
From: Thales <>
Date: Sun, 4 Oct 2026 18:29:52 +0100
Subject: [PATCH 2/2] fix(help): head a lane's M, S, + and K boxes with what
 they do

In help mode the box over a lane's M button was headed "M", and S, +
and the K box the same: the heading took the visible text first, and
for these it is one character. Someone who does not know what M means
learned nothing from the heading.

A visible text of one or two characters now gives way to the button's
full label ("Mute Drums", "Transpose Drums up one semitone"). The K box
has no label of its own, so it gets one: "Key of Drums", in all ten
languages.

Refs #757
---
 static/js/helpMode.js        | 10 ++++++----
 static/js/i18n.js            | 10 ++++++++++
 tests/e2e/help-mode.spec.mjs |  6 ++++++
 3 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/static/js/helpMode.js b/static/js/helpMode.js
index b24b561a..767b07e8 100644
--- a/static/js/helpMode.js
+++ b/static/js/helpMode.js
@@ -47,7 +47,7 @@ const HELP = [
   [".mx-fader", "help.volume", laneName],
   [".lane-key-step.up", "help.laneKeyUp", laneName],
   [".lane-key-step.down", "help.laneKeyDown", laneName],
-  [".lane-key-value", "help.laneKey", laneName],
+  [".lane-key-value", "help.laneKey", laneName, "help.laneKeyTitle"],
   [".mx-btn.mute", "help.mute", laneName],
   [".mx-btn.solo", "help.solo", laneName],
   [".lane-dl", "help.download", laneName],
@@ -129,12 +129,14 @@ function isVisible(el) {
   return r.width > 0 && r.height > 0;
 }
 
-/** The control's own label, which the app already translates. */
+/** The control's own label, which the app already translates. Visible text
+ *  first, unless it is a letter or a sign (M, S, +): a heading that repeats
+ *  "M" teaches nothing, so those take their full label ("Mute Drums"). */
 function titleOf(entry) {
-  if (entry.titleKey) return t(entry.titleKey);
   const { el } = entry;
+  if (entry.titleKey) return t(entry.titleKey, { name: entry.nameOf ? entry.nameOf(el) : "" });
   const text = (el.innerText || "").trim().split("\n")[0].trim();
-  if (text && text.length <= 40) return text;
+  if (text.length > 2 && text.length <= 40) return text;
   return el.getAttribute("aria-label") || el.getAttribute("placeholder") || el.getAttribute("title")
     || el.querySelector("[aria-label]")?.getAttribute("aria-label") || text;
 }
diff --git a/static/js/i18n.js b/static/js/i18n.js
index da8e5472..d6e9f29b 100644
--- a/static/js/i18n.js
+++ b/static/js/i18n.js
@@ -476,6 +476,7 @@ const en = {
   "help.volume": "Drag to make {name} louder or quieter.",
   "help.laneKeyUp": "Moves only {name} up one semitone, the smallest step in music.",
   "help.laneKeyDown": "Moves only {name} down one semitone, the smallest step in music.",
+  "help.laneKeyTitle": "Key of {name}",
   "help.laneKey": "The key of {name}. K means its original key; a number means how many semitones it moved.",
   "help.mute": "Silences {name}, so you can play or sing that part yourself.",
   "help.solo": "Plays only {name}, to hear it clearly.",
@@ -1365,6 +1366,7 @@ const pl = {
   "help.volume": "Przeciągnij, aby {name} grało głośniej lub ciszej.",
   "help.laneKeyUp": "Podnosi tylko {name} o półton, najmniejszy krok w muzyce.",
   "help.laneKeyDown": "Obniża tylko {name} o półton, najmniejszy krok w muzyce.",
+  "help.laneKeyTitle": "Tonacja: {name}",
   "help.laneKey": "Tonacja: {name}. K oznacza oryginalną tonację; liczba pokazuje, o ile półtonów ją przesunięto.",
   "help.mute": "Wycisza {name}, żebyś mógł sam zagrać lub zaśpiewać tę partię.",
   "help.solo": "Odtwarza tylko {name}, żeby było wyraźnie słychać.",
@@ -2244,6 +2246,7 @@ const ja = {
   "help.volume": "ドラッグして{name}の音量を上げ下げします。",
   "help.laneKeyUp": "{name}だけを半音上げます。半音は音楽で最も小さな音程の単位です。",
   "help.laneKeyDown": "{name}だけを半音下げます。半音は音楽で最も小さな音程の単位です。",
+  "help.laneKeyTitle": "{name}のキー",
   "help.laneKey": "{name}のキーです。K は元のキー、数字は何半音動かしたかを示します。",
   "help.mute": "{name}をミュートします。そのパートを自分で演奏したり歌ったりできます。",
   "help.solo": "{name}だけを再生して、はっきり聞けるようにします。",
@@ -3098,6 +3101,7 @@ const zhHans = {
   "help.volume": "拖动以调大或调小{name}的音量。",
   "help.laneKeyUp": "只把{name}升高一个半音，半音是音乐中最小的音程。",
   "help.laneKeyDown": "只把{name}降低一个半音，半音是音乐中最小的音程。",
+  "help.laneKeyTitle": "{name}的调",
   "help.laneKey": "{name}的调。K 表示原调；数字表示移动了几个半音。",
   "help.mute": "将{name}静音，让你自己演奏或演唱这一部分。",
   "help.solo": "只播放{name}，听得更清楚。",
@@ -3952,6 +3956,7 @@ const de = {
   "help.volume": "Zieh, um {name} lauter oder leiser zu machen.",
   "help.laneKeyUp": "Hebt nur {name} um einen Halbton an, den kleinsten Schritt in der Musik.",
   "help.laneKeyDown": "Senkt nur {name} um einen Halbton, den kleinsten Schritt in der Musik.",
+  "help.laneKeyTitle": "Tonart von {name}",
   "help.laneKey": "Die Tonart von {name}. K heißt Originaltonart; eine Zahl zeigt, um wie viele Halbtöne verschoben wurde.",
   "help.mute": "Schaltet {name} stumm, damit du diesen Part selbst spielen oder singen kannst.",
   "help.solo": "Spielt nur {name}, damit du es deutlich hörst.",
@@ -4817,6 +4822,7 @@ const pt = {
   "help.volume": "Arraste para deixar {name} mais alto ou mais baixo.",
   "help.laneKeyUp": "Sobe só {name} um semitom, o menor passo na música.",
   "help.laneKeyDown": "Desce só {name} um semitom, o menor passo na música.",
+  "help.laneKeyTitle": "Tom de {name}",
   "help.laneKey": "O tom de {name}. K quer dizer o tom original; um número mostra quantos semitons ele mudou.",
   "help.mute": "Silencia {name}, para você tocar ou cantar essa parte.",
   "help.solo": "Toca só {name}, para ouvir com clareza.",
@@ -5684,6 +5690,7 @@ const id = {
   "help.volume": "Geser untuk membuat {name} lebih keras atau lebih pelan.",
   "help.laneKeyUp": "Menaikkan hanya {name} satu semitone, langkah terkecil dalam musik.",
   "help.laneKeyDown": "Menurunkan hanya {name} satu semitone, langkah terkecil dalam musik.",
+  "help.laneKeyTitle": "Kunci nada {name}",
   "help.laneKey": "Kunci nada {name}. K berarti kunci aslinya; angka menunjukkan berapa semitone digeser.",
   "help.mute": "Membisukan {name}, agar Anda bisa memainkan atau menyanyikan bagian itu sendiri.",
   "help.solo": "Hanya memutar {name}, agar terdengar jelas.",
@@ -6538,6 +6545,7 @@ const fr = {
   "help.volume": "Faites glisser pour rendre {name} plus fort ou plus faible.",
   "help.laneKeyUp": "Monte seulement {name} d'un demi-ton, le plus petit pas en musique.",
   "help.laneKeyDown": "Descend seulement {name} d'un demi-ton, le plus petit pas en musique.",
+  "help.laneKeyTitle": "Tonalité de {name}",
   "help.laneKey": "La tonalité de {name}. K signifie sa tonalité d'origine ; un nombre indique de combien de demi-tons elle a bougé.",
   "help.mute": "Coupe {name}, pour que vous puissiez jouer ou chanter cette partie vous-même.",
   "help.solo": "Joue seulement {name}, pour l'entendre clairement.",
@@ -7577,6 +7585,7 @@ const es = {
   "help.volume": "Arrastra para subir o bajar el volumen de {name}.",
   "help.laneKeyUp": "Sube solo {name} un semitono, el paso más pequeño en música.",
   "help.laneKeyDown": "Baja solo {name} un semitono, el paso más pequeño en música.",
+  "help.laneKeyTitle": "Tonalidad de {name}",
   "help.laneKey": "La tonalidad de {name}. K es su tonalidad original; un número indica cuántos semitonos se movió.",
   "help.mute": "Silencia {name}, para que puedas tocar o cantar esa parte tú.",
   "help.solo": "Reproduce solo {name}, para oírlo con claridad.",
@@ -8465,6 +8474,7 @@ const ko = {
   "help.volume": "끌어서 {name} 소리를 키우거나 줄여요.",
   "help.laneKeyUp": "{name}만 반음 올려요. 반음은 음악에서 가장 작은 음 간격이에요.",
   "help.laneKeyDown": "{name}만 반음 내려요. 반음은 음악에서 가장 작은 음 간격이에요.",
+  "help.laneKeyTitle": "{name}의 키",
   "help.laneKey": "{name}의 키예요. K는 원래 키이고, 숫자는 몇 반음 옮겼는지 보여 줘요.",
   "help.mute": "{name} 소리를 꺼서 그 부분을 직접 연주하거나 부를 수 있게 해요.",
   "help.solo": "{name}만 재생해서 또렷하게 들려줘요.",
diff --git a/tests/e2e/help-mode.spec.mjs b/tests/e2e/help-mode.spec.mjs
index d11d7e83..cdf7ac3b 100644
--- a/tests/e2e/help-mode.spec.mjs
+++ b/tests/e2e/help-mode.spec.mjs
@@ -45,6 +45,12 @@ test.describe("help mode", () => {
     const drumsMute = page.locator(".mx-row, .lane-header").filter({ hasText: "Drums" }).locator(".mx-btn.mute").first();
     await drumsMute.hover();
     await expect(tip(page)).toContainText("Silences Drums");
+    // Headed by what the button does, not by its one letter.
+    await expect(tip(page).locator("b")).toHaveText("Mute Drums");
+
+    const drumsKey = page.locator(".lane-key").filter({ has: page.locator('[aria-label*="Drums"]') }).locator(".lane-key-value").first();
+    await drumsKey.hover({ force: true });
+    await expect(tip(page).locator("b")).toHaveText("Key of Drums");
   });
 
   test("a click explains instead of acting", async ({ page }) => {