Make a DMG, and cut the manual to a short guide for DMG users #19

Merged

erdoar merged 1 commit from claude/dmg-and-short-manual into main

2026-10-10 16:58:37 +00:00

erdoar commented

2026-10-10 05:13:08 +00:00

(Migrated from github.com)

Stacked on erdoar/plug#18. Merge #14 → #15 → #16 → #17 → #18 first.

Summary

scripts/make-dmg.sh: runs scripts/bundle.sh, then packs Plug.app plus an Applications shortcut into build/Plug-<version>.dmg (compressed, volume named "Plug "), using hdiutil. The version comes from the built app's Info.plist.
MANUAL.md → a one-page guide for DMG users (about 75 lines, down from 250). It covers:
- install and first open (right-click > Open, because the app isn't notarized), and the permission prompt;
- play, input, output, effects, drawer, master and tack, MIDI Learn, presets;
- Dock and menu bar controls, help and updates;
- what to check if there's no sound.
It no longer mentions GitHub, git, building or file locations. Web/manual.html is regenerated, and Help > Plug Help shows the same guide.
Check for Updates messages are written for DMG users. "Newer" says to download the new disk image and drag Plug onto Applications. The no-release and errors cases offer the download page (the releases page), with no git or GitHub wording.
README release steps now use the DMG, and note that the app isn't notarized (that needs an Apple Developer account).

Tested

bash -n passes for the DMG script. The guide and its web page contain no GitHub, git, Swift or build references. The Swift files pass a syntax-only parse.
The DMG script hasn't run. hdiutil exists only on macOS.

To test on the Mac

Quit Plug, then run scripts/make-dmg.sh. Expect Built build/Plug-0.1.0.dmg.
Open the DMG. It should show Plug and an Applications shortcut. Drag Plug across, then open it from Applications.
Help > Plug Help should show the short guide.

🤖 Generated with Claude Code

https://claude.ai/code/session_011C96TJ2L7nzVMFTH7raNu5

Generated by Claude Code

Stacked on erdoar/plug#18. Merge #14 → #15 → #16 → #17 → #18 first. ## Summary - **`scripts/make-dmg.sh`:** runs `scripts/bundle.sh`, then packs `Plug.app` plus an **Applications** shortcut into `build/Plug-<version>.dmg` (compressed, volume named "Plug <version>"), using `hdiutil`. The version comes from the built app's Info.plist. - **`MANUAL.md` → a one-page guide for DMG users** (about 75 lines, down from 250). It covers: - install and first open (right-click > Open, because the app isn't notarized), and the permission prompt; - play, input, output, effects, drawer, master and tack, MIDI Learn, presets; - Dock and menu bar controls, help and updates; - what to check if there's no sound. It no longer mentions GitHub, git, building or file locations. `Web/manual.html` is regenerated, and Help > Plug Help shows the same guide. - **Check for Updates messages** are written for DMG users. "Newer" says to download the new disk image and drag Plug onto Applications. The no-release and errors cases offer the download page (the releases page), with no git or GitHub wording. - **README release steps** now use the DMG, and note that the app isn't notarized (that needs an Apple Developer account). ## Tested - `bash -n` passes for the DMG script. The guide and its web page contain no GitHub, git, Swift or build references. The Swift files pass a syntax-only parse. - **The DMG script hasn't run.** `hdiutil` exists only on macOS. ## To test on the Mac 1. Quit Plug, then run `scripts/make-dmg.sh`. Expect `Built build/Plug-0.1.0.dmg`. 2. Open the DMG. It should show Plug and an Applications shortcut. Drag Plug across, then open it from Applications. 3. Help > Plug Help should show the short guide. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_011C96TJ2L7nzVMFTH7raNu5 --- _Generated by [Claude Code](https://claude.ai/code/session_011C96TJ2L7nzVMFTH7raNu5)_