Central config manager
Go to file
Dandaedre f9993c9c03
Config Central CI Config Central failed CI.
Beffroi/config-central/pipeline/head There was a failure building this commit Details
Enable automatic PDF Presenter release updates
2026-11-20 08:48:29 +01:00
configs Capture and apply Windows sound and battery display settings 2026-11-13 10:00:51 +01:00
docs Enable automatic PDF Presenter release updates 2026-11-20 08:48:29 +01:00
machines Use beffroi-laptop as the bundled machine profile 2026-10-19 12:12:02 +02:00
profiles Enable automatic PDF Presenter release updates 2026-11-20 08:48:29 +01:00
schemas Validate portable release discovery manifests 2026-11-20 08:42:58 +01:00
src Add package-only software update command 2026-11-20 08:48:21 +01:00
tests Add package-only software update command 2026-11-20 08:48:21 +01:00
tools Explain how to initialize missing MPC-HC settings 2026-10-19 15:51:25 +02:00
AGENTS.md Document consistent script output and failure handling 2026-10-19 15:31:44 +02:00
Jenkinsfile Add one-stop web installer 2026-10-17 09:03:09 +02:00
README.md Enable automatic PDF Presenter release updates 2026-11-20 08:48:29 +01:00
TASKS.md Enable automatic PDF Presenter release updates 2026-11-20 08:48:29 +01:00
bootstrap.ps1 Standardize script status colors and friendly error boundaries 2026-10-19 15:31:32 +02:00
cc.cmd Wire CLI planning and apply workflow 2026-10-16 13:48:50 +02:00
cc.ps1 Add package-only software update command 2026-11-20 08:48:21 +01:00
install.ps1 Standardize script status colors and friendly error boundaries 2026-10-19 15:31:32 +02:00
update-configs.ps1 Standardize script status colors and friendly error boundaries 2026-10-19 15:31:32 +02:00

README.md

Config Central

Install the software and settings for a Windows desktop, then keep its configs up to date with one command. No management server or background agent is needed.

Both commands below apply the latest repository configs. Install also sets up the tools and installs or updates the declared software. Update does only the configs, making it the faster choice for everyday changes after setup.

1. Install software and apply configs

Open Windows PowerShell as your normal desktop user and paste:

irm 'https://proxy.dandaedre.com/gitea/Beffroi/config-central/raw/branch/main/install.ps1' | iex

The bundled machine profile is beffroi-laptop, selected automatically. If you add more machines, setup matches the computer name or asks you to choose one. It installs Git, PowerShell 7, and the declared software, then applies the configs. Approve administrator prompts when needed. Existing managed settings are backed up and replaced with repository versions. Run this command on a new computer, when you add software to the install list, or when you need to repair setup.

Requires Windows 10 1809 or newer, Windows 11, or Windows Server 2025, with internet access and support for WinGet.

The desktop profile also installs PDF Presenter as a verified portable package on Windows x64, pinned to preview version 0.1.33. Launch pdf-presenter from Start → Config Central → idle-org. Close it, then run cc update-software to check for a newer upstream preview and update all declared software. Downloads are verified against the release checksum. The config-only update below skips software. See portable package updates.

2. Use update for routine config changes

Close the applications whose settings you are updating, then paste into PowerShell:

irm 'https://proxy.dandaedre.com/gitea/Beffroi/config-central/raw/branch/main/update-configs.ps1' | iex

This downloads the latest configs and updater code from your saved repository branch and applies them to your saved machine profile, using the same config deployment as install. It skips prerequisite setup and software installation or upgrades. No menu or manual Git pull is needed; temporary downloads are removed afterward. Run install once before using update on a new computer.

Unchanged configs are skipped. Local settings are backed up and replaced with the repository versions by default. To preserve local edits instead, see advanced update options. Windows may request administrator approval for settings such as the hosts file.

Collect settings from a computer

After changing settings in an application, close it and run in a new terminal:

cc capture

The files are saved under Documents\ConfigCentral\captures\MACHINE-yyyyMMdd-HHmmss. Review them, copy the desired settings into this repository, then commit and push. Run the update command on the other computers to receive those changes. This includes Windows sound-event settings and the active power plan's battery screen timeout. The repository defaults disable system sounds and keep the screen on while on battery.

Capture does not upload anything automatically; some exports need curation. See the application config guide for details.

Troubleshooting and advanced use

Run cc doctor in a new terminal to check setup, or cc status to inspect the last run and config drift. Status colors highlight failures (red), conflicts or skips (yellow), completed work (green), and unchanged items (gray).