Skip to content

homebrew.md

Latest commit

 

History

History
95 lines (63 loc) · 2.29 KB

homebrew.md

File metadata and controls

95 lines (63 loc) · 2.29 KB
Raw

homebrew

the clean setup is:

  • app repo: kacy/chatbubbles
  • tap repo: kacy/homebrew-chatbubbles
  • formula path in the tap: Formula/chatbubbles.rb

the formula should install both chatbubbles and chatbubbles-cli from the tagged release tarball.

before you start

for a normal public tap, the release tarballs have to be publicly downloadable.

if kacy/chatbubbles stays private, you have two real options:

  • make the main repo or just its release artifacts public
  • publish the release tarballs somewhere public and point the formula there

the helper script in this repo assumes public github releases from kacy/chatbubbles.

create the tap repo

create a new public repo named:

kacy/homebrew-chatbubbles

then add:

Formula/chatbubbles.rb

update flow after each release

  1. cut a new release tag in kacy/chatbubbles
  2. wait for the release workflow to publish:
    • chatbubbles_<version>_darwin_arm64.tar.gz
    • chatbubbles_<version>_darwin_amd64.tar.gz
    • checksums.txt
  3. render the new formula from this repo:
make homebrew-formula VERSION=0.1.3

or:

./scripts/render-homebrew-formula.sh 0.1.3

that command pulls the published checksums.txt from the github release, so it matches the real release artifacts instead of a local rebuild.

if you ever need to override the checksums by hand, the helper still supports:

./scripts/render-homebrew-formula.sh 0.1.3 <arm64-sha256> <amd64-sha256>
  1. paste the output into Formula/chatbubbles.rb in the tap repo
  2. run the usual brew checks in the tap repo:
brew style Formula/chatbubbles.rb
brew install --formula ./Formula/chatbubbles.rb
  1. commit and push the tap update

install shape

the formula generated here does a few things on purpose:

  • depends on imsg
  • installs both chatbubbles and chatbubbles-cli
  • keeps tailscale as a manual prerequisite in caveats
  • leaves macOS permissions in caveats, since brew cannot grant them for you

expected user install

once the tap is live, the install path is:

brew tap kacy/chatbubbles
brew install kacy/chatbubbles/chatbubbles

that gets the binaries onto the machine, but the user still needs:

  • tailscale installed and signed in
  • Messages signed in
  • full disk access and automation permissions granted