Dev toolchain scan: DEVELOPMENT.md, dev-setup.sh, OpenSCAD + Android Studio flatpaks
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Claude Fable 5
+103
@@ -0,0 +1,103 @@
|
||||
# Development setup
|
||||
|
||||
What the 29 projects in `~/Documents/Development` need on the new machine, mapped against what
|
||||
the image already provides. Scanned 2026-07 from each project's manifests, Dockerfiles, and
|
||||
setup scripts. Run [scripts/dev-setup.sh](scripts/dev-setup.sh) after first boot to install the
|
||||
toolchain layer in one shot.
|
||||
|
||||
## Already in the image — install nothing
|
||||
|
||||
| Need | Provided by | Used by |
|
||||
|---|---|---|
|
||||
| Docker CE + compose, Podman, skopeo | Bazzite DX base | requester, serverTransfer, ispy, keyWord, encoderPro, movieScanner, kidstube, Docker-Registry-Browser, smartSpeaker… |
|
||||
| NVIDIA driver (610+ open) + container toolkit + CDI | base (nvidia image) | AIVoice, ispy, keyWord, encoderPro, smartSpeaker whisper, superBossMonster art pipeline |
|
||||
| qemu/KVM + virt tooling | DX base | BC250 VM testing |
|
||||
| android-tools (adb) | DX base | denon-bluetooth btsnoop captures |
|
||||
| Steam + Proton | Bazzite base | BG4_UltraWide_fix |
|
||||
| VS Code, git, Homebrew, just | DX base | everything |
|
||||
| BlueZ/bluetoothd, rsync, openssh | Fedora base | denon-bluetooth, serverTransfer |
|
||||
| Godot (current stable), OpenSCAD, Android Studio | first-boot Flatpaks | superBossMonster/FFCardGame, DVDPhotoMatic jigs, native-angular |
|
||||
|
||||
AIVoice's `SETUP.md` warning about snap Docker / Docker Desktop is moot here: Bazzite DX ships
|
||||
native docker-ce, which is exactly what it wants. Its
|
||||
`nvidia-ctk runtime configure --runtime=docker` step is the same one in the README's GPU
|
||||
section.
|
||||
|
||||
## Toolchains — mise (all per-version needs found in the scan)
|
||||
|
||||
No project commits `.nvmrc`/`.python-version`/`.tool-versions`, so versions below come from
|
||||
Dockerfiles and build configs. `dev-setup.sh` installs mise and these versions:
|
||||
|
||||
- **Node 22** global default (requester, movieScanner); projects also reference 18
|
||||
(Docker-Registry-Browser, movieMetaTagger) and 20 (FFCardGame server, kidstube) — installed
|
||||
side-by-side, pin per-project with `mise use node@18` in the project dir (writes
|
||||
`mise.toml` — worth committing so this guesswork ends).
|
||||
- **Python 3.12** (serverTransfer, movieMetaTagger, movieScanner, nameFixer4000, BG4 tools) and
|
||||
**3.11** floor (FRScanner). Fedora 44's system python is newer — don't rely on it for these.
|
||||
- **JDK 21** (villager-logic-fix, Minecraft-Village-Warriors release target), **JDK 17**
|
||||
(native-angular android-host), **JDK 25** (Minecraft-Village-Warriors toolchain — Gradle can
|
||||
also auto-provision it). Gradle itself always via each repo's wrapper.
|
||||
- **.NET 10 SDK** (requester; also rebuilds the BG4 BepInEx plugin).
|
||||
- **Go** and **Rust** — present on the old machine (`~/go`, `~/.cargo`); no scanned project pins
|
||||
a version, so latest.
|
||||
|
||||
## Native builds — use a distrobox, not the host
|
||||
|
||||
Compilers and C library headers don't belong on the atomic host. One Fedora distrobox covers
|
||||
every native-build need the scan found:
|
||||
|
||||
```bash
|
||||
distrobox create dev --image registry.fedoraproject.org/fedora:44
|
||||
distrobox enter dev
|
||||
sudo dnf install -y gcc gcc-c++ make cmake pkgconf python3-devel \
|
||||
gtk4-devel \ # native-angular linux-host (CMake + GTK4)
|
||||
zbar \ # DVDPhotoMatic (pyzbar)
|
||||
libsndfile mediainfo-libs \ # FRScanner audio / movieMetaTagger pymediainfo
|
||||
rtl-sdr rtl-sdr-devel \ # FRScanner RTL-SDR + Cython builds
|
||||
mkvtoolnix ffmpeg-free \ # movieMetaTagger mkvpropedit; ffmpeg fallback
|
||||
python3-tkinter python3-dbus \ # denon-bluetooth GUI
|
||||
flashrom # BC250 BIOS flashing (CH347 over USB)
|
||||
```
|
||||
|
||||
Native node modules (kidstube's better-sqlite3, FFCardGame's bcrypt) build fine inside the
|
||||
distrobox too — or in their Docker builds, which is how they ship anyway.
|
||||
|
||||
## Host-level odds and ends
|
||||
|
||||
- **RTL-SDR udev rules** (FRScanner): the dongle permissions must live on the *host* —
|
||||
`dev-setup.sh` writes `/etc/udev/rules.d/20-rtlsdr.rules` (`/etc` is mutable and survives
|
||||
updates).
|
||||
- **ffmpeg on the host** (audioSticher, AIVoice host venv, encoderPro host runs): Bazzite
|
||||
ships ffmpeg — verify with `ffmpeg -version`; if a project needs full codecs beyond it,
|
||||
`brew install ffmpeg` wins on PATH.
|
||||
- **Pinned Godot binaries**: superBossMonster hardcodes `~/godot/Godot_v4.3-stable_linux.x86_64`
|
||||
and FFCardGame ships its own 4.2 binary. Keep the `~/godot/` directory from the old machine
|
||||
(plus export templates in `~/.local/share/godot/`); the Flatpak is only "current stable".
|
||||
- **gh CLI**: `brew install gh` (in `dev-setup.sh`) — used across projects.
|
||||
- **BlueBuild CLI** (BC250 and this repo): the installer one-liner in the README.
|
||||
- **API keys**: ANTHROPIC_API_KEY (FFCardGame tools, DVDPhotoMatic), TMDB/OMDB
|
||||
(movieScanner, nameFixer4000, DVDPhotoMatic), YouTube Data v3 (kidstube) — carried in
|
||||
per-project `.env` files; bring them over with your home directory.
|
||||
|
||||
## Per-project cheat sheet
|
||||
|
||||
| Project | Needs beyond the image |
|
||||
|---|---|
|
||||
| AIVoice | py3.12 venv (mise), ffmpeg, GPU containers (covered) |
|
||||
| AIVoices_HA, personal-landing, cardscraper, audioSticher, teamsTrick | nothing / stdlib python |
|
||||
| BC250 | BlueBuild CLI, flashrom (distrobox) |
|
||||
| BG4_UltraWide_fix | .NET 10, py3.12, Steam/Proton (covered) |
|
||||
| denon-bluetooth | distrobox tkinter+dbus, adb (covered) |
|
||||
| Docker-Registry-Browser | Node 18 |
|
||||
| DVDPhotoMatic | py3.12, zbar (distrobox), OpenSCAD (flatpak), webcam |
|
||||
| encoderPro, ispy, keyWord, movieScanner, nameFixer4000, serverTransfer | Docker (+GPU) only |
|
||||
| FFCardGame | Godot 4.2 binary, Node 20, python+anthropic |
|
||||
| FRScanner | py3.11+, rtl-sdr distrobox + host udev rules |
|
||||
| kidstube | Node 20 (+distrobox for native build outside Docker) |
|
||||
| Minecraft mods (×2) | JDK 21/25 via mise |
|
||||
| movieMetaTagger | py3.12, Node 18, mkvtoolnix/mediainfo (distrobox) |
|
||||
| native-angular | Node 20+, JDK 17, Android Studio (flatpak), GTK4 distrobox |
|
||||
| requester | .NET 10, Node 22, postgres via compose |
|
||||
| smartSpeaker | Docker (covered); Pi hardware is remote |
|
||||
| superBossMonster | Godot 4.3 binary + templates, ComfyUI in GPU container |
|
||||
| teamsTrick | X11 session note: KDE on Bazzite defaults to Wayland — run it in an X11 session or expect XTest to fail |
|
||||
Reference in New Issue
Block a user