docs(faq): USB sync, sudoers, and move2usb/copy.chk

- Expand automatic USB sync: Polkit, sudoers 021, installer re-run, FAT/exFAT label.

- Document move2usb same target as Synctodrive and copy.chk at USB root.

- Rebuild static faq/ site (mkdocs).

- en.json + install comment: no standalone setup script; use install-photobooth.sh USB Sync policy.

Made-with: Cursor

Author: Photobooth

docs/faq/index.md

@@ -261,20 +261,35 @@ Take a look for "Loaded Configuration File" to get the path of your php.ini, you
 
 ## Automatic picture syncing to USB stick
 
-This feature will automatically and in regular intervals copy (sync) new pictures to a plugged-in USB stick
+This feature copies (syncs) new pictures to a plugged-in USB stick on a schedule using `rsync` on Linux.
 
-Use the [Photobooth Setup Wizard](https://photoboothproject.github.io/install/setup_wizard) to get the operating system setup in place.
+### Operating system setup (Linux)
 
-- 6. Permissions -> USB Sync policy
+The web server user (`www-data`) must be allowed to mount and unmount the stick. Options:
 
-The target USB device is selected through the admin panel.
+- [Photobooth Setup Wizard](https://photoboothproject.github.io/install/setup_wizard) -> **Permissions** -> **USB Sync policy** installs Polkit rules for `udisksctl` and passwordless sudo for `mount` / `umount` (and `mkdir` under `/media`) via `/etc/sudoers.d/021_www-data-usb-sync`. Polkit and sudoers are applied as independently as possible: if one step fails, the other may still succeed. The same menu entry applies during a fresh install (general permissions) and can be run again after system updates to re-apply the rules.
 
-A USB drive / stick can be identified either by the USB stick label (e.g. `photobooth`), the operating system specific USB device name (e.g. `/dev/sda1`) or the USB device system subsystem name (e.g. `sda`). The preferred method would be the USB stick label (for use of a single USB stick) or the very specific USB device name, for different USB stick use. The default config will look for a drive with the label photobooth. The script only supports one single USB stick connected at a time
+Prefer a **FAT32 or exFAT** volume whose **volume label** matches the identifier you set in the admin panel.
 
-Pictures will be synced to the USB stick matched by the pattern, as long as it is mounted (aka USB stick is plugged in)
+### Admin configuration
 
-Debugging: Check the server logs for errors at the Debug panel: [http://localhost/admin/debugpanel](http://localhost/admin/debugpanel) (
-or [http://localhost/photobooth/admin/debugpanel](http://localhost/photobooth/admin/debugpanel)).
+Enable sync, interval, and target in the admin panel (Synctodrive / USB sync settings).
+
+A USB drive can be matched by:
+
+- Volume label (e.g. `photobooth`) -- best for one dedicated stick
+- Block device (e.g. `/dev/sda1`)
+- Short subsystem name (e.g. `sda`)
+
+Use only **one** connected USB stick at a time. Sync runs while the matching volume is mounted.
+
+### Remote buzzer "Move to USB"
+
+The **`move2usb`** action uses the **same** USB target and rsync layout as automatic sync and needs the **same** Linux permissions. After a successful run the server checks for **`copy.chk` on the root of the USB volume** (not under a `data` folder). See [Remote Buttons](remote-button.md).
+
+### Debugging
+
+Check server logs in the admin Debug panel: [http://localhost/admin/debugpanel](http://localhost/admin/debugpanel) (or [http://localhost/photobooth/admin/debugpanel](http://localhost/photobooth/admin/debugpanel)).
 
 ---
 

docs/faq/remote-button.md

@@ -61,6 +61,7 @@ Notes
 
 - Channel: `photobooth-socket`
 - Commands: `start-picture`, `start-collage`, `collage-next`, `start-custom`, `start-video`, `print`, `rotary-cw`, `rotary-ccw`, `rotary-btn-press`, `move2usb`
+- `move2usb` runs the same rsync-based copy as **Synctodrive** to the USB target configured in the admin panel. On Linux it needs the same mount/umount setup as [automatic USB picture sync](index.md#automatic-picture-syncing-to-usb-stick). After rsync, the remotebuzzer server expects **`copy.chk` at the root of the USB volume** to confirm success.
 - Response: `completed` after the workflow finishes.
 
 ## 4) Remote trigger via simple web requests (HTTP)
@@ -76,7 +77,7 @@ Notes
   - `[Base URL]/commands/start-custom`
   - `[Base URL]/commands/start-print`
   - `[Base URL]/commands/start-video`
-  - `[Base URL]/commands/start-move2usb`
+  - `[Base URL]/commands/start-move2usb` (same USB target and OS permissions as Synctodrive; see note on `move2usb` above)
   - `[Base URL]/commands/reboot-now`
   - `[Base URL]/commands/shutdown-now`
   - `[Base URL]/commands/rotary-cw`

faq/faq/index.html

@@ -131,6 +131,16 @@
     <li class="toctree-l2"><a class="reference internal" href="#how-to-adjust-the-phpini-file">How to adjust the php.ini file?</a>
     </li>
     <li class="toctree-l2"><a class="reference internal" href="#automatic-picture-syncing-to-usb-stick">Automatic picture syncing to USB stick</a>
+        <ul>
+    <li class="toctree-l3"><a class="reference internal" href="#operating-system-setup-linux">Operating system setup (Linux)</a>
+    </li>
+    <li class="toctree-l3"><a class="reference internal" href="#admin-configuration">Admin configuration</a>
+    </li>
+    <li class="toctree-l3"><a class="reference internal" href="#remote-buzzer-move-to-usb">Remote buzzer "Move to USB"</a>
+    </li>
+    <li class="toctree-l3"><a class="reference internal" href="#debugging">Debugging</a>
+    </li>
+        </ul>
     </li>
     <li class="toctree-l2"><a class="reference internal" href="#raspberry-touchpanel-dsi-simultaneously-with-hdmi">Raspberry Touchpanel DSI simultaneously with HDMI</a>
     </li>
@@ -451,20 +461,26 @@ <h2 id="how-to-adjust-the-phpini-file">How to adjust the <code>php.ini</code> fi
 <p>Take a look for "Loaded Configuration File" to get the path of your php.ini, you need <em>sudo</em> rights to edit the file.</p>
 <hr />
 <h2 id="automatic-picture-syncing-to-usb-stick">Automatic picture syncing to USB stick</h2>
-<p>This feature will automatically and in regular intervals copy (sync) new pictures to a plugged-in USB stick</p>
-<p>Use the <a href="https://photoboothproject.github.io/install/setup_wizard">Photobooth Setup Wizard</a> to get the operating system setup in place.</p>
+<p>This feature copies (syncs) new pictures to a plugged-in USB stick on a schedule using <code>rsync</code> on Linux.</p>
+<h3 id="operating-system-setup-linux">Operating system setup (Linux)</h3>
+<p>The web server user (<code>www-data</code>) must be allowed to mount and unmount the stick. Options:</p>
 <ul>
-<li>
-<ol>
-<li>Permissions -&gt; USB Sync policy</li>
-</ol>
-</li>
+<li><a href="https://photoboothproject.github.io/install/setup_wizard">Photobooth Setup Wizard</a> -&gt; <strong>Permissions</strong> -&gt; <strong>USB Sync policy</strong> installs Polkit rules for <code>udisksctl</code> and passwordless sudo for <code>mount</code> / <code>umount</code> (and <code>mkdir</code> under <code>/media</code>) via <code>/etc/sudoers.d/021_www-data-usb-sync</code>. Polkit and sudoers are applied as independently as possible: if one step fails, the other may still succeed. The same menu entry applies during a fresh install (general permissions) and can be run again after system updates to re-apply the rules.</li>
+</ul>
+<p>Prefer a <strong>FAT32 or exFAT</strong> volume whose <strong>volume label</strong> matches the identifier you set in the admin panel.</p>
+<h3 id="admin-configuration">Admin configuration</h3>
+<p>Enable sync, interval, and target in the admin panel (Synctodrive / USB sync settings).</p>
+<p>A USB drive can be matched by:</p>
+<ul>
+<li>Volume label (e.g. <code>photobooth</code>) -- best for one dedicated stick</li>
+<li>Block device (e.g. <code>/dev/sda1</code>)</li>
+<li>Short subsystem name (e.g. <code>sda</code>)</li>
 </ul>
-<p>The target USB device is selected through the admin panel.</p>
-<p>A USB drive / stick can be identified either by the USB stick label (e.g. <code>photobooth</code>), the operating system specific USB device name (e.g. <code>/dev/sda1</code>) or the USB device system subsystem name (e.g. <code>sda</code>). The preferred method would be the USB stick label (for use of a single USB stick) or the very specific USB device name, for different USB stick use. The default config will look for a drive with the label photobooth. The script only supports one single USB stick connected at a time</p>
-<p>Pictures will be synced to the USB stick matched by the pattern, as long as it is mounted (aka USB stick is plugged in)</p>
-<p>Debugging: Check the server logs for errors at the Debug panel: <a href="http://localhost/admin/debugpanel">http://localhost/admin/debugpanel</a> (
-or <a href="http://localhost/photobooth/admin/debugpanel">http://localhost/photobooth/admin/debugpanel</a>).</p>
+<p>Use only <strong>one</strong> connected USB stick at a time. Sync runs while the matching volume is mounted.</p>
+<h3 id="remote-buzzer-move-to-usb">Remote buzzer "Move to USB"</h3>
+<p>The <strong><code>move2usb</code></strong> action uses the <strong>same</strong> USB target and rsync layout as automatic sync and needs the <strong>same</strong> Linux permissions. After a successful run the server checks for <strong><code>copy.chk</code> on the root of the USB volume</strong> (not under a <code>data</code> folder). See <a href="remote-button/">Remote Buttons</a>.</p>
+<h3 id="debugging">Debugging</h3>
+<p>Check server logs in the admin Debug panel: <a href="http://localhost/admin/debugpanel">http://localhost/admin/debugpanel</a> (or <a href="http://localhost/photobooth/admin/debugpanel">http://localhost/photobooth/admin/debugpanel</a>).</p>
 <hr />
 <h2 id="raspberry-touchpanel-dsi-simultaneously-with-hdmi">Raspberry Touchpanel DSI simultaneously with HDMI</h2>
 <p>When using a touchscreen on DSI and an HDMI screen simultaneously, the touch input is offset. This is because both monitors are recognized as one screen.</p>

faq/faq/remote-button/index.html

@@ -236,6 +236,7 @@ <h2 id="3-remote-trigger-via-socketio">3) Remote trigger via Socket.io</h2>
 <ul>
 <li>Channel: <code>photobooth-socket</code></li>
 <li>Commands: <code>start-picture</code>, <code>start-collage</code>, <code>collage-next</code>, <code>start-custom</code>, <code>start-video</code>, <code>print</code>, <code>rotary-cw</code>, <code>rotary-ccw</code>, <code>rotary-btn-press</code>, <code>move2usb</code></li>
+<li><code>move2usb</code> runs the same rsync-based copy as <strong>Synctodrive</strong> to the USB target configured in the admin panel. On Linux it needs the same mount/umount setup as <a href="../#automatic-picture-syncing-to-usb-stick">automatic USB picture sync</a>. After rsync, the remotebuzzer server expects <strong><code>copy.chk</code> at the root of the USB volume</strong> to confirm success.</li>
 <li>Response: <code>completed</code> after the workflow finishes.</li>
 </ul>
 <h2 id="4-remote-trigger-via-simple-web-requests-http">4) Remote trigger via simple web requests (HTTP)</h2>
@@ -251,7 +252,7 @@ <h2 id="4-remote-trigger-via-simple-web-requests-http">4) Remote trigger via sim
 <li><code>[Base URL]/commands/start-custom</code></li>
 <li><code>[Base URL]/commands/start-print</code></li>
 <li><code>[Base URL]/commands/start-video</code></li>
-<li><code>[Base URL]/commands/start-move2usb</code></li>
+<li><code>[Base URL]/commands/start-move2usb</code> (same USB target and OS permissions as Synctodrive; see note on <code>move2usb</code> above)</li>
 <li><code>[Base URL]/commands/reboot-now</code></li>
 <li><code>[Base URL]/commands/shutdown-now</code></li>
 <li><code>[Base URL]/commands/rotary-cw</code></li>

faq/index.html

@@ -255,5 +255,5 @@ <h2 id="contribute-to-this-documentation">Contribute to this documentation</h2>
 
 <!--
 MkDocs version : 1.6.1
-Build Date UTC : 2026-03-22 08:54:23.893573+00:00
+Build Date UTC : 2026-03-22 12:18:10.177875+00:00
 -->

faq/search/search_index.json

@@ -1270,7 +1270,7 @@ EOF
 
 function install_usb_sudoers() {
     local sudoers_file="/etc/sudoers.d/021_www-data-usb-sync"
-    # Match manual helper scripts/setup-usb-sync.sh (portable paths; some distros use /bin vs /usr/bin).
+    # Portable paths: some distros use /bin vs /usr/bin for mount/umount/mkdir.
     cat >"$sudoers_file" <<'EOF'
 # Photobooth USB Sync — passwordless mount/umount/mkdir for www-data (sync-to-drive.js, move2usb).
 # Use together with Polkit rules for udisksctl; this covers sudo fallbacks in the Node scripts.

install-photobooth.sh

@@ -758,7 +758,7 @@
   "manual:sound:sound_fallback_enabled": "Use EN sounds as fallback if the current language is not supported yet",
   "manual:sound:sound_test": "Play a random test sound",
   "manual:sound:sound_voice": "Which voice to use for sounds",
-  "manual:synctodrive:synctodrive_enabled": "Enable automatic syncing of new pictures to a USB device using rsync. On Linux the web server user (<code>www-data</code>) must be allowed to mount the stick: the Photobooth install wizard can install Polkit rules and passwordless sudo for <code>mount</code>/<code>umount</code> (Permissions → USB Sync policy, or during install via general permissions). You can also run <code>scripts/setup-usb-sync.sh</code> as root after updates. Use a labelled FAT32 or exFAT volume where the label matches the identifier below.",
+  "manual:synctodrive:synctodrive_enabled": "Enable automatic syncing of new pictures to a USB device using rsync. On Linux the web server user (<code>www-data</code>) must be allowed to mount the stick: run <code>install-photobooth.sh</code> and use Permissions → USB Sync policy (or general permissions during install) to install Polkit rules and passwordless sudo for <code>mount</code>/<code>umount</code>. Run that menu entry again after system updates if you need to re-apply the rules. Use a labelled FAT32 or exFAT volume where the label matches the identifier below.",
   "manual:synctodrive:synctodrive_interval": "Seconds between automatic sync attempts (interval while the USB Sync process is running).",
   "manual:synctodrive:synctodrive_target": "Pattern to identify the USB device: usually the volume label of the stick (e.g. <code>photobooth</code>), or the block device path (e.g. <code>/dev/sda1</code>) or short name (e.g. <code>sda1</code>). Must match a removable USB device.",
   "manual:theme_title": "Use the Themes box to save current theme fields, load another, export a ZIP (config + referenced images), or import that ZIP to install a theme. Import or save will overwrite an existing theme with the same name.",