# 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.