From 9d44d24abdeb256f566f1dcd1b3c36c526f5782e Mon Sep 17 00:00:00 2001
From: claude <claude@brasse-pc.eu>
Date: Sun, 30 Aug 2026 12:48:24 +0200
Subject: [PATCH] =?UTF-8?q?Wiki:=20Installation=20+=20Konfiguration,=20nav?=
 =?UTF-8?q?igering=20p=C3=A5=20Home?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 Home.md          |  6 ++--
 Installation.md  | 47 ++++++++++++++++++++++++++
 Konfiguration.md | 88 ++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 139 insertions(+), 2 deletions(-)
 create mode 100644 Installation.md
 create mode 100644 Konfiguration.md

diff --git a/Home.md b/Home.md
index 837a237..7fe0d47 100644
--- a/Home.md
+++ b/Home.md
@@ -6,8 +6,10 @@ Modern, resurssnål dock för Wayfire — transparent Plasma 6-känsla,
 byggd i Rust/GTK4 som en enda binär. Körs på **brasse-linux01** i
 Wayfire-DE-sessionen.
 
-- **[Användning](Användning)** — flaggor, dagligt bruk, hela configreferensen
-- **[Arkitektur](Arkitektur)** — hur appen är byggd (moduler, nyckelbeslut, resursbudget)
+- **[Installation](Installation)** — en-raders-install, krav, autostart
+- **[Konfiguration](Konfiguration)** — configfilen, settings-GUI:t, per skärm
+- **[Användning](Användning)** — dagligt bruk + hela configreferensen
+- **[Arkitektur](Arkitektur)** — hur appen är byggd (moduler, nyckelbeslut)
 - Planen och milstolparna ligger i repot: [`doc/plan.md`](https://gitea.brasse-pc.eu/brasse/waydock/src/branch/master/doc/plan.md)
 
 | Dockan | Inställningar |
diff --git a/Installation.md b/Installation.md
new file mode 100644
index 0000000..f06c1a6
--- /dev/null
+++ b/Installation.md
@@ -0,0 +1,47 @@
+# Installation
+
+## Snabbast: en rad
+
+```bash
+curl -fsSL https://gitea.brasse-pc.eu/brasse/waydock/raw/branch/master/install.sh | sh
+```
+
+Det hämtar senaste release-binären (~1,6 MB) till `~/.local/bin/waydock`
+och installerar appikon + `.desktop`-fil. Starta sedan med:
+
+```bash
+waydock
+```
+
+## Krav
+
+| Krav | Varför |
+|---|---|
+| `gtk4` + `gtk4-layer-shell` | rendering och panel-fönstren (`sudo pacman -S gtk4 gtk4-layer-shell`) |
+| wlroots-compositor med `zwlr_foreign_toplevel_manager_v1` | fönsterlistan (Wayfire, Sway, …) |
+| Wayfires `ipc` + `ipc-rules`-plugins *(valfritt)* | översiktsknappen, "Flytta till skärm", dodge-autohide och peek |
+| Wayfires `alpha`-plugin *(valfritt)* | peek-förhandsvisningen (tona ner andra fönster) |
+
+Pluginsen aktiveras i `wayfire.ini` under `[core] plugins = … ipc ipc-rules alpha …`
+— Wayfire laddar om configen live, ingen omstart behövs.
+
+## Bygga själv
+
+```bash
+git clone https://gitea.brasse-pc.eu/brasse/waydock.git
+cd waydock
+cargo build --release          # binär: target/release/waydock
+```
+
+## Starta med Wayfire-sessionen
+
+Lägg ett autostart-skript (i Wayfire-DE: `autostart/11-dock.sh`):
+
+```bash
+#!/usr/bin/env bash
+exec ~/.local/bin/waydock
+```
+
+## Uppdatera
+
+Kör en-raders-installen igen — den hämtar alltid senaste `latest`-releasen.
diff --git a/Konfiguration.md b/Konfiguration.md
new file mode 100644
index 0000000..fd8f6e5
--- /dev/null
+++ b/Konfiguration.md
@@ -0,0 +1,88 @@
+# Konfiguration
+
+## Två sätt — samma fil
+
+waydock konfigureras via **en enda JSON-fil**:
+
+```
+~/.config/waydock/config.json
+```
+
+Filen **skapas automatiskt med standardvärden** första gången appen
+startar. Alla ändringar plockas upp **live** — spara filen och docken
+uppdaterar sig direkt, ingen omstart.
+
+Du kan blanda fritt mellan:
+
+1. **Settings-GUI:t** — högerklicka på en tom yta i dockan →
+   **Inställningar…** (eller kör `waydock --settings`). Varje reglage
+   skriver direkt till JSON-filen.
+2. **Handredigering** — öppna filen i valfri editor. Trasig JSON är
+   ofarligt: waydock loggar felet och kör vidare på förra värdena utan
+   att röra din fil.
+
+![Inställningar](settings.png)
+
+## Per skärm
+
+Överst i settings sitter **skärmväljaren** med en klickbar minibild av
+dina skärmar. "Alla skärmar" (standard) redigerar det globala; välj en
+skärm för att ge just den egna värden — **bara fälten du ändrar** sparas
+som avvikelse, resten ärvs från det globala. `*` = skärmen har egna
+inställningar; "Återställ skärmen till globalt" tar bort dem.
+
+I JSON-filen hamnar avvikelserna under `"outputs"`, med skärmens
+connector-namn som nyckel:
+
+```jsonc
+"outputs": {
+  "DP-1": {
+    "position": "left",                    // bara på DP-1
+    "only_this_output": true,              // visa bara DP-1:s fönster
+    "pins": ["steam", "discord"],          // egna pins
+    "appearance": { "accent": "#5fb878" }  // egen accentfärg
+  }
+}
+```
+
+## Så här ser filen ut (utdrag med det viktigaste)
+
+```jsonc
+{
+  "position": "bottom",         // bottom | top | left | right
+  "alignment": "center",        // center | start | end
+  "expand": false,              // true = täck hela kanten
+  "margin": 8,                  // avstånd från kanten (minus tillåtet)
+
+  "appearance": {
+    "background": "#222222",    // panelfärg
+    "opacity": 0.72,            // transparens
+    "accent": "#c9545d",        // indikatorer, hover, markeringar
+    "icon_size": 36,
+    "corner_radius": 14
+  },
+
+  "pins": ["firefox", "org.kde.konsole", "org.kde.dolphin"],
+
+  "behavior": {
+    "click": "focus_or_minimize",
+    "group_popup": "click",     // click | hover
+    "list_hover": "peek"        // peek | focus | none
+  }
+}
+```
+
+`pins` använder `.desktop`-id (filnamnet utan `.desktop`). Hitta rätt id:
+
+```bash
+ls /usr/share/applications | grep -i <appnamn>
+```
+
+Hela referensen med **alla** nycklar finns på [Användning](Användning).
+
+## Loggar
+
+```bash
+waydock --log debug                       # pratig logg till terminalen
+waydock --log-file ~/.cache/waydock.log   # eller till fil
+```