Skip to content

LordOS — a free, fast and secure GNU/Linux distribution based on Debian, with its own desktop environment: display server and Wayland compositor in C, a React UI engine on QuickJS, and private native apps.

Website: LordOS Imager guide (/imager/, EN/ES/PT) and how to write LordOS in the download section

Federico Pereirae4654218097d
diff --git a/web/build.mjs b/web/build.mjs
index 60bc049..983361e 100644
--- a/web/build.mjs
+++ b/web/build.mjs
@@ -20,6 +20,7 @@ import http from 'node:http';
import { createRequire } from 'node:module';
import { markdown, inline, frontMatter } from './lib/md.mjs';
import { diagram } from './lib/diagram.mjs';
+import { imagerGuide, writeBlock } from './lib/imager-guide.mjs';
const WEB = path.dirname(fileURLToPath(import.meta.url));
const REPO = path.resolve(WEB, '..');
@@ -116,6 +117,8 @@ const docCss = minCss(src('doc.css'));
const docCssUrl = hashed(Buffer.from(docCss), 'doc', 'css');
const homeCss = minCss(src('home.css').replace('__FONT_MEDIUM__', fontMedium));
const homeCssUrl = hashed(Buffer.from(homeCss), 'home', 'css');
+const imagerCss = minCss(src('imager.css'));
+const imagerCssUrl = hashed(Buffer.from(imagerCss), 'imager', 'css');
// [[PLACEHOLDER]] markers left by the content agents: highlighted when --allow-placeholders, else the build fails
const ALLOW_PH = process.argv.includes('--allow-placeholders');
const placeholders = new Map();
@@ -234,6 +237,16 @@ if (faqJson && !ALLOW_PH) {
faqJson.categories = (faqJson.categories || []).filter((c) => c.items.length);
}
const HAS_FAQ = !!(faqJson && (faqJson.categories || []).length);
+// the LordOS Imager guide (/imager/) and the download section's "How to write LordOS" block
+const imagerDir = path.join(CONTENT, 'imager');
+const HAS_GUIDE = LANGS.every((l) => fs.existsSync(path.join(imagerDir, `guide.${l}.json`)));
+const guideText = HAS_GUIDE ? Object.fromEntries(LANGS.map((l) => [l, readJson(path.join(imagerDir, `guide.${l}.json`))])) : {};
+const IMAGER_VIDEO_DIR = process.env.IMAGER_VIDEO_DIR ? path.resolve(process.env.IMAGER_VIDEO_DIR) : path.join(imagerDir, 'video');
+const imagerLinks = (l) => ({
+ mac: `${IMAGER_DL}_universal.dmg`, win: `${IMAGER_DL}_x64_setup.exe`, linux: `${IMAGER_DL}_amd64.deb`,
+ signing: builtPages().has('legal/code-signing') ? pageUrl(l, 'legal/code-signing') : `${GITHUB}/blob/main/docs/SIGNING.md`,
+ switchFiles: `${GITHUB}/blob/main/docs/RASPBERRY.md#switch-files`,
+});
const footerFile = path.join(CONTENT, 'footer.json');
const footerJson = fs.existsSync(footerFile) ? readJson(footerFile) : null;
log(`content: ${legalPages.length} legal pages${legalHeld.length ? ` (held back, placeholders: ${legalHeld.join(', ')})` : ''}, FAQ ${HAS_FAQ ? 'yes' : 'no'}${faqHeld ? ` (${faqHeld} questions with placeholders hidden)` : ''}, footer.json ${footerJson ? 'yes' : 'no'}`);
@@ -278,7 +291,7 @@ ${alts}
<link rel="apple-touch-icon" href="/apple-touch-icon.png">
<link rel="preload" href="${fontExtraBold}" as="font" type="font/woff2" crossorigin>
<link rel="preload" href="${fontMedium}" as="font" type="font/woff2" crossorigin>
-<link rel="stylesheet" href="${cssUrl}">${doc ? `\n<link rel="stylesheet" href="${doc === 'home' ? homeCssUrl : docCssUrl}">` : ''}
+<link rel="stylesheet" href="${cssUrl}">${doc ? `\n<link rel="stylesheet" href="${doc === 'home' ? homeCssUrl : doc === 'imager' ? imagerCssUrl : docCssUrl}">` : ''}
<meta property="og:type" content="website">
<meta property="og:site_name" content="LordOS">
<meta property="og:title" content="${esc(title)}">
@@ -382,7 +395,7 @@ function linkBuilt(href) {
}
let _built = null;
function builtPages() {
- if (!_built) _built = new Set(['', 'apps', 'gallery', 'about', ...featureList.map((m) => 'features/' + m.slug), ...(HAS_PAPER ? ['paper'] : []), ...(HAS_FAQ ? ['faq'] : []), ...legalPages.map((x) => 'legal/' + x.slug), ...(legalPages.length ? ['legal', ...LEGAL_MOVED.map((m) => 'legal/' + m[0])] : [])]);
+ if (!_built) _built = new Set(['', 'apps', 'gallery', 'about', ...(HAS_GUIDE ? ['imager'] : []), ...featureList.map((m) => 'features/' + m.slug), ...(HAS_PAPER ? ['paper'] : []), ...(HAS_FAQ ? ['faq'] : []), ...legalPages.map((x) => 'legal/' + x.slug), ...(legalPages.length ? ['legal', ...LEGAL_MOVED.map((m) => 'legal/' + m[0])] : [])]);
return _built;
}
// one-slot language picker: a <details> dropdown of plain links (works without JS; keeps the page)
@@ -473,7 +486,7 @@ ${icons}
</section>`;
}
-const tpl = { home: src('home.html'), gallery: src('gallery.html'), apps: src('apps.html'), notFound: src('404.html'), lightbox: src('lightbox.html'), feature: src('feature.html'), paper: src('paper.html'), legal: src('legal.html'), legalIndex: src('legal-index.html'), faq: src('faq.html'), about: src('about.html') };
+const tpl = { imager: src('imager.html'), home: src('home.html'), gallery: src('gallery.html'), apps: src('apps.html'), notFound: src('404.html'), lightbox: src('lightbox.html'), feature: src('feature.html'), paper: src('paper.html'), legal: src('legal.html'), legalIndex: src('legal-index.html'), faq: src('faq.html'), about: src('about.html') };
for (const l of LANGS) {
const t = dict[l];
@@ -570,6 +583,7 @@ ${featureList[i] ? `<a class="more" href="${pageUrl(l, 'features/' + featureList
return `<div class="laptop" id="hero-show" role="region" aria-roledescription="carousel" aria-label="${esc(H.carousel)}"><div class="lp-screen"><span class="lp-cam" aria-hidden="true"></span><div class="lp-display">${slides}</div></div><div class="lp-base" aria-hidden="true"><span class="lp-notch"></span></div>${ctl}</div><ul class="stats">${pills}</ul>`;
})(),
fingerprint: FINGERPRINT, banner: l === 'en' ? banner() : '',
+ writeBlock: HAS_GUIDE ? writeBlock({ l, t, g: guideText[l], esc, links: imagerLinks(l), version: PKG.version, guideUrl: pageUrl(l, 'imager') }) : '',
imagerMac: `${IMAGER_DL}_universal.dmg`, imagerWin: `${IMAGER_DL}_x64_setup.exe`, imagerLinux: `${IMAGER_DL}_amd64.deb`,
faqServer: HAS_FAQ ? pageUrl(l, 'faq') + '#server-vps' : `${GITHUB}/blob/main/docs/INSTALL-DEBIAN.md#servers-and-vps`,
}, t));
@@ -794,6 +808,17 @@ ${(c.items || []).map((it) => {
}
}
+// the LordOS Imager guide, per language
+if (HAS_GUIDE) {
+ for (const l of LANGS) {
+ const t = dict[l];
+ const { main, meta } = imagerGuide({ content: imagerDir, repo: REPO, lang: l, t, g: guideText[l], version: PKG.version, esc, webp, hashed, read, lumo: LUMO, pageUrl, prefix, links: imagerLinks(l), videoDir: IMAGER_VIDEO_DIR });
+ write(path.join(pageUrl(l, 'imager'), 'index.html'), render(tpl.imager, {
+ js: jsUrl, header: header(t, 'imager'), footer: footer(t, 'imager'), head: head(t, 'imager', meta, 'imager'), lightbox: render(tpl.lightbox, {}, t), main,
+ }, t));
+ }
+}
+
// 404 (English, noindex)
write('404.html', render(tpl.notFound, {
img, js: jsUrl, toTop: toTop(dict.en),
@@ -829,7 +854,7 @@ if (fs.existsSync(secTxt)) {
else log('security.txt held back: it still has placeholders');
}
write('robots.txt', `User-agent: *\nAllow: /\n\nSitemap: ${SITE}/sitemap.xml\n`);
-const allPages = [...PAGES.filter((p) => p !== 'apps' || HAS_APPS), ...featureList.map((m) => 'features/' + m.slug), ...(HAS_PAPER ? ['paper'] : []), ...(HAS_FAQ ? ['faq'] : []), 'about', ...legalPages.map((p) => 'legal/' + p.slug), ...(legalPages.length ? ['legal'] : [])];
+const allPages = [...PAGES.filter((p) => p !== 'apps' || HAS_APPS), ...featureList.map((m) => 'features/' + m.slug), ...(HAS_PAPER ? ['paper'] : []), ...(HAS_FAQ ? ['faq'] : []), 'about', ...(HAS_GUIDE ? ['imager'] : []), ...legalPages.map((p) => 'legal/' + p.slug), ...(legalPages.length ? ['legal'] : [])];
const urls = allPages.flatMap((p) => LANGS.map((l) => ` <url>
<loc>${SITE}${pageUrl(l, p)}</loc>
<lastmod>${today}</lastmod>
@@ -864,7 +889,7 @@ for (const f of html) {
const jsSize = Buffer.byteLength(jsSrc) + Buffer.byteLength(themeSrc), cssSize = Buffer.byteLength(css);
if (jsSize > 15 * 1024) throw new Error(`JS is ${jsSize} bytes (limit 15 KB)`);
if (cssSize > 30 * 1024) throw new Error(`site.css is ${cssSize} bytes (limit 30 KB)`);
-for (const [n, c] of [['doc.css', docCss], ['home.css', homeCss]]) if (c.length > 30 * 1024) throw new Error(`${n} is ${c.length} bytes (limit 30 KB)`);
+for (const [n, c] of [['doc.css', docCss], ['home.css', homeCss], ['imager.css', imagerCss]]) if (c.length > 30 * 1024) throw new Error(`${n} is ${c.length} bytes (limit 30 KB)`);
log(`built ${html.length} pages into web/dist (js ${jsSize} B, css ${cssSize} B, ${shots.length} gallery images, ${apps.length} apps); install.sh byte-identical`);
// ---------- paper PDFs (headless Chromium prints the built page) ----------
diff --git a/web/content/imager/guide.en.json b/web/content/imager/guide.en.json
new file mode 100644
index 0000000..943cbcb
--- /dev/null
+++ b/web/content/imager/guide.en.json
@@ -0,0 +1,145 @@
+{
+ "meta": ["How to use LordOS Imager · LordOS", "Write LordOS to an SD card or a USB stick and set up the Raspberry Pi 5's first boot, screen by screen: device, system image, storage, customisation, writing and the first boot."],
+ "kicker": "Guide · LordOS Imager",
+ "title": "How to use LordOS Imager",
+ "lead": "Write LordOS to an SD card or a USB stick from your computer and set up the Raspberry Pi 5's first boot. Screen by screen, in about ten minutes.",
+ "version": "Version {v} · free and open source · collects nothing",
+ "alsoIn": "Already on LordOS? It’s in App Launcher → System.",
+ "hello": "Hi, I'm Lumo! I'll walk you through every screen.",
+ "heroAlt": "LordOS Imager: choose your device",
+ "needTitle": "What you need",
+ "need": [
+ ["Your computer", "With LordOS Imager installed, and an internet connection for the download."],
+ ["An SD card or USB stick", "16 GB or more is best (8 GB at the very least). Everything on it will be erased."],
+ ["A Raspberry Pi 5", "4 GB of memory at least, 8 GB or 16 GB for a smoother desktop. A fan and the 27 W power supply are recommended."],
+ ["About ten minutes", "Most of it is the download and the write, which run by themselves."]
+ ],
+ "videoTitle": "Watch it first",
+ "videoLead": "A short tour of every step, narrated in English, with subtitles in English, Spanish and Portuguese.",
+ "videoSoon": "Video coming soon",
+ "videoSoonText": "Meanwhile, every step is below with its screenshot.",
+ "videoCredit": "Narration: Kokoro TTS, voice Michael (Apache 2.0)",
+ "videoFallback": "Your browser can't play this video. Download it:",
+ "tocLabel": "Steps",
+ "stepWord": "Step",
+ "tipFrom": "Lumo's tip",
+ "open": "Open larger",
+ "steps": [
+ {
+ "id": "device", "title": "Choose your device",
+ "text": "Pick **Raspberry Pi 5** to prepare an SD card for the board, or **PC (USB stick)** to write the live system for a computer. Under the Pi, a bar shows how much memory it needs.",
+ "points": ["4 GB is the minimum, 8 GB is comfortable and 16 GB gives the best performance.", "Only boards LordOS really supports can be chosen."],
+ "shots": [["01-device", "Step 1: the device, with the memory advice for the Raspberry Pi 5"]],
+ "tip": ["wave", "No guesswork", "If your board isn't supported yet, I say so instead of letting you write a card that won't start."]
+ },
+ {
+ "id": "image", "title": "Choose the system image",
+ "text": "The latest LordOS release is already selected and marked **Signed by LordOS**. The download is kept, so the next card is quicker.",
+ "points": ["Older releases are one click away.", "You can also use an image file of your own (`.img`, `.img.xz` or `.iso`). It's written and checked, but nobody vouches for where it came from."],
+ "shots": [["02-image", "Step 2: the latest signed LordOS release"]],
+ "tip": ["shield", "Only signed images", "Official images are checked against the LordOS release key before anything is erased."]
+ },
+ {
+ "id": "storage", "title": "Choose the card or USB stick",
+ "text": "Insert the SD card (with a card reader if your computer needs one) or plug in the USB stick. It shows up by itself, with its name and size. Select it and read the red warning: everything on it will be erased.",
+ "points": ["Only removable drives are listed. Your computer's own disks never appear here.", "A card that's too small or write-protected is shown greyed out, with the reason."],
+ "shots": [["04-storage", "Step 3: the SD card, selected, with the erase warning"]],
+ "tip": ["wave", "Everything on it goes", "Copy anything you want to keep from the card first."]
+ },
+ {
+ "id": "customise", "title": "Customise the first boot",
+ "text": "Leave **Prepare the first boot** on and the board starts ready: its name, your account, Wi-Fi, remote access, look and cooling. Seven tabs, and everything can be changed later in Settings. (For a PC stick there's nothing to customise: this step is skipped.)",
+ "subs": [
+ ["05-tab-general", "General", "The **computer name** is how you'll find the board on your network: here `lordos-pi`, so `lordos-pi.local`. Then the language, time zone, keyboard layout and Wi-Fi country."],
+ ["06-tab-user", "User", "Your administrator account: full name, user name and a password typed twice. Only a one-way hash of the password goes on the card. Automatic login is optional."],
+ ["07-tab-wifi", "Wi-Fi", "The network name exactly as it appears (capitals count) and its password. The card keeps the network's derived key, never the password you typed. Hidden and open networks work too."],
+ ["08-tab-remote", "Remote access", "Remote login (SSH): off, keys only (recommended) or password and keys. You can also turn on LordOS remote desktop; it stays on your local network."],
+ ["09-tab-look", "Appearance", "Lord Default or Classic, light or dark, an accent color and a wallpaper."],
+ ["10-tab-cooling", "Cooling", "Tell LordOS what keeps the board cool and it picks the fan curve to match. Not sure? See [Which cooling do I have?](#cooling)."],
+ ["11-tab-cooling-overclock", "Mild overclock", "Only with a fan: 2.6 GHz instead of 2.4 GHz, with no extra voltage. The warning explains how to undo it."],
+ ["12-tab-more", "More", "Bluetooth, automatic update checks, and a promise: LordOS collects nothing."],
+ ["13-profiles", "Profiles", "Save these settings to reuse them for the next card. Passwords and Wi-Fi keys are never saved: you type them again."]
+ ],
+ "tip": ["shield", "Nothing secret in clear", "Your password and your Wi-Fi password never reach the card as they are: only a hash and a derived key."]
+ },
+ {
+ "id": "write", "title": "Check and write",
+ "text": "A summary of everything you chose, then **Erase and write** asks one last time. From there the imager does it all by itself:",
+ "points": ["checks the release signature, then downloads the image (an interrupted download resumes);", "checks the image, writes it, then reads the whole card back and compares;", "saves the first-boot settings and ejects the card."],
+ "shots": [["14-write-summary", "The summary before writing"], ["15-write-confirm", "The last confirmation"], ["16-downloading", "Downloading, with speed and time left"], ["17-writing", "Writing to the card"], ["18-verifying", "Reading the card back and comparing"]],
+ "tip": ["run", "Leave it plugged in", "Cancel is safe: the card is cleared so it never looks half-written. The download is kept for next time."]
+ },
+ {
+ "id": "done", "title": "Done!",
+ "text": "Lumo celebrates and lists what comes next, with the exact name of your board on the network and the commands for remote login and remote desktop. A sound and a notification tell you it's finished.",
+ "shots": [["19-done", "Done: written, verified and ejected, with the next steps"]]
+ },
+ {
+ "id": "firstboot", "title": "The first boot on the Raspberry Pi 5",
+ "text": "Put the card in the board, connect the monitor, keyboard and mouse, then the power supply. The LordOS crown and a progress bar appear while the system grows to fill the card and applies your settings. After about a minute the login screen shows your account.",
+ "points": ["From another computer at home it's `lordos-pi.local`.", "Remote login: `ssh [email protected]`.", "Remote desktop, if you turned it on: `https://lordos-pi.local:5673`."],
+ "boot": [["docs/boot/splash-preview.png", "The boot screen while the first boot runs"], ["docs/screenshots/greeter.png", "The login screen (shown with example accounts)"]],
+ "tip": ["celebrate", "Welcome home", "The settings file is applied once, then overwritten and deleted from the card."]
+ }
+ ],
+ "coolTitle": "Which cooling do I have?",
+ "coolLead": "Pick what is physically on your board. It sets the fan curve and the clock speed, and you can change it later in Settings.",
+ "cool": [
+ ["case-fan", "Case with a fan", "A closed case with its own built-in fan, plugged into the board's fan connector. Many aluminium cases are like this.", "Have a case with a fan? Choose **Case with a fan**."],
+ ["active-cooler", "Active cooler", "A small heatsink with a fan on top that clips straight onto the board.", "Choose **Active cooler**."],
+ ["passive", "Passive case", "A metal case or a heatsink that cools without any fan.", "Choose **Passive case**."],
+ ["none", "Nothing", "A bare board. It works, but under load it slows itself down within minutes.", "Choose **Nothing**: a gentler clock avoids that."]
+ ],
+ "profTitle": "Profiles",
+ "profHead": ["Cooling", "Profiles", "What they do"],
+ "prof": [
+ ["With a fan (case or active cooler)", "**Balanced** (default), Performance, Quiet", "Balanced: the fan starts at 55 °C. Performance: from 45 °C, and the processor stays at full speed. Quiet: from 60 °C."],
+ ["Passive case", "**Balanced** (default), Conservative", "There's no fan to drive. Conservative caps the clock at 2.0 GHz."],
+ ["Nothing", "**Conservative** (default), Balanced", "2.0 GHz, so a bare board doesn't reach 85 °C and throttle."]
+ ],
+ "ocTitle": "Mild overclock (only with a fan)",
+ "ocText": "2.6 GHz instead of 2.4 GHz, with no extra voltage. Not every board is stable: if yours doesn't start, open the card's boot partition on another computer and delete the `lordos-firstrun` block in `config.txt`.",
+ "optTitle": "App options",
+ "optText": "**App options**, at the bottom of the sidebar: a sound and ejecting when finished, checking for app updates, language and appearance, and the download folder, with how much it uses and a button to clear it.",
+ "optShot": ["20-options", "App options"],
+ "secTitle": "Safe by design",
+ "secLead": "What LordOS Imager does to protect your card, your board and you.",
+ "sec": [
+ ["Signed images only", "Before anything is erased, the release's list of files is checked against the LordOS release key, and the image's SHA-256 against that list. While writing, the image is hashed again."],
+ ["Read back and compared", "After writing, the whole card is read back and compared with what was written."],
+ ["Your password stays yours", "It becomes a one-way hash before it's written. Wi-Fi is stored as the network's derived key."],
+ ["Applied once, then deleted", "The board checks the settings file strictly, applies it once, then overwrites and deletes it. An invalid file applies nothing."],
+ ["Only cards and USB drives", "Your computer's own disks are never listed, and your computer asks for an administrator's approval before the drive is opened."],
+ ["Nothing collected", "No account, no usage data, no crash reports. The imager only talks to the LordOS releases page to list and download images."]
+ ],
+ "secLink": "How LordOS signs its releases",
+ "faqTitle": "Troubleshooting",
+ "faq": [
+ ["My card isn't listed", "Only removable drives appear: SD cards and USB drives. Use a card reader if your computer has no slot, and wait a few seconds: the list updates by itself. A card whose lock switch is on, or one under 8 GB, is shown greyed out with the reason. Your computer's own disks are never shown, on purpose."],
+ ["It says the signature didn't verify", "Then nothing was written and nothing was erased. The downloaded files don't match what LordOS signed, usually because a download broke. Open **App options → Downloads → Clear** and try again. If it keeps happening, tell us (see the security page)."],
+ ["The board doesn't join my Wi-Fi", "Check the network name (capitals count), the password and the Wi-Fi country in **General**. A network that only accepts WPA3 needs its password on the board itself: connect a network cable once and add it in **Settings → Network**."],
+ ["I can't find lordos-pi.local", "Give the first boot a minute or two, and make sure your computer is on the same network (guest networks often keep devices apart). The login screen shows the board's address in its corner; you can use that address instead of the name."],
+ ["How do I log in with SSH?", "If you turned it on: `ssh [email protected]` (with your user name and computer name). Keys only is the safest choice. You can turn it on or off later in **Settings → Sharing**. The root account never logs in."],
+ ["The board doesn't start after the overclock", "Put the card in your computer, open its boot partition and delete the block between `# >>> lordos-firstrun` and `# <<< lordos-firstrun` in `config.txt`. The board starts at its normal speed again."],
+ ["I skipped Customise. Now what?", "The board starts in setup mode and logs in by itself. Create your account in **Settings → Users**; on the next start the setup account is removed. Don't turn on remote desktop until then."],
+ ["Can I write a USB stick for a PC?", "Yes: choose **PC (USB stick)** in step 1. It writes the LordOS live system; boot the PC from the stick to try it, then install it from there."]
+ ],
+ "endTitle": "Ready? Get LordOS Imager",
+ "endText": "Free and open source. Every official image is checked against the release signature before anything is erased.",
+ "endOther": "Prefer another way to write the card? See the download section.",
+ "shotsNote": "Screens from LordOS Imager {v} with demo values: user “demo”, computer “lordos-pi”, network “HomeNetwork”.",
+ "home": {
+ "title": "How to write LordOS to a USB stick or SD card",
+ "lead": "For the PC (ISO) and for the Raspberry Pi 5 image.",
+ "badge": "Recommended",
+ "steps": ["Choose your device and the latest signed LordOS.", "Pick the card or USB stick and, for the Pi, set up the first boot.", "Write: it checks the signature, writes and reads the card back."],
+ "guide": "Step-by-step guide",
+ "optTitle": "Prefer your usual tool? That's fine.",
+ "optText": "Download the ISO or the Raspberry Pi image from the release, check it against SHA256SUMS and write it with any image writer app, or with `dd`. `/dev/sdX` is the whole card or stick, not a partition.",
+ "optPc": "PC (ISO)",
+ "optPi": "Raspberry Pi 5",
+ "optVerify": "How to check the signature of SHA256SUMS",
+ "optPiSetup": "Without LordOS Imager the Pi starts in setup mode. To prepare it, put `lordos-user.txt` and the switch files (`ssh`, `remote-desktop`) on the card's boot partition before the first boot.",
+ "optPiLink": "Switch files and lordos-user.txt"
+ }
+}
diff --git a/web/content/imager/guide.es.json b/web/content/imager/guide.es.json
new file mode 100644
index 0000000..0322e9c
--- /dev/null
+++ b/web/content/imager/guide.es.json
@@ -0,0 +1,145 @@
+{
+ "meta": ["Cómo usar LordOS Imager · LordOS", "Grabá LordOS en una tarjeta SD o un pendrive y prepará el primer arranque de la Raspberry Pi 5, pantalla por pantalla: dispositivo, imagen del sistema, almacenamiento, personalización, grabación y primer arranque."],
+ "kicker": "Guía · LordOS Imager",
+ "title": "Cómo usar LordOS Imager",
+ "lead": "Grabá LordOS en una tarjeta SD o un pendrive desde tu computadora y prepará el primer arranque de la Raspberry Pi 5. Pantalla por pantalla, en unos diez minutos.",
+ "version": "Versión {v} · libre y de código abierto · no recopila nada",
+ "alsoIn": "¿Ya usás LordOS? Está en Apps → Sistema.",
+ "hello": "¡Hola, soy Lumo! Te acompaño en cada pantalla.",
+ "heroAlt": "LordOS Imager: elegí tu dispositivo",
+ "needTitle": "Qué necesitás",
+ "need": [
+ ["Tu computadora", "Con LordOS Imager instalado y conexión a internet para la descarga."],
+ ["Una tarjeta SD o un pendrive", "Mejor de 16 GB o más (8 GB como mínimo). Se borra todo lo que tenga."],
+ ["Una Raspberry Pi 5", "Con 4 GB de memoria como mínimo; con 8 o 16 GB el escritorio va más fluido. Se recomiendan un ventilador y la fuente de 27 W."],
+ ["Unos diez minutos", "Casi todo es la descarga y la grabación, que avanzan solas."]
+ ],
+ "videoTitle": "Miralo primero",
+ "videoLead": "Un recorrido corto por cada paso, narrado en inglés, con subtítulos en inglés, español y portugués.",
+ "videoSoon": "Video muy pronto",
+ "videoSoonText": "Mientras tanto, cada paso está acá abajo con su captura.",
+ "videoCredit": "Narración: Kokoro TTS, voz Michael (Apache 2.0)",
+ "videoFallback": "Tu navegador no puede reproducir este video. Descargalo:",
+ "tocLabel": "Pasos",
+ "stepWord": "Paso",
+ "tipFrom": "El consejo de Lumo",
+ "open": "Ver más grande",
+ "steps": [
+ {
+ "id": "device", "title": "Elegí tu dispositivo",
+ "text": "Elegí **Raspberry Pi 5** para preparar una tarjeta SD para la placa, o **PC (pendrive USB)** para grabar el sistema en vivo para una computadora. Debajo de la Pi, una barra muestra cuánta memoria necesita.",
+ "points": ["4 GB es el mínimo, 8 GB es cómodo y 16 GB da el mejor rendimiento.", "Solo se pueden elegir las placas que LordOS realmente soporta."],
+ "shots": [["01-device", "Paso 1: el dispositivo, con la recomendación de memoria para la Raspberry Pi 5"]],
+ "tip": ["wave", "Sin adivinar", "Si tu placa todavía no está soportada, te lo digo en vez de dejarte grabar una tarjeta que no va a arrancar."]
+ },
+ {
+ "id": "image", "title": "Elegí la imagen del sistema",
+ "text": "La última versión de LordOS ya viene elegida y marcada **Firmada por LordOS**. La descarga se guarda, así la próxima tarjeta es más rápida.",
+ "points": ["Las versiones anteriores están a un clic.", "También podés usar un archivo de imagen propio (`.img`, `.img.xz` o `.iso`). Se graba y se verifica, pero nadie responde por su origen."],
+ "shots": [["02-image", "Paso 2: la última versión firmada de LordOS"]],
+ "tip": ["shield", "Solo imágenes firmadas", "Las imágenes oficiales se verifican con la clave de publicación de LordOS antes de borrar nada."]
+ },
+ {
+ "id": "storage", "title": "Elegí la tarjeta o el pendrive",
+ "text": "Poné la tarjeta SD (con un lector si tu computadora lo necesita) o conectá el pendrive. Aparece sola, con su nombre y su tamaño. Elegila y leé el aviso en rojo: se borra todo lo que tenga.",
+ "points": ["Solo se muestran unidades extraíbles. Los discos de tu computadora nunca aparecen acá.", "Una tarjeta demasiado chica o protegida contra escritura aparece en gris, con el motivo."],
+ "shots": [["04-storage", "Paso 3: la tarjeta SD elegida, con el aviso de borrado"]],
+ "tip": ["wave", "Se borra todo", "Copiá antes lo que quieras conservar de la tarjeta."]
+ },
+ {
+ "id": "customise", "title": "Personalizá el primer arranque",
+ "text": "Dejá activado **Preparar el primer arranque** y la placa arranca lista: su nombre, tu cuenta, el Wi-Fi, el acceso remoto, la apariencia y la refrigeración. Son siete pestañas y todo se puede cambiar después en Ajustes. (Para un pendrive de PC no hay nada que personalizar: este paso se saltea.)",
+ "subs": [
+ ["05-tab-general", "General", "El **nombre de la computadora** es cómo vas a encontrar la placa en tu red: acá `lordos-pi`, o sea `lordos-pi.local`. Después, el idioma, la zona horaria, la distribución del teclado y el país del Wi-Fi."],
+ ["06-tab-user", "Usuario", "Tu cuenta de administrador: nombre completo, nombre de usuario y una contraseña escrita dos veces. A la tarjeta solo va un hash de un solo sentido de la contraseña. El inicio de sesión automático es opcional."],
+ ["07-tab-wifi", "Wi-Fi", "El nombre de la red tal como aparece (las mayúsculas cuentan) y su contraseña. La tarjeta guarda la clave derivada de la red, nunca la contraseña que escribiste. También sirven las redes ocultas y abiertas."],
+ ["08-tab-remote", "Acceso remoto", "Inicio de sesión remoto (SSH): apagado, solo claves (lo recomendado) o contraseña y claves. También podés activar el escritorio remoto de LordOS; queda en tu red local."],
+ ["09-tab-look", "Apariencia", "Lord Default o Clásico, claro u oscuro, un color de acento y un fondo de pantalla."],
+ ["10-tab-cooling", "Refrigeración", "Contale a LordOS qué enfría la placa y elige la curva del ventilador que corresponde. ¿No sabés cuál? Mirá [¿Qué refrigeración tengo?](#cooling)."],
+ ["11-tab-cooling-overclock", "Overclock suave", "Solo con ventilador: 2,6 GHz en lugar de 2,4 GHz, sin más voltaje. El aviso explica cómo deshacerlo."],
+ ["12-tab-more", "Más", "Bluetooth, la búsqueda automática de actualizaciones y una promesa: LordOS no recopila nada."],
+ ["13-profiles", "Perfiles", "Guardá estos ajustes para usarlos en la próxima tarjeta. Las contraseñas y las claves de Wi-Fi nunca se guardan: las escribís de nuevo."]
+ ],
+ "tip": ["shield", "Nada secreto en claro", "Tu contraseña y la del Wi-Fi nunca llegan a la tarjeta tal cual: solo un hash y una clave derivada."]
+ },
+ {
+ "id": "write", "title": "Revisá y grabá",
+ "text": "Un resumen de todo lo que elegiste y, al tocar **Borrar y grabar**, una última confirmación. Desde ahí el imager hace todo solo:",
+ "points": ["verifica la firma de la versión y después descarga la imagen (una descarga interrumpida se retoma);", "verifica la imagen, la graba y después lee toda la tarjeta y la compara;", "guarda los ajustes del primer arranque y expulsa la tarjeta."],
+ "shots": [["14-write-summary", "El resumen antes de grabar"], ["15-write-confirm", "La última confirmación"], ["16-downloading", "Descargando, con la velocidad y el tiempo restante"], ["17-writing", "Grabando la tarjeta"], ["18-verifying", "Leyendo la tarjeta y comparando"]],
+ "tip": ["run", "Dejala conectada", "Cancelar es seguro: la tarjeta se limpia para que nunca parezca grabada a medias. La descarga queda guardada."]
+ },
+ {
+ "id": "done", "title": "¡Listo!",
+ "text": "Lumo festeja y te muestra lo que sigue, con el nombre exacto de tu placa en la red y los comandos para el inicio de sesión remoto y el escritorio remoto. Un sonido y una notificación te avisan que terminó.",
+ "shots": [["19-done", "Listo: grabada, verificada y expulsada, con los próximos pasos"]]
+ },
+ {
+ "id": "firstboot", "title": "El primer arranque en la Raspberry Pi 5",
+ "text": "Poné la tarjeta en la placa, conectá el monitor, el teclado y el mouse, y después la fuente. Aparecen la corona de LordOS y una barra de progreso mientras el sistema crece hasta ocupar la tarjeta y aplica tus ajustes. En más o menos un minuto, la pantalla de inicio de sesión muestra tu cuenta.",
+ "points": ["Desde otra computadora de tu casa es `lordos-pi.local`.", "Inicio de sesión remoto: `ssh [email protected]`.", "Escritorio remoto, si lo activaste: `https://lordos-pi.local:5673`."],
+ "boot": [["docs/boot/splash-preview.png", "La pantalla de arranque durante el primer arranque"], ["docs/screenshots/greeter.png", "La pantalla de inicio de sesión (con cuentas de ejemplo)"]],
+ "tip": ["celebrate", "Bienvenida a casa", "El archivo de ajustes se aplica una sola vez y después se sobrescribe y se borra de la tarjeta."]
+ }
+ ],
+ "coolTitle": "¿Qué refrigeración tengo?",
+ "coolLead": "Elegí lo que tu placa tiene puesto. Define la curva del ventilador y la velocidad del procesador, y lo podés cambiar después en Ajustes.",
+ "cool": [
+ ["case-fan", "Caja con ventilador", "Una caja cerrada con su propio ventilador incorporado, enchufado al conector de ventilador de la placa. Muchas cajas de aluminio son así.", "¿Tenés una caja con ventilador? Elegí **Caja con ventilador**."],
+ ["active-cooler", "Disipador activo", "Un disipador chico con un ventilador encima, que se engancha directo sobre la placa.", "Elegí **Disipador activo**."],
+ ["passive", "Caja pasiva", "Una caja de metal o un disipador que enfría sin ningún ventilador.", "Elegí **Caja pasiva**."],
+ ["none", "Nada", "La placa sola. Funciona, pero con carga se frena sola en pocos minutos.", "Elegí **Nada**: un reloj más suave lo evita."]
+ ],
+ "profTitle": "Perfiles",
+ "profHead": ["Refrigeración", "Perfiles", "Qué hacen"],
+ "prof": [
+ ["Con ventilador (caja o disipador activo)", "**Equilibrado** (predeterminado), Rendimiento, Silencioso", "Equilibrado: el ventilador arranca a 55 °C. Rendimiento: desde 45 °C, y el procesador queda a toda velocidad. Silencioso: desde 60 °C."],
+ ["Caja pasiva", "**Equilibrado** (predeterminado), Conservador", "No hay ventilador que manejar. Conservador limita el reloj a 2,0 GHz."],
+ ["Nada", "**Conservador** (predeterminado), Equilibrado", "2,0 GHz, para que la placa sola no llegue a 85 °C y se frene."]
+ ],
+ "ocTitle": "Overclock suave (solo con ventilador)",
+ "ocText": "2,6 GHz en lugar de 2,4 GHz, sin más voltaje. No todas las placas son estables: si la tuya no arranca, abrí la partición de arranque de la tarjeta en otra computadora y borrá el bloque `lordos-firstrun` de `config.txt`.",
+ "optTitle": "Opciones de la app",
+ "optText": "**Opciones de la app**, abajo en la barra lateral: un sonido y expulsar al terminar, buscar actualizaciones de la app, idioma y apariencia, y la carpeta de descargas, con cuánto ocupa y un botón para vaciarla.",
+ "optShot": ["20-options", "Opciones de la app"],
+ "secTitle": "Seguro por diseño",
+ "secLead": "Lo que hace LordOS Imager para cuidar tu tarjeta, tu placa y a vos.",
+ "sec": [
+ ["Solo imágenes firmadas", "Antes de borrar nada, la lista de archivos de la versión se verifica con la clave de publicación de LordOS, y el SHA-256 de la imagen con esa lista. Mientras graba, la imagen se vuelve a calcular."],
+ ["Leída y comparada", "Después de grabar, se lee toda la tarjeta y se compara con lo que se grabó."],
+ ["Tu contraseña sigue siendo tuya", "Se convierte en un hash de un solo sentido antes de grabarse. El Wi-Fi se guarda como la clave derivada de la red."],
+ ["Se aplica una vez y se borra", "La placa revisa el archivo de ajustes de forma estricta, lo aplica una vez y después lo sobrescribe y lo borra. Un archivo inválido no aplica nada."],
+ ["Solo tarjetas y pendrives", "Los discos de tu computadora nunca aparecen, y tu computadora pide la aprobación de un administrador antes de abrir la unidad."],
+ ["No recopila nada", "Sin cuenta, sin datos de uso, sin informes de fallos. El imager solo habla con la página de versiones de LordOS para listar y descargar imágenes."]
+ ],
+ "secLink": "Cómo firma LordOS sus versiones",
+ "faqTitle": "Si algo no sale",
+ "faq": [
+ ["Mi tarjeta no aparece", "Solo aparecen unidades extraíbles: tarjetas SD y pendrives. Usá un lector si tu computadora no tiene ranura y esperá unos segundos: la lista se actualiza sola. Una tarjeta con la traba puesta, o de menos de 8 GB, aparece en gris con el motivo. Los discos de tu computadora nunca se muestran, a propósito."],
+ ["Dice que la firma no se pudo verificar", "Entonces no se grabó ni se borró nada. Los archivos descargados no coinciden con lo que firmó LordOS, casi siempre porque se cortó una descarga. Abrí **Opciones de la app → Descargas → Vaciar** y probá de nuevo. Si sigue pasando, avisanos (mirá la página de seguridad)."],
+ ["La placa no se conecta a mi Wi-Fi", "Revisá el nombre de la red (las mayúsculas cuentan), la contraseña y el país del Wi-Fi en **General**. Una red que solo acepta WPA3 necesita su contraseña en la placa: conectá un cable de red una vez y agregala en **Ajustes → Red**."],
+ ["No encuentro lordos-pi.local", "Dale un minuto o dos al primer arranque y fijate que tu computadora esté en la misma red (las redes de invitados suelen separar los equipos). La pantalla de inicio de sesión muestra la dirección de la placa en una esquina; podés usar esa dirección en lugar del nombre."],
+ ["¿Cómo entro por SSH?", "Si lo activaste: `ssh [email protected]` (con tu usuario y el nombre de tu computadora). Solo claves es lo más seguro. Lo podés activar o apagar después en **Ajustes → Compartir**. La cuenta root nunca inicia sesión."],
+ ["La placa no arranca después del overclock", "Poné la tarjeta en tu computadora, abrí su partición de arranque y borrá el bloque entre `# >>> lordos-firstrun` y `# <<< lordos-firstrun` de `config.txt`. La placa vuelve a arrancar a su velocidad normal."],
+ ["Me salteé la personalización. ¿Y ahora?", "La placa arranca en modo de configuración e inicia sesión sola. Creá tu cuenta en **Ajustes → Usuarios**; en el próximo arranque se borra la cuenta de configuración. Hasta entonces, no actives el escritorio remoto."],
+ ["¿Puedo grabar un pendrive para una PC?", "Sí: elegí **PC (pendrive USB)** en el paso 1. Graba el sistema en vivo de LordOS; arrancá la PC desde el pendrive para probarlo y después instalalo desde ahí."]
+ ],
+ "endTitle": "¿Listo? Bajá LordOS Imager",
+ "endText": "Libre y de código abierto. Cada imagen oficial se verifica con la firma de la versión antes de borrar nada.",
+ "endOther": "¿Preferís otra forma de grabar la tarjeta? Mirá la sección de descargas.",
+ "shotsNote": "Pantallas de LordOS Imager {v} con valores de ejemplo: usuario «demo», computadora «lordos-pi», red «HomeNetwork».",
+ "home": {
+ "title": "Cómo grabar LordOS en un pendrive o una tarjeta SD",
+ "lead": "Para la PC (ISO) y para la imagen de la Raspberry Pi 5.",
+ "badge": "Recomendado",
+ "steps": ["Elegí tu dispositivo y la última versión firmada de LordOS.", "Elegí la tarjeta o el pendrive y, para la Pi, prepará el primer arranque.", "Grabá: verifica la firma, graba y vuelve a leer la tarjeta."],
+ "guide": "Guía paso a paso",
+ "optTitle": "¿Preferís tu herramienta de siempre? Está bien.",
+ "optText": "Descargá la ISO o la imagen de la Raspberry Pi desde la versión, verificala con SHA256SUMS y grabala con cualquier app para grabar imágenes, o con `dd`. `/dev/sdX` es la tarjeta o el pendrive entero, no una partición.",
+ "optPc": "PC (ISO)",
+ "optPi": "Raspberry Pi 5",
+ "optVerify": "Cómo verificar la firma de SHA256SUMS",
+ "optPiSetup": "Sin LordOS Imager, la Pi arranca en modo de configuración. Para prepararla, poné `lordos-user.txt` y los archivos interruptor (`ssh`, `remote-desktop`) en la partición de arranque de la tarjeta antes del primer arranque.",
+ "optPiLink": "Archivos interruptor y lordos-user.txt"
+ }
+}
diff --git a/web/content/imager/guide.pt.json b/web/content/imager/guide.pt.json
new file mode 100644
index 0000000..94c6ce6
--- /dev/null
+++ b/web/content/imager/guide.pt.json
@@ -0,0 +1,145 @@
+{
+ "meta": ["Como usar o LordOS Imager · LordOS", "Grave o LordOS em um cartão SD ou pendrive e prepare o primeiro boot do Raspberry Pi 5, tela por tela: dispositivo, imagem do sistema, armazenamento, personalização, gravação e primeiro boot."],
+ "kicker": "Guia · LordOS Imager",
+ "title": "Como usar o LordOS Imager",
+ "lead": "Grave o LordOS em um cartão SD ou pendrive a partir do seu computador e prepare o primeiro boot do Raspberry Pi 5. Tela por tela, em uns dez minutos.",
+ "version": "Versão {v} · livre e de código aberto · não coleta nada",
+ "alsoIn": "Já usa o LordOS? Está em Apps → Sistema.",
+ "hello": "Oi, eu sou o Lumo! Vou com você em cada tela.",
+ "heroAlt": "LordOS Imager: escolha o seu dispositivo",
+ "needTitle": "O que você precisa",
+ "need": [
+ ["O seu computador", "Com o LordOS Imager instalado e conexão à internet para o download."],
+ ["Um cartão SD ou pendrive", "De preferência 16 GB ou mais (8 GB no mínimo). Tudo o que houver nele será apagado."],
+ ["Um Raspberry Pi 5", "Com pelo menos 4 GB de memória; com 8 ou 16 GB a área de trabalho fica mais fluida. Recomendam-se uma ventoinha e a fonte de 27 W."],
+ ["Uns dez minutos", "Quase todo o tempo é o download e a gravação, que andam sozinhos."]
+ ],
+ "videoTitle": "Assista primeiro",
+ "videoLead": "Um passeio rápido por cada passo, narrado em inglês, com legendas em inglês, espanhol e português.",
+ "videoSoon": "Vídeo em breve",
+ "videoSoonText": "Enquanto isso, cada passo está aqui embaixo com a sua captura.",
+ "videoCredit": "Narração: Kokoro TTS, voz Michael (Apache 2.0)",
+ "videoFallback": "O seu navegador não consegue reproduzir este vídeo. Baixe-o:",
+ "tocLabel": "Passos",
+ "stepWord": "Passo",
+ "tipFrom": "A dica do Lumo",
+ "open": "Ver maior",
+ "steps": [
+ {
+ "id": "device", "title": "Escolha o seu dispositivo",
+ "text": "Escolha **Raspberry Pi 5** para preparar um cartão SD para a placa, ou **PC (pendrive USB)** para gravar o sistema ao vivo para um computador. Abaixo do Pi, uma barra mostra quanta memória ele precisa.",
+ "points": ["4 GB é o mínimo, 8 GB é confortável e 16 GB dá o melhor desempenho.", "Só dá para escolher as placas que o LordOS realmente suporta."],
+ "shots": [["01-device", "Passo 1: o dispositivo, com a recomendação de memória para o Raspberry Pi 5"]],
+ "tip": ["wave", "Sem adivinhação", "Se a sua placa ainda não é suportada, eu aviso em vez de deixar você gravar um cartão que não vai iniciar."]
+ },
+ {
+ "id": "image", "title": "Escolha a imagem do sistema",
+ "text": "A versão mais recente do LordOS já vem escolhida e marcada **Assinada pelo LordOS**. O download fica guardado, então o próximo cartão é mais rápido.",
+ "points": ["As versões anteriores estão a um clique.", "Você também pode usar um arquivo de imagem seu (`.img`, `.img.xz` ou `.iso`). Ele é gravado e conferido, mas ninguém garante de onde veio."],
+ "shots": [["02-image", "Passo 2: a versão assinada mais recente do LordOS"]],
+ "tip": ["shield", "Só imagens assinadas", "As imagens oficiais são conferidas com a chave de publicação do LordOS antes de apagar qualquer coisa."]
+ },
+ {
+ "id": "storage", "title": "Escolha o cartão ou o pendrive",
+ "text": "Coloque o cartão SD (com um leitor, se o seu computador precisar) ou conecte o pendrive. Ele aparece sozinho, com nome e tamanho. Selecione-o e leia o aviso em vermelho: tudo o que houver nele será apagado.",
+ "points": ["Só aparecem unidades removíveis. Os discos do seu computador nunca aparecem aqui.", "Um cartão pequeno demais ou protegido contra gravação aparece em cinza, com o motivo."],
+ "shots": [["04-storage", "Passo 3: o cartão SD selecionado, com o aviso de que será apagado"]],
+ "tip": ["wave", "Tudo nele será apagado", "Copie antes o que quiser guardar do cartão."]
+ },
+ {
+ "id": "customise", "title": "Personalize o primeiro boot",
+ "text": "Deixe **Preparar o primeiro boot** ligado e a placa já inicia pronta: o nome dela, a sua conta, o Wi-Fi, o acesso remoto, a aparência e o resfriamento. São sete abas e tudo pode ser mudado depois em Ajustes. (Para um pendrive de PC não há o que personalizar: este passo é pulado.)",
+ "subs": [
+ ["05-tab-general", "Geral", "O **nome do computador** é como você vai achar a placa na sua rede: aqui `lordos-pi`, ou seja `lordos-pi.local`. Depois, o idioma, o fuso horário, o layout do teclado e o país do Wi-Fi."],
+ ["06-tab-user", "Usuário", "A sua conta de administrador: nome completo, nome de usuário e uma senha digitada duas vezes. No cartão vai só um hash de mão única da senha. O login automático é opcional."],
+ ["07-tab-wifi", "Wi-Fi", "O nome da rede exatamente como aparece (maiúsculas contam) e a senha dela. O cartão guarda a chave derivada da rede, nunca a senha que você digitou. Redes ocultas e abertas também funcionam."],
+ ["08-tab-remote", "Acesso remoto", "Login remoto (SSH): desligado, só chaves (o recomendado) ou senha e chaves. Você também pode ligar a área de trabalho remota do LordOS; ela fica na sua rede local."],
+ ["09-tab-look", "Aparência", "Lord Default ou Clássico, claro ou escuro, uma cor de destaque e um papel de parede."],
+ ["10-tab-cooling", "Resfriamento", "Conte ao LordOS o que resfria a placa e ele escolhe a curva da ventoinha certa. Não tem certeza? Veja [Que resfriamento eu tenho?](#cooling)."],
+ ["11-tab-cooling-overclock", "Overclock leve", "Só com ventoinha: 2,6 GHz em vez de 2,4 GHz, sem tensão extra. O aviso explica como desfazer."],
+ ["12-tab-more", "Mais", "Bluetooth, a busca automática de atualizações e uma promessa: o LordOS não coleta nada."],
+ ["13-profiles", "Perfis", "Salve estes ajustes para usá-los no próximo cartão. Senhas e chaves de Wi-Fi nunca são salvas: você digita de novo."]
+ ],
+ "tip": ["shield", "Nada secreto às claras", "A sua senha e a do Wi-Fi nunca chegam ao cartão como são: só um hash e uma chave derivada."]
+ },
+ {
+ "id": "write", "title": "Confira e grave",
+ "text": "Um resumo de tudo o que você escolheu e, ao tocar **Apagar e gravar**, uma última confirmação. A partir daí o imager faz tudo sozinho:",
+ "points": ["confere a assinatura da versão e depois baixa a imagem (um download interrompido continua de onde parou);", "confere a imagem, grava e depois lê o cartão inteiro de volta e compara;", "salva os ajustes do primeiro boot e ejeta o cartão."],
+ "shots": [["14-write-summary", "O resumo antes de gravar"], ["15-write-confirm", "A última confirmação"], ["16-downloading", "Baixando, com a velocidade e o tempo restante"], ["17-writing", "Gravando o cartão"], ["18-verifying", "Lendo o cartão de volta e comparando"]],
+ "tip": ["run", "Deixe conectado", "Cancelar é seguro: o cartão é limpo para nunca parecer gravado pela metade. O download fica guardado."]
+ },
+ {
+ "id": "done", "title": "Pronto!",
+ "text": "O Lumo comemora e mostra o que vem depois, com o nome exato da sua placa na rede e os comandos para o login remoto e a área de trabalho remota. Um som e uma notificação avisam que terminou.",
+ "shots": [["19-done", "Pronto: gravado, conferido e ejetado, com os próximos passos"]]
+ },
+ {
+ "id": "firstboot", "title": "O primeiro boot no Raspberry Pi 5",
+ "text": "Coloque o cartão na placa, conecte o monitor, o teclado e o mouse, e depois a fonte. Aparecem a coroa do LordOS e uma barra de progresso enquanto o sistema cresce para ocupar o cartão e aplica os seus ajustes. Em cerca de um minuto, a tela de login mostra a sua conta.",
+ "points": ["De outro computador da sua casa é `lordos-pi.local`.", "Login remoto: `ssh [email protected]`.", "Área de trabalho remota, se você ligou: `https://lordos-pi.local:5673`."],
+ "boot": [["docs/boot/splash-preview.png", "A tela de inicialização durante o primeiro boot"], ["docs/screenshots/greeter.png", "A tela de login (com contas de exemplo)"]],
+ "tip": ["celebrate", "Bem-vindo", "O arquivo de ajustes é aplicado uma vez e depois sobrescrito e apagado do cartão."]
+ }
+ ],
+ "coolTitle": "Que resfriamento eu tenho?",
+ "coolLead": "Escolha o que está fisicamente na sua placa. Isso define a curva da ventoinha e a velocidade do processador, e dá para mudar depois em Ajustes.",
+ "cool": [
+ ["case-fan", "Gabinete com ventoinha", "Um gabinete fechado com ventoinha própria embutida, ligada ao conector de ventoinha da placa. Muitos gabinetes de alumínio são assim.", "Tem um gabinete com ventoinha? Escolha **Gabinete com ventoinha**."],
+ ["active-cooler", "Cooler ativo", "Um dissipador pequeno com uma ventoinha em cima, encaixado direto na placa.", "Escolha **Cooler ativo**."],
+ ["passive", "Gabinete passivo", "Um gabinete de metal ou um dissipador que resfria sem nenhuma ventoinha.", "Escolha **Gabinete passivo**."],
+ ["none", "Nada", "A placa sozinha. Funciona, mas sob carga ela se freia em poucos minutos.", "Escolha **Nada**: um clock mais suave evita isso."]
+ ],
+ "profTitle": "Perfis",
+ "profHead": ["Resfriamento", "Perfis", "O que fazem"],
+ "prof": [
+ ["Com ventoinha (gabinete ou cooler ativo)", "**Equilibrado** (padrão), Desempenho, Silencioso", "Equilibrado: a ventoinha liga a 55 °C. Desempenho: a partir de 45 °C, e o processador fica em velocidade máxima. Silencioso: a partir de 60 °C."],
+ ["Gabinete passivo", "**Equilibrado** (padrão), Conservador", "Não há ventoinha para controlar. Conservador limita o clock a 2,0 GHz."],
+ ["Nada", "**Conservador** (padrão), Equilibrado", "2,0 GHz, para a placa sozinha não chegar a 85 °C e se frear."]
+ ],
+ "ocTitle": "Overclock leve (só com ventoinha)",
+ "ocText": "2,6 GHz em vez de 2,4 GHz, sem tensão extra. Nem toda placa fica estável: se a sua não iniciar, abra a partição de boot do cartão em outro computador e apague o bloco `lordos-firstrun` do `config.txt`.",
+ "optTitle": "Opções do app",
+ "optText": "**Opções do app**, embaixo na barra lateral: um som e ejetar ao terminar, procurar atualizações do app, idioma e aparência, e a pasta de downloads, com quanto ela ocupa e um botão para limpá-la.",
+ "optShot": ["20-options", "Opções do app"],
+ "secTitle": "Seguro desde o projeto",
+ "secLead": "O que o LordOS Imager faz para proteger o seu cartão, a sua placa e você.",
+ "sec": [
+ ["Só imagens assinadas", "Antes de apagar qualquer coisa, a lista de arquivos da versão é conferida com a chave de publicação do LordOS, e o SHA-256 da imagem com essa lista. Durante a gravação, a imagem é calculada de novo."],
+ ["Lido de volta e comparado", "Depois de gravar, o cartão inteiro é lido de volta e comparado com o que foi gravado."],
+ ["A sua senha continua sua", "Ela vira um hash de mão única antes de ser gravada. O Wi-Fi é guardado como a chave derivada da rede."],
+ ["Aplicado uma vez e apagado", "A placa confere o arquivo de ajustes de forma rígida, aplica uma vez e depois o sobrescreve e apaga. Um arquivo inválido não aplica nada."],
+ ["Só cartões e pendrives", "Os discos do seu computador nunca aparecem, e o seu computador pede a aprovação de um administrador antes de abrir a unidade."],
+ ["Nada é coletado", "Sem conta, sem dados de uso, sem relatórios de falhas. O imager só fala com a página de versões do LordOS para listar e baixar imagens."]
+ ],
+ "secLink": "Como o LordOS assina as suas versões",
+ "faqTitle": "Se algo der errado",
+ "faq": [
+ ["O meu cartão não aparece", "Só aparecem unidades removíveis: cartões SD e pendrives. Use um leitor se o seu computador não tiver entrada e espere alguns segundos: a lista se atualiza sozinha. Um cartão com a trava ligada, ou com menos de 8 GB, aparece em cinza com o motivo. Os discos do seu computador nunca aparecem, de propósito."],
+ ["Diz que a assinatura não foi confirmada", "Então nada foi gravado nem apagado. Os arquivos baixados não batem com o que o LordOS assinou, quase sempre porque um download falhou. Abra **Opções do app → Downloads → Limpar** e tente de novo. Se continuar, avise a gente (veja a página de segurança)."],
+ ["A placa não conecta ao meu Wi-Fi", "Confira o nome da rede (maiúsculas contam), a senha e o país do Wi-Fi em **Geral**. Uma rede que só aceita WPA3 precisa da senha na própria placa: conecte um cabo de rede uma vez e adicione-a em **Ajustes → Rede**."],
+ ["Não acho lordos-pi.local", "Dê um ou dois minutos ao primeiro boot e confira se o seu computador está na mesma rede (redes de convidados costumam separar os aparelhos). A tela de login mostra o endereço da placa num canto; você pode usar esse endereço no lugar do nome."],
+ ["Como entro por SSH?", "Se você ligou: `ssh [email protected]` (com o seu usuário e o nome do seu computador). Só chaves é o mais seguro. Dá para ligar ou desligar depois em **Ajustes → Compartilhar**. A conta root nunca faz login."],
+ ["A placa não inicia depois do overclock", "Coloque o cartão no seu computador, abra a partição de boot e apague o bloco entre `# >>> lordos-firstrun` e `# <<< lordos-firstrun` do `config.txt`. A placa volta a iniciar na velocidade normal."],
+ ["Pulei a personalização. E agora?", "A placa inicia em modo de configuração e entra sozinha. Crie a sua conta em **Ajustes → Usuários**; no próximo boot a conta de configuração é removida. Até lá, não ligue a área de trabalho remota."],
+ ["Posso gravar um pendrive para um PC?", "Sim: escolha **PC (pendrive USB)** no passo 1. Ele grava o sistema ao vivo do LordOS; inicie o PC pelo pendrive para experimentar e depois instale a partir dele."]
+ ],
+ "endTitle": "Pronto? Baixe o LordOS Imager",
+ "endText": "Livre e de código aberto. Cada imagem oficial é conferida com a assinatura da versão antes de apagar qualquer coisa.",
+ "endOther": "Prefere outro jeito de gravar o cartão? Veja a seção de downloads.",
+ "shotsNote": "Telas do LordOS Imager {v} com valores de exemplo: usuário “demo”, computador “lordos-pi”, rede “HomeNetwork”.",
+ "home": {
+ "title": "Como gravar o LordOS em um pendrive ou cartão SD",
+ "lead": "Para o PC (ISO) e para a imagem do Raspberry Pi 5.",
+ "badge": "Recomendado",
+ "steps": ["Escolha o seu dispositivo e a versão assinada mais recente do LordOS.", "Escolha o cartão ou o pendrive e, para o Pi, prepare o primeiro boot.", "Grave: ele confere a assinatura, grava e lê o cartão de volta."],
+ "guide": "Guia passo a passo",
+ "optTitle": "Prefere a sua ferramenta de sempre? Tudo bem.",
+ "optText": "Baixe a ISO ou a imagem do Raspberry Pi na versão, confira com o SHA256SUMS e grave com qualquer app de gravar imagens, ou com `dd`. `/dev/sdX` é o cartão ou pendrive inteiro, não uma partição.",
+ "optPc": "PC (ISO)",
+ "optPi": "Raspberry Pi 5",
+ "optVerify": "Como conferir a assinatura do SHA256SUMS",
+ "optPiSetup": "Sem o LordOS Imager, o Pi inicia em modo de configuração. Para prepará-lo, coloque o `lordos-user.txt` e os arquivos interruptor (`ssh`, `remote-desktop`) na partição de boot do cartão antes do primeiro boot.",
+ "optPiLink": "Arquivos interruptor e lordos-user.txt"
+ }
+}
diff --git a/web/content/imager/video/poster.webp b/web/content/imager/video/poster.webp
new file mode 100644
index 0000000..8b8fc75
Binary files /dev/null and b/web/content/imager/video/poster.webp differ
diff --git a/web/lib/imager-guide.mjs b/web/lib/imager-guide.mjs
new file mode 100644
index 0000000..37ec3da
--- /dev/null
+++ b/web/lib/imager-guide.mjs
@@ -0,0 +1,249 @@
+// imager-guide.mjs — the "How to use LordOS Imager" guide (/imager/, /es/imager/, /pt/imager/) and the
+// "How to write LordOS" block of the download section. Content: web/content/imager/guide.<lang>.json;
+// screenshots: web/content/imager/shots/{light,dark}/<lang>/*.webp (1600 px wide, the desktop app's
+// real interface with demo values); the video slot: web/content/imager/video/ (see videoSlot()).
+import fs from 'node:fs';
+import path from 'node:path';
+import { inline } from './md.mjs';
+
+// The video turns on by itself when its files are there (one English narration, three subtitle
+// tracks). Until then the page shows the poster with "Video coming soon".
+export const VIDEO_BASE = 'lordos_imager_guide';
+export const VIDEO_LANGS = ['en', 'es', 'pt'];
+
+export function imagerGuide({ content, repo, lang: l, t, g, version, esc, webp, hashed, read, lumo, pageUrl, prefix, links, videoDir }) {
+ const md = (s) => inline(String(s || ''));
+ const fill = (s) => String(s).replace('{v}', version);
+ const shotDir = (theme) => path.join(content, 'shots', theme, l);
+
+ // one screenshot in both themes, in the app's window frame (the page shows the one that matches it)
+ const shotCache = new Map();
+ function variant(file, key) {
+ if (!shotCache.has(file)) {
+ const thumb = webp(file, 800, 80, key);
+ const full = { url: hashed(read(file), key, 'webp') };
+ shotCache.set(file, { thumb, full });
+ }
+ return shotCache.get(file);
+ }
+ function shot(name, caption, { sizes = '(max-width: 900px) 92vw, 760px', eager = false, cls = '' } = {}) {
+ const imgs = ['light', 'dark'].map((theme) => {
+ const file = path.join(shotDir(theme), name + '.webp');
+ if (!fs.existsSync(file)) return '';
+ const { thumb, full } = variant(file, `imager-${theme}-${l}-${name}`);
+ const load = eager && theme === 'light' ? ' fetchpriority="high"' : ' loading="lazy" decoding="async"';
+ return `<a class="g-card ig-${theme === 'light' ? 'l' : 'd'}" href="${full.url}" data-w="1600" data-h="${thumb.h * 2}" data-cap="${esc(caption)}" aria-label="${esc(g.open + ': ' + caption)}"><img src="${thumb.url}" srcset="${thumb.url} ${thumb.w}w, ${full.url} 1600w" sizes="${sizes}" width="${thumb.w}" height="${thumb.h}" alt="${esc(caption)}"${load}></a>`;
+ }).join('');
+ return `<figure class="ig-win${cls ? ' ' + cls : ''}"><div class="ig-bar" aria-hidden="true"><span>LordOS Imager</span></div>${imgs}<figcaption>${esc(caption)}</figcaption></figure>`;
+ }
+ // a screenshot from docs/ (the board's own screens), one theme
+ function docShot(file, caption) {
+ const f = path.join(repo, file);
+ if (!fs.existsSync(f)) return '';
+ const thumb = webp(f, 800, 80), full = webp(f, 1600, 80);
+ return `<figure class="ig-screen"><a class="g-card" href="${full.url}" data-w="${full.w}" data-h="${full.h}" data-cap="${esc(caption)}" aria-label="${esc(g.open + ': ' + caption)}"><img src="${thumb.url}" srcset="${thumb.url} ${thumb.w}w, ${full.url} ${full.w}w" sizes="(max-width: 900px) 92vw, 380px" width="${thumb.w}" height="${thumb.h}" alt="${esc(caption)}" loading="lazy" decoding="async"></a><figcaption>${esc(caption)}</figcaption></figure>`;
+ }
+ const tip = (x) => (x ? `<aside class="ig-tip" aria-label="${esc(g.tipFrom)}"><img src="${lumo[x[0]] || lumo.wave}" alt="" width="64" height="64" loading="lazy"><div><p class="ig-tip-t">${esc(x[1])}</p><p>${md(x[2])}</p></div></aside>` : '');
+ const num = (i) => String(i + 1).padStart(2, '0');
+
+ const dl = `<div class="ig-dl">
+<a class="btn btn-primary" href="${links.mac}">${esc(t.imgMac)}</a>
+<a class="btn btn-primary" href="${links.win}">${esc(t.imgWin)}</a>
+<a class="btn btn-primary" href="${links.linux}">${esc(t.imgLinux)}</a>
+</div>`;
+
+ // ---- hero ----
+ const hero = `<section class="ig-hero" aria-labelledby="ig-h">
+<div class="wrap ig-hero-in">
+<div class="ig-hero-txt">
+<p class="kicker">${esc(g.kicker)}</p>
+<h1 id="ig-h">${esc(g.title)}</h1>
+<p class="ig-lead">${esc(g.lead)}</p>
+${dl}
+<p class="ig-ver">${esc(fill(g.version))}<br>${esc(g.alsoIn)}</p>
+</div>
+<div class="ig-hero-art">
+${shot('01-device', g.heroAlt, { eager: true, sizes: '(max-width: 900px) 92vw, 600px', cls: 'ig-tilt' })}
+<div class="ig-hello"><img src="${lumo.wave}" alt="" width="132" height="132"><p class="ig-bubble">${esc(g.hello)}</p></div>
+</div>
+</div>
+</section>`;
+
+ const need = `<section class="wrap ig-need" aria-labelledby="ig-need-h">
+<h2 id="ig-need-h" class="ig-h2s">${esc(g.needTitle)}</h2>
+<ul>${g.need.map(([a, b], i) => `<li><span class="ig-need-i" aria-hidden="true">${NEED_ICONS[i] || ''}</span><strong>${esc(a)}</strong><span>${md(b)}</span></li>`).join('')}</ul>
+</section>`;
+
+ // ---- video: the mockup until the files exist ----
+ const video = videoSlot({ l, g, esc, hashed, read, videoDir, lumo });
+
+ // ---- steps ----
+ const toc = `<nav class="ig-toc" aria-label="${esc(g.tocLabel)}"><p>${esc(g.tocLabel)}</p><ol>${g.steps.map((s, i) => `<li><a href="#step-${s.id}"><span>${num(i)}</span>${esc(s.title)}</a></li>`).join('')}<li><a href="#cooling"><span>★</span>${esc(g.coolTitle)}</a></li><li><a href="#safety"><span>★</span>${esc(g.secTitle)}</a></li><li><a href="#help"><span>?</span>${esc(g.faqTitle)}</a></li></ol></nav>`;
+
+ const steps = g.steps.map((s, i) => {
+ const points = s.points ? `<ul class="ig-points">${s.points.map((p) => `<li>${md(p)}</li>`).join('')}</ul>` : '';
+ let media = '';
+ if (s.subs) {
+ media = `<ol class="ig-subs">${s.subs.map(([file, title, text], k) => `<li id="tab-${file.replace(/^\d+-(tab-)?/, '')}">${shot(file, title, { sizes: '(max-width: 700px) 92vw, 380px' })}<div><h4><span class="ig-chip">${k + 1}</span>${esc(title)}</h4><p>${md(text)}</p></div></li>`).join('')}</ol>`;
+ } else if (s.boot) {
+ media = `<div class="ig-pair">${s.boot.map(([f, c]) => docShot(f, c)).join('')}</div>`;
+ } else if (s.shots && s.shots.length > 1) {
+ const [first, second, ...rest] = s.shots;
+ media = `<div class="ig-pair">${shot(first[0], first[1], { sizes: '(max-width: 700px) 92vw, 380px' })}${shot(second[0], second[1], { sizes: '(max-width: 700px) 92vw, 380px' })}</div>`
+ + (rest.length ? `<div class="ig-trio">${rest.map(([f, c]) => shot(f, c, { sizes: '(max-width: 700px) 92vw, 250px' })).join('')}</div>` : '');
+ } else if (s.shots) {
+ media = shot(s.shots[0][0], s.shots[0][1]);
+ }
+ return `<section class="ig-step" id="step-${s.id}" aria-labelledby="step-${s.id}-h">
+<div class="ig-num" aria-hidden="true">${num(i)}</div>
+<div class="ig-step-body">
+<p class="ig-step-k">${esc(g.stepWord)} ${i + 1}</p>
+<h2 id="step-${s.id}-h">${esc(s.title)}</h2>
+<p class="ig-text">${md(s.text)}</p>
+${points}
+${media}
+${tip(s.tip)}
+</div>
+</section>`;
+ }).join('\n');
+
+ // ---- cooling chooser ----
+ const cooling = `<section class="ig-cool" id="cooling" aria-labelledby="cooling-h">
+<h2 id="cooling-h" class="ig-h2s">${esc(g.coolTitle)}</h2>
+<p class="ig-sub">${esc(g.coolLead)}</p>
+<ul class="ig-cool-cards">${g.cool.map(([id, title, text, pick]) => `<li class="ig-cc ig-cc-${id}"><span class="ig-cc-art" aria-hidden="true">${COOL_ART[id] || ''}</span><h3>${esc(title)}</h3><p>${md(text)}</p><p class="ig-pick">${md(pick)}</p></li>`).join('')}</ul>
+<h3 class="ig-h3">${esc(g.profTitle)}</h3>
+<div class="ig-table" role="region" aria-labelledby="cooling-h" tabindex="0"><table><thead><tr>${g.profHead.map((h) => `<th scope="col">${esc(h)}</th>`).join('')}</tr></thead><tbody>${g.prof.map(([a, b, c]) => `<tr><th scope="row">${esc(a)}</th><td>${md(b)}</td><td>${md(c)}</td></tr>`).join('')}</tbody></table></div>
+<div class="ig-note"><p class="ig-note-t">${esc(g.ocTitle)}</p><p>${md(g.ocText)}</p></div>
+</section>`;
+
+ const options = `<section class="ig-opt" aria-labelledby="opt-h">
+<div><h2 id="opt-h" class="ig-h2s">${esc(g.optTitle)}</h2><p>${md(g.optText)}</p></div>
+${shot(g.optShot[0], g.optShot[1], { sizes: '(max-width: 900px) 92vw, 520px' })}
+</section>`;
+
+ const safety = `<section class="ig-safe" id="safety" aria-labelledby="safety-h">
+<div class="wrap">
+<img class="ig-safe-lumo" src="${lumo.shield}" alt="" width="120" height="120" loading="lazy">
+<h2 id="safety-h" class="ig-h2s">${esc(g.secTitle)}</h2>
+<p class="ig-sub">${esc(g.secLead)}</p>
+<ul class="ig-safe-grid">${g.sec.map(([a, b]) => `<li><svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M12 3l8 4v5c0 5-3.5 8-8 9-4.5-1-8-4-8-9V7z"/><path d="M8.5 12l2.5 2.5 4.5-5"/></svg><h3>${esc(a)}</h3><p>${md(b)}</p></li>`).join('')}</ul>
+<p class="ig-safe-link"><a href="${links.signing}">${esc(g.secLink)} →</a></p>
+</div>
+</section>`;
+
+ const faq = `<section class="wrap ig-faq" id="help" aria-labelledby="help-h">
+<h2 id="help-h" class="ig-h2s">${esc(g.faqTitle)}</h2>
+<div class="ig-faq-list">${g.faq.map(([q, a], i) => `<details id="help-${i + 1}"><summary>${esc(q)}</summary><p>${md(a)}</p></details>`).join('')}</div>
+</section>`;
+
+ const end = `<section class="wrap ig-end" aria-labelledby="end-h">
+<div class="ig-end-card">
+<img src="${lumo.celebrate}" alt="" width="150" height="150" loading="lazy">
+<div>
+<h2 id="end-h" class="ig-h2s">${esc(g.endTitle)}</h2>
+<p>${esc(g.endText)}</p>
+${dl}
+<p class="ig-end-other"><a href="${prefix(l)}#write">${esc(g.endOther)}</a></p>
+</div>
+</div>
+<p class="ig-shots-note">${esc(fill(g.shotsNote))}</p>
+</section>`;
+
+ const main = `${hero}
+${need}
+${video}
+<div class="wrap ig-guide">
+${toc}
+<div class="ig-steps">
+${steps}
+${cooling}
+${options}
+</div>
+</div>
+${safety}
+${faq}
+${end}`;
+ return { main, meta: g.meta };
+}
+
+
+// The video slot. With web/content/imager/video/lordos_imager_guide.mp4 (and .webm, and the subtitles
+// lordos_imager_guide.<en|es|pt>.vtt) the real player is built; without them, the mockup.
+// IMAGER_VIDEO_DIR points somewhere else when the video is kept out of git.
+function videoSlot({ l, g, esc, hashed, read, videoDir, lumo }) {
+ const f = (ext) => path.join(videoDir, `${VIDEO_BASE}.${ext}`);
+ const posterFile = path.join(videoDir, 'poster.webp');
+ const poster = fs.existsSync(posterFile) ? hashed(read(posterFile), 'imager-video-poster', 'webp') : '';
+ const ready = fs.existsSync(f('mp4'));
+ const head = `<div class="wrap ig-video-head"><h2 id="vid-h" class="ig-h2s">${esc(g.videoTitle)}</h2><p class="ig-sub">${esc(g.videoLead)}</p></div>`;
+ if (ready) {
+ const mp4 = hashed(read(f('mp4')), VIDEO_BASE, 'mp4');
+ const webm = fs.existsSync(f('webm')) ? hashed(read(f('webm')), VIDEO_BASE, 'webm') : '';
+ const names = { en: 'English', es: 'Español', pt: 'Português' };
+ const tracks = VIDEO_LANGS.filter((x) => fs.existsSync(f(`${x}.vtt`))).map((x) => {
+ const vtt = hashed(read(f(`${x}.vtt`)), `${VIDEO_BASE}.${x}`, 'vtt');
+ // the narration is English: the Spanish and Portuguese pages show their own subtitles by default
+ return `<track kind="subtitles" srclang="${x}" label="${names[x]}" src="${vtt}"${x === l && l !== 'en' ? ' default' : ''}>`;
+ }).join('');
+ return `<section class="ig-video" aria-labelledby="vid-h">${head}
+<div class="wrap"><figure class="ig-vframe"><video controls preload="none" playsinline${poster ? ` poster="${poster}"` : ''} width="1920" height="1080">${webm ? `<source src="${webm}" type="video/webm">` : ''}<source src="${mp4}" type="video/mp4">${tracks}<p>${esc(g.videoFallback)} <a href="${mp4}">MP4</a></p></video>
+<figcaption>${esc(g.videoCredit)}</figcaption></figure></div>
+</section>`;
+ }
+ return `<section class="ig-video" aria-labelledby="vid-h">${head}
+<div class="wrap"><figure class="ig-vframe ig-soon">${poster ? `<img src="${poster}" alt="" width="1280" height="720" loading="lazy">` : ''}
+<figcaption class="ig-soon-in"><span class="ig-play" aria-hidden="true"><svg width="34" height="34" viewBox="0 0 24 24" fill="currentColor"><path d="M8 5.5v13a1 1 0 001.5.86l10-6.5a1 1 0 000-1.72l-10-6.5A1 1 0 008 5.5z"/></svg></span><span class="ig-pill">${esc(g.videoSoon)}</span><span>${esc(g.videoSoonText)}</span></figcaption></figure></div>
+</section>`;
+}
+
+// small line icons (Tabler-style strokes) for "What you need"
+const svg = (d) => `<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">${d}</svg>`;
+const NEED_ICONS = [
+ svg('<rect x="3" y="4" width="18" height="12" rx="2"/><path d="M8 20h8M12 16v4"/>'),
+ svg('<path d="M7 3h7l4 4v14H7z"/><path d="M10 7v3M13 7v3"/>'),
+ svg('<rect x="3" y="6" width="18" height="12" rx="2"/><rect x="7" y="9" width="5" height="5" rx="1"/><path d="M15 10h3M15 13h3"/>'),
+ svg('<circle cx="12" cy="13" r="8"/><path d="M12 9v4l2 2M9 2h6"/>'),
+];
+// the four coolers, drawn simply (no product shapes)
+const fan = (cx, cy, r) => `<circle cx="${cx}" cy="${cy}" r="${r}" fill="none" stroke="currentColor" stroke-width="2"/><path d="M${cx} ${cy}c0-${r * 0.7} ${r * 0.6}-${r * 0.7} ${r * 0.6}-${r * 0.2}S${cx} ${cy} ${cx} ${cy}zM${cx} ${cy}c${r * 0.6} ${r * 0.35} ${r * 0.3} ${r * 0.9}-${r * 0.1} ${r * 0.7}S${cx} ${cy} ${cx} ${cy}zM${cx} ${cy}c-${r * 0.6} ${r * 0.35}-${r * 0.75}-${r * 0.25}-${r * 0.45}-${r * 0.5}S${cx} ${cy} ${cx} ${cy}z" fill="currentColor" opacity=".55"/>`;
+const COOL_ART = {
+ 'case-fan': `<svg viewBox="0 0 96 64" width="96" height="64"><rect x="6" y="8" width="84" height="48" rx="9" fill="currentColor" opacity=".14" stroke="currentColor" stroke-width="2"/>${fan(48, 32, 15)}</svg>`,
+ 'active-cooler': `<svg viewBox="0 0 96 64" width="96" height="64"><rect x="10" y="40" width="76" height="16" rx="3" fill="#1E9E55" opacity=".35"/>${[20, 30, 40, 56, 66, 76].map((x) => `<rect x="${x - 3}" y="12" width="6" height="30" rx="2" fill="currentColor" opacity=".35"/>`).join('')}${fan(48, 27, 13)}</svg>`,
+ passive: `<svg viewBox="0 0 96 64" width="96" height="64"><rect x="6" y="8" width="84" height="48" rx="9" fill="currentColor" opacity=".14" stroke="currentColor" stroke-width="2"/>${[22, 32, 42, 52, 62, 72].map((x) => `<rect x="${x}" y="18" width="5" height="28" rx="2" fill="currentColor" opacity=".45"/>`).join('')}</svg>`,
+ none: `<svg viewBox="0 0 96 64" width="96" height="64"><rect x="8" y="12" width="80" height="44" rx="5" fill="#1E9E55" opacity=".4" stroke="#1E9E55" stroke-width="2"/><rect x="38" y="26" width="16" height="16" rx="2" fill="currentColor" opacity=".55"/><rect x="62" y="18" width="18" height="10" rx="2" fill="currentColor" opacity=".3"/><rect x="62" y="32" width="18" height="10" rx="2" fill="currentColor" opacity=".3"/></svg>`,
+};
+
+// ---- the "How to write LordOS to a USB stick or SD card" block of the download section ----
+export function writeBlock({ l, t, g, esc, links, version, guideUrl }) {
+ const h = g.home;
+ const md = (s) => inline(String(s || ''));
+ const iso = `lordos-live-${version}-amd64.iso`, pi = `lordos-${version}-rpi5-arm64.img.xz`;
+ const cmd = (id, label, text) => `<div class="cmd"><div class="cmd-bar"><span class="cmd-t" aria-hidden="true"><i></i><i></i><i></i>${esc(label)}</span><button type="button" class="copy" data-copy="${id}" data-done="${esc(t.copied)}" aria-label="${esc(t.copy)}: ${esc(label)}" hidden>${esc(t.copy)}</button></div><pre id="${id}" tabindex="0">${esc(text)}</pre></div>`;
+ return `<section class="dl-write" id="write" aria-labelledby="wr-h">
+<div class="center"><h3 id="wr-h" class="dl-write-h">${esc(h.title)}</h3><p class="sub">${esc(h.lead)}</p></div>
+<div class="dl-write-grid">
+<article class="dl-card dl-imager dl-rec" aria-labelledby="img-h">
+<p class="dl-badge">${esc(h.badge)}</p>
+<h3 id="img-h">${esc(t.imgTitle)}</h3>
+<p>${esc(t.imgText)}</p>
+<ol class="dl-steps">${h.steps.map((s) => `<li>${esc(s)}</li>`).join('')}</ol>
+<div class="dl-btns">
+<a href="${links.mac}" class="btn btn-violet">${esc(t.imgMac)}</a>
+<a href="${links.win}" class="btn btn-violet">${esc(t.imgWin)}</a>
+<a href="${links.linux}" class="btn btn-violet">${esc(t.imgLinux)}</a>
+</div>
+<p class="dl-guide"><a href="${guideUrl}">${esc(h.guide)} →</a></p>
+<p class="dl-hint">${esc(t.imgNote)}</p>
+</article>
+<article class="dl-card dl-own" aria-labelledby="own-h">
+<h3 id="own-h">${esc(h.optTitle)}</h3>
+<p>${md(h.optText)}</p>
+${cmd('wr-pc', h.optPc, `sha256sum -c --ignore-missing SHA256SUMS\nsudo dd if=${iso} of=/dev/sdX bs=4M status=progress conv=fsync`)}
+${cmd('wr-pi', h.optPi, `sha256sum -c --ignore-missing SHA256SUMS\nxz -dc ${pi} | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync`)}
+<p class="dl-hint"><a href="${links.signing}">${esc(h.optVerify)}</a></p>
+<p class="dl-hint">${md(h.optPiSetup)} <a href="${links.switchFiles}">${esc(h.optPiLink)}</a></p>
+</article>
+</div>
+</section>`;
+}
diff --git a/web/src/home.css b/web/src/home.css
index 78586c4..3eb40a0 100644
--- a/web/src/home.css
+++ b/web/src/home.css
@@ -141,3 +141,17 @@ pre::-webkit-scrollbar-thumb,.table::-webkit-scrollbar-thumb{background:#4A4775;
.dl-hint{margin:-4px 0 8px!important;font-size:13.5px!important;color:var(--night-note)!important}
.dl-hint a{color:#FFD60A}
.dl-hint code{font:600 13px var(--mono);white-space:nowrap}
+/* how to write LordOS to a USB stick or SD card: the LordOS Imager (recommended) and your usual tool */
+.dl-write{display:flex;flex-direction:column;gap:22px;scroll-margin-top:80px}
+.dl-write-h{margin:0;font-size:clamp(24px,2.8vw,32px);letter-spacing:-.02em;font-weight:800}
+.dl-write .sub{margin-top:8px}
+.dl-write-grid{display:grid;grid-template-columns:1.15fr 1fr;gap:18px}
+.dl-rec{border-color:#6E4BFF;box-shadow:0 0 0 3px rgba(110,75,255,.22)}
+.dl-badge{align-self:flex-start;margin:0!important;padding:4px 12px;border-radius:999px;background:#6E4BFF;color:#fff!important;font-weight:800;font-size:12.5px!important;letter-spacing:.04em;text-transform:uppercase}
+.dl-steps{margin:0 0 6px;padding-left:22px;display:grid;gap:6px;color:var(--night-text);font-size:15px;line-height:1.5}
+.dl-steps li::marker{color:#B9A8FF;font-weight:800}
+.dl-guide{margin:0!important}.dl-guide a{color:#FFD60A;font-weight:700}.dl-guide a:hover{color:#fff}
+.dl-own .cmd{margin-top:0}
+.dl-own code{font:600 13px var(--mono);color:#FFD60A}
+.dl-own .dl-hint{margin:0!important}
+@media (max-width:900px){.dl-write-grid{grid-template-columns:1fr}}
diff --git a/web/src/home.html b/web/src/home.html
index 4606995..b9e6cd2 100644
--- a/web/src/home.html
+++ b/web/src/home.html
@@ -63,16 +63,7 @@
</div>
</article>
</div>
-<article class="dl-card dl-imager" aria-labelledby="img-h">
-<h3 id="img-h">{{t.imgTitle}}</h3>
-<p>{{t.imgText}}</p>
-<div class="dl-btns">
-<a href="{{{imagerMac}}}" class="btn btn-violet">{{t.imgMac}}</a>
-<a href="{{{imagerWin}}}" class="btn btn-violet">{{t.imgWin}}</a>
-<a href="{{{imagerLinux}}}" class="btn btn-violet">{{t.imgLinux}}</a>
-</div>
-<p class="dl-hint">{{t.imgNote}}</p>
-</article>
+{{{writeBlock}}}
<div class="verify">
<h3>{{t.verifyTitle}}</h3>
<p>{{t.verifyText}}</p>
diff --git a/web/src/imager.css b/web/src/imager.css
new file mode 100644
index 0000000..aff681c
--- /dev/null
+++ b/web/src/imager.css
@@ -0,0 +1,165 @@
+/* The LordOS Imager guide (/imager/): its own layout on top of site.css. A hero with Lumo, a step
+ rail on wide screens, a numbered timeline with screenshots in an app-window frame, the cooling
+ chooser, a dark "safe by design" band and the troubleshooting list. Light and dark. */
+
+/* screenshots come in both themes; the page shows the one that matches it */
+.ig-d{display:none!important}
+@media (prefers-color-scheme:dark){:root:not([data-theme=light]) .ig-l{display:none!important}:root:not([data-theme=light]) .ig-d{display:block!important}}
+:root[data-theme=dark] .ig-l{display:none!important}
+:root[data-theme=dark] .ig-d{display:block!important}
+
+.ig{--ig-line:linear-gradient(180deg,#B46CFF,#6E4BFF 60%,rgba(110,75,255,0));--ig-r:18px}
+.ig code{font:600 .9em/1.4 var(--mono);background:var(--code-bg);color:var(--code-fg);padding:.1em .4em;border-radius:6px;overflow-wrap:anywhere}
+.ig-h2s{margin:0;font-size:clamp(26px,3.2vw,38px);letter-spacing:-.02em;font-weight:800;line-height:1.15}
+.ig-sub{margin:10px 0 0;max-width:680px;font-size:17px;line-height:1.6;color:var(--muted)}
+
+/* the app window frame around every screenshot (no system controls: our own simple bar) */
+.ig-win{margin:0;border-radius:14px;overflow:hidden;background:var(--surface);border:1px solid var(--line);box-shadow:0 22px 60px var(--shadow-2),0 2px 8px var(--shadow-2)}
+.ig-bar{height:30px;display:flex;align-items:center;justify-content:center;background:var(--chip);border-bottom:1px solid var(--line);font-size:12px;font-weight:700;color:var(--subtle)}
+.ig-win a{display:block;line-height:0}
+.ig-win img{display:block;width:100%;height:auto}
+.ig-win figcaption,.ig-screen figcaption{padding:10px 14px;font-size:13.5px;line-height:1.45;color:var(--subtle);border-top:1px solid var(--line);background:var(--surface)}
+.ig-screen{margin:0;border-radius:14px;overflow:hidden;border:1px solid var(--line);background:var(--surface)}
+.ig-screen a{display:block;line-height:0}.ig-screen img{width:100%;height:auto;display:block;aspect-ratio:16/10;object-fit:cover}
+
+/* hero */
+.ig-hero{background:radial-gradient(1200px 500px at 85% 0%,var(--sup-a),transparent 70%),var(--bg);border-bottom:1px solid var(--line)}
+.ig-hero-in{display:grid;grid-template-columns:1fr 1.15fr;gap:48px;align-items:center;padding-top:64px;padding-bottom:64px}
+.ig-hero h1{margin:0;font-size:clamp(36px,5vw,62px);line-height:1.05;letter-spacing:-.03em;font-weight:800}
+.ig-lead{margin:18px 0 0;font-size:19px;line-height:1.55;color:var(--muted);max-width:560px}
+.ig-dl{margin-top:26px;display:flex;flex-wrap:wrap;gap:10px}
+.ig-dl .btn{flex:1 1 170px}
+.ig-ver{margin:16px 0 0;font-size:14px;line-height:1.6;color:var(--subtle)}
+.ig-hero-art{position:relative;padding-bottom:40px}
+.ig-tilt{transform:perspective(1400px) rotateY(-7deg) rotateX(2deg);transform-origin:left center}
+.ig-tilt figcaption{display:none}
+.ig-hello{position:absolute;left:-28px;bottom:-6px;display:flex;align-items:flex-end;gap:4px;pointer-events:none}
+.ig-hello img{width:132px;height:auto;filter:drop-shadow(0 10px 18px var(--shadow-2))}
+.ig-bubble{margin:0 0 70px;max-width:220px;padding:12px 16px;border-radius:16px 16px 16px 4px;background:var(--bubble);border:1px solid var(--chip-line);box-shadow:0 10px 30px var(--shadow-2);font-weight:700;font-size:15px;line-height:1.4}
+@media (prefers-reduced-motion:no-preference){.ig-hello img{animation:ig-bob 4s ease-in-out infinite}@keyframes ig-bob{50%{transform:translateY(-6px)}}}
+
+/* what you need */
+.ig-need{padding-top:48px;padding-bottom:16px}
+.ig-need ul{list-style:none;margin:20px 0 0;padding:0;display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:14px}
+.ig-need li{display:flex;flex-direction:column;gap:6px;padding:18px;border-radius:var(--ig-r);background:var(--surface);border:1px solid var(--line-2)}
+.ig-need-i{width:42px;height:42px;border-radius:12px;display:flex;align-items:center;justify-content:center;background:var(--brand-soft);color:var(--brand);margin-bottom:4px}
+.ig-need strong{font-size:16px}.ig-need li>span:last-child{font-size:14.5px;line-height:1.5;color:var(--muted)}
+
+/* video */
+.ig-video{padding-top:48px}
+.ig-video-head{margin-bottom:18px}
+.ig-vframe{margin:0;position:relative;aspect-ratio:16/9;border-radius:22px;overflow:hidden;background:#12122A;box-shadow:0 30px 80px var(--shadow),0 4px 14px var(--shadow-2)}
+.ig-vframe video,.ig-vframe>img{display:block;width:100%;height:100%;object-fit:cover}
+.ig-vframe>figcaption{position:absolute;right:12px;bottom:10px;font-size:12px;color:#C9C6E6;background:rgba(18,18,42,.7);padding:4px 10px;border-radius:999px}
+.ig-soon>img{filter:saturate(.9) brightness(.62)}
+.ig-soon .ig-soon-in{position:absolute;inset:0;right:auto;bottom:auto;width:100%;height:100%;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:10px;padding:16px;text-align:center;color:#fff;background:radial-gradient(closest-side,rgba(18,18,42,.55),rgba(18,18,42,0));font-size:15px;border-radius:0}
+.ig-play{width:76px;height:76px;border-radius:50%;display:flex;align-items:center;justify-content:center;background:rgba(255,255,255,.14);border:2px solid rgba(255,255,255,.5);color:#fff;-webkit-backdrop-filter:blur(6px);backdrop-filter:blur(6px)}
+.ig-pill{display:inline-block;padding:8px 18px;border-radius:999px;background:#6E4BFF;color:#fff;font-weight:800;font-size:clamp(15px,2vw,19px);box-shadow:0 8px 24px rgba(40,20,120,.45)}
+
+/* guide: step rail + timeline */
+.ig-guide{display:grid;grid-template-columns:230px minmax(0,1fr);gap:48px;padding-top:56px;padding-bottom:40px}
+.ig-toc{position:sticky;top:88px;align-self:start}
+.ig-toc p{margin:0 0 10px;font-size:13px;font-weight:800;letter-spacing:.08em;text-transform:uppercase;color:var(--subtle)}
+.ig-toc ol{list-style:none;margin:0;padding:0;display:grid;gap:2px}
+.ig-toc a{display:flex;gap:10px;align-items:center;min-height:40px;padding:6px 10px;border-radius:10px;color:var(--ink-2);text-decoration:none;font-weight:600;font-size:14.5px;line-height:1.3}
+.ig-toc a span{flex:0 0 28px;height:28px;border-radius:50%;display:flex;align-items:center;justify-content:center;background:var(--chip);color:var(--brand);font-size:12px;font-weight:800}
+.ig-toc a:hover{background:var(--chip);color:var(--brand)}
+.ig-steps{min-width:0;display:flex;flex-direction:column;gap:56px}
+.ig-step{position:relative;display:grid;grid-template-columns:64px minmax(0,1fr);gap:20px;scroll-margin-top:90px}
+.ig-step::before{content:"";position:absolute;left:31px;top:66px;bottom:-56px;width:2px;background:var(--ig-line);opacity:.5}
+.ig-step:last-of-type::before{display:none}
+.ig-num{width:64px;height:64px;border-radius:20px;display:flex;align-items:center;justify-content:center;background:linear-gradient(135deg,#B46CFF,#4F46E5);color:#fff;font-weight:800;font-size:22px;box-shadow:0 12px 30px rgba(79,70,229,.35)}
+.ig-step-body{min-width:0;display:flex;flex-direction:column;gap:14px}
+.ig-step-k{margin:6px 0 -8px;color:var(--brand);font-weight:800;font-size:13px;letter-spacing:.08em;text-transform:uppercase}
+.ig-step h2{margin:0;font-size:clamp(24px,2.6vw,32px);letter-spacing:-.02em;line-height:1.15}
+.ig-text{margin:0;font-size:17px;line-height:1.65;color:var(--ink-2)}
+.ig-points{margin:0;padding-left:20px;display:grid;gap:6px;font-size:16px;line-height:1.55;color:var(--muted)}
+.ig-points li::marker{color:var(--brand)}
+.ig-pair,.ig-trio{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:16px}
+.ig-trio{grid-template-columns:repeat(3,minmax(0,1fr))}
+.ig-subs{list-style:none;margin:6px 0 0;padding:0;display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:22px 18px;counter-reset:none}
+.ig-subs li{display:flex;flex-direction:column;gap:10px;min-width:0;scroll-margin-top:90px}
+.ig-subs .ig-win figcaption{display:none}
+.ig-subs h4{margin:0;display:flex;align-items:center;gap:8px;font-size:17px}
+.ig-subs p{margin:4px 0 0;font-size:15px;line-height:1.55;color:var(--muted)}
+.ig-chip{width:24px;height:24px;border-radius:7px;display:inline-flex;align-items:center;justify-content:center;background:var(--brand-soft);color:var(--brand-ink);font-size:12px;font-weight:800}
+.ig-tip{display:flex;gap:14px;align-items:center;padding:14px 18px;border-radius:var(--ig-r);background:linear-gradient(135deg,var(--sup-a),var(--sup-b));border:1px solid var(--chip-line)}
+.ig-tip img{flex:0 0 64px;height:auto}
+.ig-tip p{margin:0;font-size:15px;line-height:1.5;color:var(--muted)}
+.ig-tip .ig-tip-t{font-weight:800;color:var(--ink);margin-bottom:2px}
+
+/* cooling chooser */
+.ig-cool{scroll-margin-top:90px;padding:32px;border-radius:24px;background:var(--surface);border:1px solid var(--line-2)}
+.ig-cool-cards{list-style:none;margin:22px 0 0;padding:0;display:grid;grid-template-columns:repeat(auto-fit,minmax(190px,1fr));gap:14px}
+.ig-cc{display:flex;flex-direction:column;gap:8px;padding:18px;border-radius:16px;background:var(--surface-2);border:1.5px solid var(--line)}
+.ig-cc-case-fan{border-color:var(--accent);box-shadow:0 0 0 3px var(--brand-soft)}
+.ig-cc-art{color:var(--brand);height:64px;display:flex;align-items:center}
+.ig-cc h3{margin:0;font-size:17px}
+.ig-cc p{margin:0;font-size:14.5px;line-height:1.5;color:var(--muted)}
+.ig-cc .ig-pick{margin-top:auto;padding-top:6px;color:var(--ink);font-size:14px}
+.ig-h3{margin:28px 0 10px;font-size:19px}
+.ig-table{overflow-x:auto;border-radius:14px;border:1px solid var(--line)}
+.ig-table table{width:100%;border-collapse:collapse;font-size:14.5px;line-height:1.5;min-width:560px}
+.ig-table th,.ig-table td{padding:12px 14px;text-align:start;vertical-align:top;border-bottom:1px solid var(--line)}
+.ig-table thead th{background:var(--chip);font-size:13px;text-transform:uppercase;letter-spacing:.05em;color:var(--subtle)}
+.ig-table tbody tr:last-child>*{border-bottom:0}
+.ig-table td{color:var(--muted)}
+.ig-note{margin-top:18px;padding:14px 18px;border-radius:14px;border-inline-start:4px solid #FF9F0A;background:var(--chip)}
+.ig-note p{margin:0;font-size:15px;line-height:1.55;color:var(--muted)}.ig-note .ig-note-t{font-weight:800;color:var(--ink);margin-bottom:4px}
+
+/* app options */
+.ig-opt{display:grid;grid-template-columns:1fr 1.2fr;gap:28px;align-items:center}
+.ig-opt p{margin:12px 0 0;font-size:16px;line-height:1.6;color:var(--muted)}
+
+/* safe by design (always dark, like the download band) */
+.ig-safe{background:var(--night);color:#fff;scroll-margin-top:70px}
+.ig-safe .wrap{position:relative;padding-top:72px;padding-bottom:72px}
+.ig-safe .ig-sub{color:var(--night-text)}
+.ig-safe-lumo{position:absolute;right:24px;top:40px;width:120px;height:auto}
+.ig-safe-grid{list-style:none;margin:28px 0 0;padding:0;display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:14px}
+.ig-safe-grid li{padding:20px;border-radius:var(--ig-r);background:var(--night-card);border:1px solid var(--night-line)}
+.ig-safe-grid svg{color:#30D158}
+.ig-safe-grid h3{margin:8px 0 6px;font-size:17px}
+.ig-safe-grid p{margin:0;font-size:14.5px;line-height:1.55;color:var(--night-text)}
+.ig-safe code{background:#0B0B1C;color:#FFD60A}
+.ig-safe-link{margin:22px 0 0}.ig-safe a{color:var(--night-link);font-weight:700}.ig-safe a:hover{color:#fff}
+.ig-safe :focus-visible{outline-color:#FFB800}
+
+/* troubleshooting */
+.ig-faq{padding-top:64px;padding-bottom:24px;scroll-margin-top:70px}
+.ig-faq-list{margin-top:20px;display:grid;gap:10px}
+.ig-faq details{border-radius:14px;background:var(--surface);border:1px solid var(--line-2)}
+.ig-faq summary{cursor:pointer;list-style:none;display:flex;justify-content:space-between;gap:14px;align-items:center;min-height:52px;padding:12px 18px;font-weight:700;font-size:16.5px}
+.ig-faq summary::-webkit-details-marker{display:none}
+.ig-faq summary::after{content:"+";flex:0 0 auto;width:28px;height:28px;border-radius:50%;display:flex;align-items:center;justify-content:center;background:var(--chip);color:var(--brand);font-weight:800}
+.ig-faq details[open] summary::after{content:"−"}
+.ig-faq details p{margin:0;padding:0 18px 16px;font-size:15.5px;line-height:1.6;color:var(--muted)}
+
+/* end */
+.ig-end{padding-top:40px;padding-bottom:72px}
+.ig-end-card{display:flex;gap:28px;align-items:center;padding:32px;border-radius:24px;background:linear-gradient(135deg,var(--sup-a),var(--sup-b));border:1px solid var(--chip-line)}
+.ig-end-card img{flex:0 0 150px;height:auto}
+.ig-end-card p{margin:10px 0 0;color:var(--muted);font-size:16px;line-height:1.55}
+.ig-end-other{font-size:15px!important}
+.ig-shots-note{margin:18px 0 0;text-align:center;font-size:13px;color:var(--subtle)}
+
+@media (max-width:1100px){.ig-guide{grid-template-columns:1fr}.ig-toc{position:static}.ig-toc ol{display:flex;flex-wrap:wrap;gap:6px}.ig-toc a{background:var(--chip);padding:4px 12px 4px 4px;min-height:36px}}
+@media (max-width:900px){
+ .ig-hero-in{grid-template-columns:1fr;padding-top:40px;padding-bottom:40px}
+ .ig-tilt{transform:none}
+ .ig-hello{left:auto;right:0;bottom:-14px}.ig-hello img{width:96px}.ig-bubble{display:none}
+ .ig-opt{grid-template-columns:1fr}
+ .ig-safe-lumo{display:none}
+}
+@media (max-width:700px){
+ .wrap{padding-left:16px;padding-right:16px}
+ .ig-step{grid-template-columns:1fr;gap:10px}
+ .ig-step::before{display:none}
+ .ig-num{width:48px;height:48px;border-radius:14px;font-size:18px}
+ .ig-pair,.ig-trio,.ig-subs{grid-template-columns:1fr}
+ .ig-cool{padding:20px 16px}
+ .ig-end-card{flex-direction:column;text-align:center;padding:24px 16px}.ig-end-card img{flex-basis:auto;width:110px}
+ .ig-dl .btn{flex-basis:100%}
+ .ig-vframe{border-radius:14px}
+ .ig-soon-in>span:last-child{display:none}
+}
diff --git a/web/src/imager.html b/web/src/imager.html
new file mode 100644
index 0000000..b380de6
--- /dev/null
+++ b/web/src/imager.html
@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="{{t.lang}}">
+<head>
+{{{head}}}
+</head>
+<body data-page="imager" data-lang="{{t.lang}}">
+<a class="skip" href="#main">{{t.skip}}</a>
+{{{header}}}
+
+<main id="main" class="ig">
+{{{main}}}
+</main>
+
+{{{lightbox}}}
+{{{footer}}}
+<script src="{{{js}}}" defer></script>
+</body>
+</html>