Automated repo cleanup with claude

roles/better-shell-env/README.md

@@ -0,0 +1,7 @@
+# better-shell-env
+
+Installs preferred CLI tooling (fish, ripgrep, fd-find, neovim, tmux, lsd,
+broot, fzf, glances, bat, duf, zoxide) and sets up `oh-my-fish` with the
+`bobthefish` theme for `main_user`.
+
+**Key vars:** `main_user`

roles/bluetooth-monitor/README.md

@@ -0,0 +1,12 @@
+# bluetooth-monitor
+
+Installs `my_btmonitor.py` (BLE scanning via `bleak`) as a systemd service
+that watches for nearby devices, publishes state over MQTT, and can restart
+the local BLE interface on a watchdog timeout.
+
+**Key vars:** `my_bt_monitor_watchdog_seconds`, `my_btmonitor_restart_ble_interface`,
+`my_btmonitor_mqtt_username`, `my_btmonitor_mqtt_password`
+
+`other/` is not part of the deployed role — it's a separate, standalone
+data-analysis project (Jupyter notebook, Dockerfile, collected CSV data) used
+to analyze data captured by the monitor.

roles/pi-alsasetup/README.md

@@ -0,0 +1,3 @@
+# pi-alsasetup
+
+Syncs the ALSA configuration file to the host.

roles/pi-dhtsensor-circuitpython/README.md

@@ -0,0 +1,8 @@
+# pi-dhtsensor-circuitpython
+
+Installs the DHT22 temperature/humidity sensor polling script based on
+`adafruit-circuitpython-dht` (requires `libgpiod2`) — the newer alternative
+to the `pi-dhtsensor` role's legacy `Adafruit_DHT` library. Mutually
+exclusive with `pi-dhtsensor`.
+
+**Key vars:** `dht_pin`, `dht_polling_sleep_time_seconds`

roles/pi-dhtsensor/README.md

@@ -0,0 +1,7 @@
+# pi-dhtsensor
+
+Installs the DHT22 temperature/humidity sensor polling script based on the
+legacy `Adafruit_DHT` library (removing the circuitpython variant/
+`libgpiod2` if present — mutually exclusive with `pi-dhtsensor-circuitpython`).
+
+**Key vars:** `dht_pin`, `dht_polling_sleep_time_seconds`

roles/pi-disable-onboard-bluetooth/README.md

@@ -0,0 +1,4 @@
+# pi-disable-onboard-bluetooth
+
+Disables the Pi's onboard Bluetooth radio via `dtoverlay=disable-bt` in the
+boot config, for hosts that use an external BT/audio dongle instead.

roles/pi-hifiberry-amp/README.md

@@ -0,0 +1,6 @@
+# pi-hifiberry-amp
+
+Deactivates the Pi's onboard analog audio and activates a HiFiBerry
+amp/DAC overlay instead.
+
+**Key vars:** `hifiberry_overlay`

roles/pi-irserver/README.md

@@ -0,0 +1,5 @@
+# pi-irserver
+
+Installs and configures `irserver` (with a Hauppauge remote config) as an
+autostarted systemd service for IR remote control, and registers it with
+`pi-sysdweb`.

roles/pi-lirc/README.md

@@ -0,0 +1,5 @@
+# pi-lirc
+
+Installs and configures LIRC (Linux Infrared Remote Control): package,
+`lirc_options.conf`, `lircd.conf`, a remote definition file, and the
+required boot overlay.

roles/pi-musicmouse/README.md

@@ -0,0 +1,4 @@
+# pi-musicmouse
+
+Deploys the "Musicmouse" application: checks out its git repo, creates a
+Python virtualenv, sets up a media directory, and installs its config file.

roles/pi-shairport/README.md

@@ -0,0 +1,6 @@
+# pi-shairport
+
+Builds and installs shairport-sync (AirPlay receiver) from source, copies
+its config, and patches the systemd service to run as root.
+
+**Key vars:** `shairport_sync_version`, `shairport_name`

roles/pi-sispmctl/README.md

@@ -0,0 +1,4 @@
+# pi-sispmctl
+
+Builds and installs `sispmctl` (controls Gembird SIS-PM controllable power
+strips) from source and runs it as an autostarted systemd service.

roles/pi-squeezelite-custom/README.md

@@ -0,0 +1,5 @@
+# pi-squeezelite-custom
+
+Like `pi-squeezelite`, but uninstalls the distro package and deploys a
+custom-compiled `squeezelite` build instead as a systemd service. See
+`custom build/readme_build.md` for how that build is produced.

roles/pi-squeezelite/README.md

@@ -0,0 +1,6 @@
+# pi-squeezelite
+
+Installs the distro-packaged `squeezelite` client (Logitech Media Server
+player), installs its config file, and registers it with `pi-sysdweb`.
+
+**Key vars:** `squeezeserver`

roles/pi-squeezeserver/README.md

@@ -0,0 +1,4 @@
+# pi-squeezeserver
+
+Installs and enables the Logitech Media Server (`squeezeserver`) package,
+and registers it with `pi-sysdweb`.

roles/pi-standard-setup/README.md

@@ -0,0 +1,10 @@
+# pi-standard-setup
+
+Baseline provisioning applied to every Pi: apt update/upgrade, detects the
+Pi model, adds a root SSH key, disables the SSH locale-forwarding warning,
+optionally configures wifi and the hostname, and rotates the default
+`pi`/`raspberry` credentials via the `keepass` lookup plugin.
+
+**Key vars:** `wifi_ssid`, `new_hostname`, `timezone`, `wifi_country`,
+`ansible_ssh_pass` (the OS-default password, used only to reach a
+freshly-flashed Pi for the first time before its password is rotated)

roles/pi-sysdweb/README.md

@@ -0,0 +1,6 @@
+# pi-sysdweb
+
+Installs `sysdweb` (a small web UI for managing systemd units) and creates
+its service user. Other roles register their services with it.
+
+**Key vars:** `sysdweb_name`

roles/server-basic-environment/README.md

@@ -0,0 +1,3 @@
+# server-basic-environment
+
+apt update/upgrade, plus downloads and installs `mbenv` on the server.

roles/server-debian-docker/README.md

@@ -0,0 +1,3 @@
+# server-debian-docker
+
+Installs Docker CE on Debian via the official Docker apt repository.

roles/server-exthdd-mount/README.md

@@ -0,0 +1,4 @@
+# server-exthdd-mount
+
+Sets up systemd automount units and udev rules for external hard drives
+(`passport4`, `passport5`).

roles/server-link-aggregation/README.md

@@ -0,0 +1,4 @@
+# server-link-aggregation
+
+Configures a network interface file for link aggregation (bonding) on the
+server.

roles/server-nfs/README.md

@@ -0,0 +1,4 @@
+# server-nfs
+
+Installs the NFS server, manages `/etc/exports`, and restarts
+`nfs-kernel-server` on changes.