docs(site): add Desktop integrations section (right-click + WebDAV mount)

softpython2884 · softpython2884 · commit bb686ab8bdca · 2026-07-23T17:57:47.000Z
- New /docs section with download buttons and copy-paste one-liners for
  the "Send to OpenCoperLock" right-click uploader (Windows + Linux) and
  the Windows WebDAV mount script, served from the official repo.
- Make both Send-To installers repo-aware: they pull their components
  (send.ps1/send.sh, icon) from the checkout when present, else from the
  official repo, so the `irm|iex` / `curl|bash` one-liners work standalone.
- Add a btns block type to the docs page for download links.
diff --git a/apps/web/src/app/docs/page.tsx b/apps/web/src/app/docs/page.tsx
@@ -23,6 +23,8 @@ import {
   UserCog,
   Smartphone,
   ArrowUpRight,
+  Download,
+  MousePointer2,
   type LucideIcon,
 } from 'lucide-react';
 import { API_URL } from '@/lib/api';
@@ -38,7 +40,8 @@ type Block =
   | { ol: string[] }
   | { code: string }
   | { note: string }
-  | { warn: string };
+  | { warn: string }
+  | { btns: { label: string; href: string }[] };
 
 interface Section {
   id: string;
@@ -378,6 +381,53 @@ curl -H "Authorization: Bearer ocl_…" -F "file=@backup.tgz" \\
         },
       ],
     },
