53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
# Seth's Homebrew tap
|
||
|
||
Homebrew tap publishing macOS install for [sethLabels](https://git.sethpc.xyz/Seth/sethLabels).
|
||
|
||
## Install
|
||
|
||
```
|
||
brew tap seth/tap https://git.sethpc.xyz/Seth/homebrew-tap.git
|
||
brew install seth/tap/glabels-qt
|
||
```
|
||
|
||
The explicit URL form is required because Homebrew defaults to GitHub for tap
|
||
names. When this repo is mirrored to GitHub at the public-flip, the URL becomes
|
||
implicit and the tap command shortens to `brew tap seth/tap`.
|
||
|
||
### Launchpad / Spotlight integration (macOS)
|
||
|
||
`brew install` puts `glabels-qt` and `glabels-batch-qt` on your `$PATH` as CLI
|
||
binaries. To get a Launchpad icon (and Spotlight matches), copy the bundled
|
||
`.app` wrapper to `/Applications/`:
|
||
|
||
```
|
||
cp -R "$(brew --prefix glabels-qt)/glabels-qt.app" /Applications/
|
||
```
|
||
|
||
Re-run that one-liner after each `brew upgrade glabels-qt` so the wrapper
|
||
points at the latest version. (Brew formulas can't write to `/Applications/`
|
||
directly without elevation; the `cp` is the user's one-time step.)
|
||
|
||
## Formulae
|
||
|
||
| Formula | Description |
|
||
|---------|-------------|
|
||
| `glabels-qt` | [gLabels label designer (Qt/C++)](https://git.sethpc.xyz/Seth/sethLabels) — Seth's packaging fork of glabels-qt |
|
||
|
||
## How this works
|
||
|
||
`brew install seth/tap/glabels-qt` clones the sethLabels git tag pinned in
|
||
`Formula/glabels-qt.rb`, builds Qt6 + glabels-qt from source, and installs to
|
||
`/opt/homebrew/`. First install takes ~5–10 minutes. Subsequent
|
||
`brew upgrade glabels-qt` runs are fast (only the version-bumped formula
|
||
re-builds).
|
||
|
||
## Per-release maintenance
|
||
|
||
Each sethLabels release is one commit on this repo: bump `tag:` and `revision:`
|
||
in `Formula/glabels-qt.rb`. No other edits expected.
|
||
|
||
## Spec
|
||
|
||
Design rationale lives in the sethLabels repo:
|
||
[`sethlabels-docs/specs/2026-04-29-packaging-design.md`](https://git.sethpc.xyz/Seth/sethLabels/src/branch/main/sethlabels-docs/specs/2026-04-29-packaging-design.md) §D2, §7.
|