# TZGyn Homebrew Tap

Casks and command-line formulae for TZGyn apps. Hosted on Gitea — the full URL is required when tapping.

## Install

```bash
brew tap TZGyn/tap https://gitea.tzgyn.dev/TZGyn/homebrew-tap.git
brew trust TZGyn/tap
brew install --cask kapture
```

Homebrew may print an "Unsupported tap" warning for non-GitHub taps — it's
harmless.

## Formulae

### share

BitTorrent-style swarm file sharing CLI. A single binary serves as the client
(`send`/receive), the background daemon, and the relay:

```bash
brew install share
```

Seed a file into a new room (prints a room code):

```bash
share send file.txt
```

On the other machine, join that room — everyone in it both sends and receives:

```bash
share <code>
```

Releases carry macOS (Apple Silicon and Intel) and Linux builds; the formula
currently installs the Apple Silicon build.

## Casks

### kapture

Menu bar screenshot app with on-device OCR:

- Press **Cmd+Shift+S** anywhere — hover highlights a window (click to capture
  it with rounded corners), or drag for a region
- The screenshot opens in a window — drag on it to select text, **OCR Selection**
  to recognize just that area, **Get All Text** for the whole image
  (English, Chinese, Japanese, Korean); **Save PNG** and drawing annotations
  included
- Everything runs locally via Apple Vision; no network calls

### simpletopbar

Menu bar top bar that lists every running app, split into regular apps and
**Background Apps**:

- The Background Apps section is a dropdown — collapsed by default, and when
  expanded it shows a few apps at a time with the overflow hidden behind a
  **Show N more** row, so the list never overflows the panel
- Click a row to activate the app; right-click to Activate, Hide, or Quit

## Releases

Releases are published to each app's Gitea repository as zips attached to
version tags; the casks in this tap point at the latest release. Releases are
notarized (Developer ID + stapled ticket).