From 1e8be079d076ca40b7d81c59fe04cb733e8a8a61 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Sat, 17 Oct 2026 10:09:47 +0200 Subject: [PATCH] Document configuration capture workflow --- README.md | 15 +++++++++++++++ docs/desktop-app-configs.md | 7 +++++++ 2 files changed, 22 insertions(+) diff --git a/README.md b/README.md index 629a249..6b29593 100644 --- a/README.md +++ b/README.md @@ -132,6 +132,8 @@ cc sync -ConfigsOnly # fetch and deploy configs; do not call WinGet cc apply -ForceConfigs # back up local edits, then replace them cc configs # show repository and live computer config paths cc configs -Config helix-config # show paths for one managed config +cc capture # collect live configs under Documents for upload +cc capture -Config ontime-style # capture one config cc restore -Config helix-config # restore the newest backup cc doctor # inspect prerequisites and sources cc menu # optional numbered menu @@ -174,6 +176,19 @@ the overlay with the entire application file. Use the complete Nextcloud config because it can contain account and authentication data. +`cc capture` automates the collection side without changing live files. By +default it creates +`Documents\ConfigCentral\captures\MACHINE-yyyyMMdd-HHmmss`. Whole-file configs +retain their `configs/` repository paths. Raw XnView, hosts, and filtered MPC-HC +exports are placed under `review/` for curation. The complete Nextcloud config is +always excluded. Use `-OutputPath PATH` to select an exact empty destination. + +From CachyOS, retrieve a completed capture for review with: + +```bash +scp -r USER@WINDOWS-PC:'Documents/ConfigCentral/captures/MACHINE-yyyyMMdd-HHmmss' ./ +``` + ## Config conflicts and recovery Config Central stores the hash it last deployed. A different destination hash, diff --git a/docs/desktop-app-configs.md b/docs/desktop-app-configs.md index ca91b25..2b4ef61 100644 --- a/docs/desktop-app-configs.md +++ b/docs/desktop-app-configs.md @@ -9,6 +9,13 @@ does not immediately overwrite the result. The checked-in declarations start as safe no-ops or comment-only files. Populate only the values you want shared across every selected machine. +Run `cc capture` to collect the current machine's configuration without applying +repository content. Captures are written beneath +`Documents\ConfigCentral\captures` and split between repository-shaped +`configs/` files and raw `review/` files that require curation. Nextcloud's full +configuration is excluded. Close applications first so their files reflect the +latest saved preferences. + ## MPC-HC MPC-HC normally stores preferences below