diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
new file mode 100644
index 00000000..8c8d6930
--- /dev/null
+++ b/.github/workflows/pages.yml
@@ -0,0 +1,62 @@
+name: pages
+
+# The website (site/) on GitHub Pages: https://phantomptr.github.io/ps5upload/
+#
+# The page reads GitHub's releases API live in the visitor's browser, so a new release shows
+# up without a deploy. Each deploy also writes site/releases.json, the copy the page falls
+# back on when the API can't be reached (offline, or GitHub's anonymous rate limit).
+#
+# When it deploys:
+# - a change to site/ (or this file) on main;
+# - after the publish workflow finishes. A release made by publish.yml does not fire the
+# `release` event below: GitHub doesn't start workflows from its own token's actions;
+# - a release published, edited or deleted by hand (promoting a pre-release is an edit);
+# - once a day, so the snapshot never drifts far;
+# - by hand (Actions → pages → Run workflow).
+
+on:
+ push:
+ branches: [main]
+ paths: ["site/**", "scripts/site-releases.mjs", ".github/workflows/pages.yml"]
+ workflow_run:
+ workflows: [publish]
+ types: [completed]
+ release:
+ types: [published, edited, deleted]
+ schedule:
+ - cron: "17 6 * * *"
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ deploy:
+ runs-on: ubuntu-24.04
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - uses: actions/checkout@v7
+ with:
+ ref: main
+ - uses: actions/setup-node@v7
+ with:
+ node-version: 22
+ - name: Snapshot the releases (fallback for the page)
+ run: node scripts/site-releases.mjs
+ env:
+ GH_TOKEN: ${{ github.token }}
+ GITHUB_TOKEN: ${{ github.token }}
+ - uses: actions/configure-pages@v5
+ - uses: actions/upload-pages-artifact@v4
+ with:
+ path: site
+ - id: deployment
+ uses: actions/deploy-pages@v4
diff --git a/scripts/site-releases.mjs b/scripts/site-releases.mjs
new file mode 100644
index 00000000..f2e4376b
--- /dev/null
+++ b/scripts/site-releases.mjs
@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// Writes site/releases.json: the website's fallback copy of the newest releases, used when a
+// visitor's browser can't reach GitHub's API (offline, or over its anonymous rate limit).
+// Run by .github/workflows/pages.yml on every deploy and every published release; run it by
+// hand to refresh a local preview: node scripts/site-releases.mjs
+//
+// Uses `gh` when it is installed and signed in (no rate limit worth worrying about), else
+// GITHUB_TOKEN with fetch, else an anonymous fetch.
+import { execFileSync } from "node:child_process";
+import { writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+
+const REPO = "phantomptr/ps5upload";
+const out = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "site", "releases.json");
+
+/** Only what the page reads, so the snapshot stays small. */
+const slim = (list) =>
+ list
+ .filter((r) => !r.draft)
+ .slice(0, 12)
+ .map((r) => ({
+ tag_name: r.tag_name,
+ prerelease: r.prerelease,
+ published_at: r.published_at,
+ html_url: r.html_url,
+ body: r.body,
+ assets: r.assets.map((a) => ({ name: a.name, browser_download_url: a.browser_download_url, size: a.size })),
+ }));
+
+async function fetchReleases() {
+ try {
+ const json = execFileSync("gh", ["api", `repos/${REPO}/releases?per_page=12`], {
+ encoding: "utf8",
+ stdio: ["ignore", "pipe", "ignore"],
+ });
+ return JSON.parse(json);
+ } catch {
+ const headers = { Accept: "application/vnd.github+json" };
+ if (process.env.GITHUB_TOKEN) headers.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
+ const res = await fetch(`https://api.github.com/repos/${REPO}/releases?per_page=12`, { headers });
+ if (!res.ok) throw new Error(`GitHub answered ${res.status}`);
+ return res.json();
+ }
+}
+
+const list = slim(await fetchReleases());
+writeFileSync(out, `${JSON.stringify(list, null, 1)}\n`);
+console.log(`site/releases.json: ${list.length} releases, newest ${list[0]?.tag_name ?? "none"}`);
diff --git a/site/app.js b/site/app.js
new file mode 100644
index 00000000..907e91ed
--- /dev/null
+++ b/site/app.js
@@ -0,0 +1,300 @@
+// PS5Upload website: live releases, the right download for this visitor, the news list, and
+// the light/dark switch. No build step and no dependencies.
+//
+// Releases come from GitHub's API when the page loads, so a new release shows up without a
+// redeploy. If that fails (offline, or GitHub's 60-requests-an-hour limit for anonymous
+// visitors), releases.json is used: a snapshot the Pages workflow writes on every deploy and
+// every published release (scripts/site-releases.mjs).
+"use strict";
+
+const REPO = "phantomptr/ps5upload";
+const API = `https://api.github.com/repos/${REPO}/releases?per_page=12`;
+const NEWS_COUNT = 4;
+
+// ── Theme ──────────────────────────────────────────────────────────────────
+
+const root = document.documentElement;
+const systemDark = () => window.matchMedia("(prefers-color-scheme: dark)").matches;
+const store = {
+ get: (k) => {
+ try {
+ return localStorage.getItem(k);
+ } catch {
+ return null;
+ }
+ },
+ set: (k, v) => {
+ try {
+ localStorage.setItem(k, v);
+ } catch {
+ /* private window: the choice lasts this visit */
+ }
+ },
+};
+
+function applyTheme(theme) {
+ if (theme) root.dataset.theme = theme;
+ else delete root.dataset.theme;
+ const dark = theme ? theme === "dark" : systemDark();
+ // The screenshots follow the page, not only the system.
+ document.querySelectorAll("[data-theme-src]").forEach((s) => {
+ s.media = theme ? "not all" : "(prefers-color-scheme: dark)";
+ });
+ document.querySelectorAll("img[data-theme-img]").forEach((img) => {
+ img.src = `assets/${img.dataset.themeImg}-${dark ? "dark" : "light"}.webp`;
+ });
+}
+applyTheme(store.get("ps5upload.site.theme"));
+document.getElementById("theme").addEventListener("click", () => {
+ const dark = root.dataset.theme ? root.dataset.theme === "dark" : systemDark();
+ const next = dark ? "light" : "dark";
+ store.set("ps5upload.site.theme", next);
+ applyTheme(next);
+});
+
+// ── Copy buttons ───────────────────────────────────────────────────────────
+
+document.addEventListener("click", async (e) => {
+ const btn = e.target.closest("[data-copy]");
+ if (!btn) return;
+ const text = document.getElementById(btn.dataset.copy)?.textContent ?? "";
+ try {
+ await navigator.clipboard.writeText(text);
+ btn.textContent = "Copied";
+ } catch {
+ btn.textContent = "Select and copy";
+ }
+ setTimeout(() => (btn.textContent = "Copy"), 1600);
+});
+
+// ── Releases ───────────────────────────────────────────────────────────────
+
+/** What a release file is, from its name (scripts/gen-updater-manifest.py names them). */
+const KINDS = [
+ { re: /-mac-arm64\.dmg$/, os: "mac", label: "Apple Silicon", note: ".dmg" },
+ { re: /-mac-x64\.dmg$/, os: "mac", label: "Intel", note: ".dmg" },
+ { re: /-win-x64-setup\.exe$/, os: "windows", label: "x64 installer", note: ".exe" },
+ { re: /-win-x64\.zip$/, os: "windows", label: "x64 portable", note: ".zip" },
+ { re: /-win-arm64-setup\.exe$/, os: "windows", label: "ARM64 installer", note: ".exe" },
+ { re: /-win-arm64\.zip$/, os: "windows", label: "ARM64 portable", note: ".zip" },
+ { re: /-linux-x64\.deb$/, os: "linux", label: "x64 Debian, Ubuntu", note: ".deb" },
+ { re: /-linux-x64\.rpm$/, os: "linux", label: "x64 Fedora, openSUSE", note: ".rpm" },
+ { re: /-linux-x64\.zip$/, os: "linux", label: "x64 any distro", note: ".zip" },
+ { re: /-linux-arm64\.deb$/, os: "linux", label: "ARM64 Debian, Ubuntu", note: ".deb" },
+ { re: /-linux-arm64\.rpm$/, os: "linux", label: "ARM64 Fedora, openSUSE", note: ".rpm" },
+ { re: /-linux-arm64\.zip$/, os: "linux", label: "ARM64 any distro", note: ".zip" },
+ { re: /-android\.apk$/, os: "android", label: "Phones and tablets", note: ".apk" },
+ { re: /^ps5upload-[\d.]+\.elf$/, os: "extra", label: "PS5 helper (payload)", note: ".elf" },
+ { re: /^ps5upload-engine-/, os: "extra", label: null, note: "" },
+];
+const OS = {
+ mac: "macOS",
+ windows: "Windows",
+ linux: "Linux",
+ android: "Android",
+};
+
+function detectOs() {
+ const ua = navigator.userAgent;
+ if (/android/i.test(ua)) return "android";
+ if (/windows/i.test(ua)) return "windows";
+ if (/mac os x|macintosh/i.test(ua) && !/iphone|ipad/i.test(ua)) return "mac";
+ if (/linux|x11/i.test(ua)) return "linux";
+ return null;
+}
+
+const mb = (n) => (n >= 1e9 ? `${(n / 1e9).toFixed(1)} GB` : `${Math.max(1, Math.round(n / 1e6))} MB`);
+const date = (iso) =>
+ iso ? new Date(iso).toLocaleDateString(undefined, { year: "numeric", month: "short", day: "numeric" }) : "";
+
+function normalize(list) {
+ return (list || [])
+ .filter((r) => !r.draft)
+ .map((r) => ({
+ tag: r.tag_name,
+ prerelease: !!r.prerelease,
+ published: r.published_at,
+ body: r.body || "",
+ url: r.html_url,
+ assets: (r.assets || []).map((a) => ({ name: a.name, url: a.browser_download_url, size: a.size })),
+ }));
+}
+
+async function loadReleases() {
+ const ctl = new AbortController();
+ const timer = setTimeout(() => ctl.abort(), 6000);
+ try {
+ const res = await fetch(API, { signal: ctl.signal, headers: { Accept: "application/vnd.github+json" } });
+ if (!res.ok) throw new Error(String(res.status));
+ const list = normalize(await res.json());
+ if (list.length) return list;
+ throw new Error("empty");
+ } catch {
+ const res = await fetch("releases.json", { cache: "no-cache" });
+ return normalize(await res.json());
+ } finally {
+ clearTimeout(timer);
+ }
+}
+
+// ── Markdown, the little the release notes use ─────────────────────────────
+
+const esc = (s) => s.replace(/[&<>"']/g, (c) => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" })[c]);
+function inline(s) {
+ return esc(s)
+ .replace(/`([^`]+)`/g, "$1")
+ .replace(/\*\*(.+?)\*\*/g, "$1")
+ .replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, '$1');
+}
+/** The start of a release's notes for the news list: everything up to its first `maxItems`
+ * bullets. `more` says whether anything was left out. */
+function excerpt(md, maxItems = 6) {
+ const lines = md.split(/\r?\n/);
+ let items = 0;
+ for (let i = 0; i < lines.length; i++) {
+ if (lines[i].trim().startsWith("- ") && ++items > maxItems) {
+ return { md: lines.slice(0, i).join("\n"), more: true };
+ }
+ }
+ return { md, more: false };
+}
+
+/** Paragraphs and "- " bullets (with wrapped continuation lines); headings become bold lines. */
+function markdown(md) {
+ const out = [];
+ let list = null;
+ let para = null;
+ const flush = () => {
+ if (para) out.push(`
${inline(para)}
`);
+ para = null;
+ };
+ for (const raw of md.split(/\r?\n/)) {
+ const line = raw.trim();
+ if (!line || line === "---") {
+ flush();
+ if (list) out.push(`
+ PS5Upload sends files, installs packages and manages games on a jailbroken PS5,
+ from your computer or your phone. Encrypted, resumable transfers at the full speed of
+ your network.
+
One app for the whole round trip, built on its own fast transfer protocol.
+
+
+
+
Fast uploads
+
Folders, game images and archives go straight to the console over an encrypted, resumable connection. Thousands of small files are packed together so they don't crawl.
+
+
+
+
Install packages
+
Stream a .pkg from your computer, a link or a NAS while it installs, or copy it first. Updates and DLC install from each game's own page.
+
+
+
+
Convert games
+
Turn a game folder into a package, an exFAT image or a compressed .ffpfsc for ShadowMount+, with AMPR LZ4 asset packs to make images smaller.
+
+
+
+
Your collection
+
Every game on your drives and network shares, grouped by game with its updates, DLC and duplicates, and what each console is missing.
+
+
+
+
Games, saves and files
+
Launch, stop and uninstall games, back up and restore saves, browse the console's drives, and copy straight from one PS5 to another.
+
+
+
+
Desktop, phone or browser
+
Native apps for macOS, Windows, Linux and Android, and a Docker image that serves the same app as a web page from your NAS. In 21 languages.
+
+
+
+
+
+
+
+
+
+
+
+ Drop anything on Upload: what it is gets detected.
+
+
+
+
+
+
+ Convert a folder into a package or a ShadowMount+ image.
+
+
+ 
+ 
+ 
+ 
+ 
+