+    {
+      id: 'desktop',
+      icon: MousePointer2,
+      title: L('Intégrations bureau (clic droit, disque réseau)', 'Desktop integrations (right-click, network drive)'),
+      blocks: [
+        { h: L('Envoyer vers OpenCoperLock (clic droit)', 'Send to OpenCoperLock (right-click)') },
+        {
+          p: L(
+            'Ajoute une entrée « Envoyer vers → OpenCoperLock » au clic droit de votre explorateur de fichiers (Windows et Linux). Les fichiers sélectionnés sont envoyés en un clic dans un espace « ComputerShared » de votre Drive, via WebDAV. L’installeur mémorise votre serveur et votre jeton d’API.',
+            'Adds a “Send to → OpenCoperLock” entry to your file manager’s right-click menu (Windows and Linux). Selected files upload in one click to a “ComputerShared” space in your Drive, over WebDAV. The installer remembers your server and API token.',
+          ),
+        },
+        { note: L('Créez d’abord un jeton d’API non restreint : Compte → Jetons d’API.', 'First create an unrestricted API token: Account → API tokens.') },
+        { h: L('Windows', 'Windows') },
+        {
+          p: L(
+            'Ouvrez PowerShell et lancez (aucun droit administrateur requis) :',
+            'Open PowerShell and run (no administrator rights needed):',
+          ),
+        },
+        { code: 'irm https://raw.githubusercontent.com/softpython2884/OpenCoperLock/main/scripts/send-to/windows/install-windows.ps1 | iex' },
+        { h: L('Linux', 'Linux') },
+        { p: L('GNOME Files, Cinnamon (Nemo) et KDE Dolphin. Dans un terminal :', 'GNOME Files, Cinnamon (Nemo) and KDE Dolphin. In a terminal:') },
+        { code: 'curl -fsSL https://raw.githubusercontent.com/softpython2884/OpenCoperLock/main/scripts/send-to/linux/install-linux.sh | bash' },
+        {
+          btns: [
+            { label: L('Télécharger l’installeur Windows (.cmd)', 'Download Windows installer (.cmd)'), href: 'https://github.com/softpython2884/OpenCoperLock/raw/main/scripts/send-to/windows/install-windows.cmd' },
+            { label: L('Voir les scripts sur GitHub', 'View the scripts on GitHub'), href: 'https://github.com/softpython2884/OpenCoperLock/tree/main/scripts/send-to' },
+          ],
+        },
+        { h: L('Monter le Drive en disque réseau (Windows)', 'Mount the Drive as a network drive (Windows)') },
+        {
+          p: L(
+            'Le client WebDAV de Windows est capricieux (voir la section WebDAV). Ce script configure le service WebClient, corrige les réglages qui bloquent, puis monte votre Drive sur une lettre (X: par défaut). Lancez dans PowerShell :',
+            'Windows’ WebDAV client is finicky (see the WebDAV section). This script configures the WebClient service, fixes the settings that block it, then maps your Drive to a letter (X: by default). Run in PowerShell:',
+          ),
+        },
+        { code: '$f="$env:TEMP\\ocl-mount.ps1"; irm https://raw.githubusercontent.com/softpython2884/OpenCoperLock/main/scripts/mount-opencoperlock-windows.ps1 -OutFile $f; powershell -ExecutionPolicy Bypass -File $f' },
+        {
+          btns: [
+            { label: L('Télécharger le script (.cmd)', 'Download the script (.cmd)'), href: 'https://github.com/softpython2884/OpenCoperLock/raw/main/scripts/mount-opencoperlock-windows.cmd' },
+            { label: L('Télécharger le script (.ps1)', 'Download the script (.ps1)'), href: 'https://github.com/softpython2884/OpenCoperLock/raw/main/scripts/mount-opencoperlock-windows.ps1' },
+          ],
+        },
+        { note: L('Un prompt UAC apparaît uniquement pour la partie qui règle le service WebClient. Le mappage du lecteur reste en session utilisateur.', 'A UAC prompt appears only for the part that configures the WebClient service. The drive mapping stays in your user session.') },
+      ],
+    },
     {
       id: 'security',
       icon: ShieldCheck,
@@ -533,6 +583,20 @@ curl -H "Authorization: Bearer ocl_…" -F "file=@backup.tgz" \\
                     <p key={i} className="rounded-lg border border-amber-500/25 bg-amber-500/[0.06] px-3 py-2 text-sm text-amber-100/90">
                       ⚠️ {b.warn}
                     </p>
+                  ) : 'btns' in b ? (
+                    <div key={i} className="flex flex-wrap gap-2 pt-1">
+                      {b.btns.map((btn) => (
+                        <a
+                          key={btn.href}
+                          href={btn.href}
+                          target="_blank"
+                          rel="noreferrer"
+                          className="inline-flex items-center gap-1.5 rounded-lg border border-white/10 bg-white/[0.03] px-3 py-1.5 text-sm text-zinc-200 transition hover:border-violet-400/40 hover:bg-violet-500/10 hover:text-white"
+                        >
+                          <Download size={15} /> {btn.label}
+                        </a>
+                      ))}
+                    </div>
                   ) : 'ol' in b ? (
                     <ol key={i} className="list-decimal space-y-1 pl-5 text-sm leading-relaxed text-zinc-400">
                       {b.ol.map((li) => (
diff --git a/scripts/send-to/README.md b/scripts/send-to/README.md
@@ -13,8 +13,14 @@ new server code — just your existing `ocl_…` API token.
 
 1. Get an **unrestricted API token**: web app → *Account → API tokens* (folder-scoped tokens are
    refused by WebDAV).
-2. Double-click **`windows/install-windows.cmd`**. Paste your WebDAV URL
-   (e.g. `https://copper.forgenet.fr/api/dav`) and the token when asked. *No admin needed.*
+2. Install, either way (no admin needed):
+   - **One-liner** — in PowerShell:
+     ```powershell
+     irm https://raw.githubusercontent.com/softpython2884/OpenCoperLock/main/scripts/send-to/windows/install-windows.ps1 | iex
+     ```
+   - **Or** double-click **`windows/install-windows.cmd`** from a checkout.
+
+   Paste your WebDAV URL (e.g. `https://copper.forgenet.fr/api/dav`) and the token when asked.
 3. Done — right-click any file(s) → **Send to → OpenCoperLock**.
 
 The installer copies `send.ps1` + the icon into `%LOCALAPPDATA%\OpenCoperLock`, stores your token
@@ -28,7 +34,11 @@ Re-run the installer any time to change the URL/token. To uninstall, delete the
 ## Linux
 
 1. Get an unrestricted API token (as above).
-2. Run **`linux/install-linux.sh`** and paste your WebDAV URL + token.
+2. Install with the one-liner:
+   ```bash
+   curl -fsSL https://raw.githubusercontent.com/softpython2884/OpenCoperLock/main/scripts/send-to/linux/install-linux.sh | bash
+   ```
+   (or run **`linux/install-linux.sh`** from a checkout), then paste your WebDAV URL + token.
 3. Right-click a file:
    - **GNOME Files / Cinnamon:** *Scripts → Send to OpenCoperLock*
    - **KDE Dolphin:** *Send to OpenCoperLock* (top of the menu)
diff --git a/scripts/send-to/linux/install-linux.sh b/scripts/send-to/linux/install-linux.sh
@@ -5,12 +5,23 @@
 # KDE Dolphin. Selected files upload to the "ComputerShared" space of your Drive over WebDAV.
 set -euo pipefail
 
-here="$(cd "$(dirname "$0")" && pwd)"
-assets="$(cd "$here/../assets" && pwd)"
+# Components come from the local checkout when run from one, or from the official repo when this
+# script is piped from the web (curl ... | bash), so a one-line install works either way.
+REPO_RAW="https://raw.githubusercontent.com/softpython2884/OpenCoperLock/main/scripts/send-to"
+here="$(cd "$(dirname -- "$0")" 2>/dev/null && pwd || true)"
+sendto_root="$(cd "$here/.." 2>/dev/null && pwd || true)"
 data="${XDG_DATA_HOME:-$HOME/.local/share}/opencoperlock"
 cfgdir="${XDG_CONFIG_HOME:-$HOME/.config}/opencoperlock"
 mkdir -p "$data" "$cfgdir"
 
+fetch() { # $1 = path under send-to, $2 = destination, $3 = chmod mode
+  if [ -n "$sendto_root" ] && [ -f "$sendto_root/$1" ]; then
+    install -m "$3" "$sendto_root/$1" "$2"
+  else
+    curl -fsSL "$REPO_RAW/$1" -o "$2" && chmod "$3" "$2"
+  fi
+}
+
 default_base="https://copper.forgenet.fr/api/dav"
 read -rp "WebDAV base URL [$default_base]: " BASE
 BASE="${BASE:-$default_base}"
@@ -24,9 +35,9 @@ umask 077
 printf 'BASE=%q\nTOKEN=%q\n' "$BASE" "$TOKEN" > "$cfgdir/config"
 chmod 600 "$cfgdir/config"
 
-# Install the uploader + icon.
-install -m 0755 "$here/send.sh" "$data/send.sh"
-install -m 0644 "$assets/opencoperlock.png" "$data/opencoperlock.png"
+# Install the uploader + icon (from the checkout or the official repo).
+fetch 'linux/send.sh' "$data/send.sh" 0755
+fetch 'assets/opencoperlock.png' "$data/opencoperlock.png" 0644
 
 installed=()
 
diff --git a/scripts/send-to/windows/install-windows.ps1 b/scripts/send-to/windows/install-windows.ps1
@@ -20,11 +20,20 @@ param(
 )
 $ErrorActionPreference = 'Stop'
 
-$srcDir = Split-Path -Parent $MyInvocation.MyCommand.Path            # ...\send-to\windows
-$assets = Join-Path (Split-Path -Parent $srcDir) 'assets'           # ...\send-to\assets
+# Files come from the local checkout when run from one, or from the official repo when this script
+# is piped straight from the web (irm ... | iex), so a one-line install works either way.
+$RepoRaw = 'https://raw.githubusercontent.com/softpython2884/OpenCoperLock/main/scripts/send-to'
+$self = $PSCommandPath                                              # null under irm|iex
+$sendToRoot = if ($self) { Split-Path -Parent (Split-Path -Parent $self) } else { $null }
 $dstDir = Join-Path $env:LOCALAPPDATA 'OpenCoperLock'
 New-Item -ItemType Directory -Force -Path $dstDir | Out-Null
 
+function Get-Component($rel, $dst) {
+  $local = if ($sendToRoot) { Join-Path $sendToRoot ($rel -replace '/', '\') } else { $null }
+  if ($local -and (Test-Path $local)) { Copy-Item $local $dst -Force }
+  else { Invoke-WebRequest -UseBasicParsing "$RepoRaw/$rel" -OutFile $dst }
+}
+
 # --- gather settings -----------------------------------------------------------------------------
 $defaultBase = 'https://copper.forgenet.fr/api/dav'
 if (-not $Base) {
@@ -42,8 +51,8 @@ if (-not $Token) {
 if ([string]::IsNullOrWhiteSpace($Token)) { throw "No token provided." }
 
 # --- install files -------------------------------------------------------------------------------
-Copy-Item (Join-Path $srcDir 'send.ps1') (Join-Path $dstDir 'send.ps1') -Force
-Copy-Item (Join-Path $assets 'opencoperlock.ico') (Join-Path $dstDir 'opencoperlock.ico') -Force
+Get-Component 'windows/send.ps1' (Join-Path $dstDir 'send.ps1')
+Get-Component 'assets/opencoperlock.ico' (Join-Path $dstDir 'opencoperlock.ico')
 
 # DPAPI-encrypt the token (current-user scope) and write the config.
 $enc = ConvertTo-SecureString $Token -AsPlainText -Force | ConvertFrom-SecureString
