+
+
+
diff --git a/setup/src/main.js b/setup/src/main.js
new file mode 100644
index 0000000..3311d33
--- /dev/null
+++ b/setup/src/main.js
@@ -0,0 +1,7 @@
+// SoulStream Setup's page: the app's own stylesheet (tokens, fonts, buttons)
+// and one component, the tour as an installer.
+import "../../src/styles/global.css";
+import { mount } from "svelte";
+import Setup from "./Setup.svelte";
+
+mount(Setup, { target: document.getElementById("app") });
diff --git a/src/components/FirstRun.svelte b/src/components/FirstRun.svelte
index 4ef11ea..1045782 100644
--- a/src/components/FirstRun.svelte
+++ b/src/components/FirstRun.svelte
@@ -27,6 +27,7 @@
const STEPS = [
{ id: "welcome", label: "Welcome", icon: "sparkle" },
+ { id: "alpha", label: "Alpha key", icon: "key" },
{ id: "library", label: "Your library", icon: "library" },
{ id: "soulseek", label: "Soulseek", icon: "users" },
{ id: "community", label: "Community", icon: "globe" },
@@ -53,6 +54,10 @@
let displayName = $state("");
let glass = $state(false);
let loudness = $state(true);
+ // The closed alpha's read-only release key (updater.rs): typed here,
+ // kept by the backend in the Credential Manager, never read back.
+ let alphaKey = $state("");
+ let hasToken = $state(false);
let busy = $state(false);
let error = $state("");
let closing = $state(false);
@@ -90,6 +95,11 @@
} catch {
freenetOn = false;
}
+ try {
+ hasToken = !!(await api.updaterStatus()).has_token;
+ } catch {
+ hasToken = false;
+ }
await tick();
panelEl?.querySelector(".primary")?.focus();
}
@@ -132,7 +142,25 @@
async function next() {
if (busy || closing) return;
- if (cur.id === "library") {
+ if (cur.id === "alpha") {
+ const k = alphaKey.trim();
+ if (k) {
+ busy = true;
+ error = "";
+ try {
+ await api.updaterSet({ token: k });
+ hasToken = true;
+ alphaKey = "";
+ // The first check can start now; the toast reports it.
+ void api.updaterCheck().catch(() => {});
+ } catch (e) {
+ error = String(e);
+ } finally {
+ busy = false;
+ }
+ if (error) return;
+ }
+ } else if (cur.id === "library") {
const patch = {};
if (libraryDir && libraryDir !== settings?.download_dir) patch.downloadDir = libraryDir;
const lay = layout.trim();
@@ -274,11 +302,28 @@
that runs on a peer you own. Four short questions and the app is yours.
+ SoulStream Setup
+
+
+
+
+
+
+
+
+
+ {#key step}
+
+ {#if cur.id === "welcome"}
+
+ {/key}
+
+
+
+
+
+ {:else if cur.id === "key"}
+
+ 
+
+
+ + {d?.installed_version ? "Set SoulStream up again" : "Welcome to SoulStream"} +
++ {#if d?.installed_version} + SoulStream {d.installed_version} is already on this computer. This installs + the latest release in its place and keeps your music and settings. About a minute, + no admin prompt. + {:else} + Your library on your own disk, music from people on Soulseek, and a community + that runs on a peer you own. Your alpha key, two short questions, then about a + minute to download and install — no admin prompt, and your music never lives + inside the program. + {/if} +
+-
+ {#each STEPS.slice(1, 4) as s (s.id)}
+
{s.label}
+ {/each}
+
Your alpha key
++ SoulStream is in a closed alpha. This key — one per tester, able only to read the + private repository — is how Setup fetches the app and how the app finds updates + later. It goes to the Windows Credential Manager, not a plain file. Nothing installs + without it. +
+
+
+ {:else if cur.id === "library"}
+
+
+
+
+ Alpha key {#if keyOk}accepted{:else if verifying}checking…{/if}
+
+ {#if keyOk}
+ SoulStream {keyOk.version} is what it will install{#if keyOk.installer_size} — {(keyOk.installer_size / 1e6).toFixed(1)} MB{/if}. Paste another key to replace it.
+ {:else}
+ Paste the key you were given (it starts with github_pat_) and press Verify. Setup asks GitHub whether the key can read the release.
+ {/if}
+
+
+ { if (e.key === "Enter") { e.stopPropagation(); verify(); } }} />
+
+
+ Where does your music live?
++ Downloads land in this folder, it is always shared on Soulseek, and albums are filed + into it by the format below. Files already in it are never moved. +
+
+
+ {:else if cur.id === "look"}
+
+
+
+
+
+ Library folder
+ {libraryDir || "Not chosen yet"}
+
+
+
+
+
+ Album folder format
+ Use {"{artist}"}, {"{album}"}, {"{date}"} or {"{year}"}; "\" starts a subfolder.
+
+ {#each PRESETS as [v, l] (v)}
+
+ {/each}
+
+ How the window is drawn
+Both can be changed any time in Settings.
+
+
+ {:else if cur.id === "install"}
+
+
+
+
+ Dark glass
+ Whatever is behind the window glows through the app's dark surfaces with a live blur (Windows acrylic). Menus and dialogs stay solid.
+
+ {glass ? "dark glass" : "solid"}
+
+
+
+
+
+
+ Loudness normalization
+ Every track plays at roughly the same level (−14 LUFS). Off plays each file as recorded.
+
+ {loudness ? "on" : "off"}
+
+
+ {phase.phase === "failed" ? "That did not go through" : "Installing SoulStream"}
++ {#if phase.phase === "failed"} + {phase.detail} + {:else if phase.phase === "downloading"} + Downloading {phase.detail}{pct != null ? ` · ${pct}%` : "…"} + {:else if phase.phase === "verifying"} + {phase.detail} + {:else if phase.phase === "installing"} + {phase.detail} Nothing to click; this takes a moment. + {:else} + {phase.detail || "Starting…"} + {/if} +
+ +-
+
Alpha key{keyOk ? `accepted · SoulStream ${keyOk.version}` : "not set"}
+ Library{libraryDir}
+ Window{glass ? "dark glass" : "solid"}
+
SoulStream is ready
+Installed to {installedAt}. It lives in your Start menu now; your music stays where you chose.
+-
+ {#each [
+ ["key", "Alpha key", keyOk ? "accepted" : "set"],
+ ["folder-open", "Library", libraryDir],
+ ["eye", "Window", glass ? "dark glass" : "solid"],
+ ["volume", "Loudness", loudness ? "normalized" : "as recorded"],
+ ] as [icon, what, value], i (what)}
+
-
+
+ {what} + {value} +
+ {/each}
+
-
- {#each STEPS.slice(1, 5) as s (s.id)}
+ {#each STEPS.slice(1, 6) as s (s.id)}
{s.label}
{/each}
Your alpha key
++ SoulStream is in a closed alpha. New builds come from a private repository, and + this key — one per tester, able only to read them — is how your copy finds + updates. It goes to the Windows Credential Manager, not a plain file. Without it + the app runs, but cannot update itself. +
+
+
{:else if cur.id === "library"}
+
+
+
+
+ Alpha key {#if hasToken}set{/if}
+ {hasToken ? "A key is saved on this computer. Paste another to replace it, or press Next to keep it." : "Paste the key you were given. It starts with github_pat_."}
+ Where does your music live?
@@ -400,6 +445,7 @@
Here is what you chose. Every line of it lives in Settings.
-
{#each [
+ ["key", "Alpha key", hasToken ? "set" : "not set — updates need it"],
["folder-open", "Library", libraryDir || "not chosen"],
["users", "Soulseek", online ? `signed in as ${app.username}` : "not signed in yet"],
["globe", "Community peer", freenetOn ? (displayName.trim() ? `on · ${displayName.trim()}` : "on") : "off"],
@@ -430,7 +476,7 @@
{:else if cur.id === "ready"}
{:else}
- {#if cur.id === "soulseek" && !online}
+ {#if (cur.id === "soulseek" && !online) || (cur.id === "alpha" && !hasToken && !alphaKey.trim())}
{/if}
diff --git a/src/components/UpdateToast.svelte b/src/components/UpdateToast.svelte
index bd1937a..925d018 100644
--- a/src/components/UpdateToast.svelte
+++ b/src/components/UpdateToast.svelte
@@ -3,17 +3,34 @@
// the other toasts, but it STAYS until answered — Install here, or Later
// (the Settings card keeps the offer). Installing on its own was never on
// the table; this is the button the updater's note talks about.
+ //
+ // Its other face, for the closed alpha: a copy whose check failed for
+ // want of the read-only key says so once per session, with the way to
+ // Settings — a tester who skipped the tour's key step still finds out.
import Icon from "./Icon.svelte";
- import { updater, installUpdate, dismissUpdate } from "../lib/updater.svelte.js";
+ import { goToView } from "../lib/state.svelte.js";
+ import { updater, installUpdate, dismissUpdate, dismissNudge } from "../lib/updater.svelte.js";
const available = $derived(updater.status?.available ?? null);
const installing = $derived(!!updater.status?.installing);
const shown = $derived(!!available && !updater.dismissed);
+ const needsKey = $derived(
+ !available
+ && !!updater.status
+ && !updater.status.has_token
+ && /access token/.test(updater.status.last_error ?? "")
+ && !updater.nudgeDismissed,
+ );
const pct = $derived.by(() => {
const p = updater.progress;
if (!p || !p.total) return null;
return Math.min(100, Math.round((p.received / p.total) * 100));
});
+
+ function openSettings() {
+ dismissNudge();
+ goToView("settings");
+ }
{#if shown}
@@ -30,6 +47,15 @@
{/if}
+{:else if needsKey}
+
+
{/if}
+
+