Skip to content

romankurnovskii/BrewMate

Repository files navigation

BrewMate

BrewMate - Homebrew GUI

BrewMate is a macOS GUI application that makes it easy to search for, install, and uninstall Homebrew casks. You can also see the top downloaded casks.

Includes third party apps + from awesome-brew

BrewMate Screenshot 1

Features

  • install/uninstall casks
  • brew update/upgrade
  • list local installed
  • top installs
  • show logs on install/uninstall
  • add 3rd party taps
  • handle apps required sudo/pass on install/uninstall

Prerequisites

Before you begin, ensure you have met the following requirements:

  • macOS: This package is designed to work on macOS. Ensure you are using a compatible version.
  • Homebrew: This package requires Homebrew to be installed on your system. Homebrew is a package manager for macOS that simplifies the installation of software. If you don't have Homebrew installed, you can install it by running the following command in your terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install

Option 1

  1. Download the latest DMG file from the releases page.
  2. Double-click the DMG file to open it.
  3. Drag the BrewMate app to your Applications folder.

Option 2

In terminal:

brew install romankurnovskii/awesome-brew/brewmate --cask --no-quarantine

Option 3

In terminal:

brew tap romankurnovskii/awesome-brew
brew update
brew install --cask --no-quarantine brewmate 

First time launch

  1. Navigate to your "Applications" folder.
  2. Find the app BrewMate and right-click on it.
  3. Select "Open" from the context menu.
  4. When the security warning appears, click "Open" to confirm that you want to open the app.
  5. The app will now launch.

Requirements

  • macOS 10.15 or later.

Development / Build

  1. Clone the repository: git clone https://github.com/romankurnovskii/BrewMate.git
  2. Install dependencies: npm install
  3. Build the app: npm run electron:build
  4. The built app will be located in the dist folder.
  5. For development run npm run electron:dev

Available Scripts in addition to the existing ones

npm run electron:dev

Runs the app in the development mode.

The app will reload if you make edits in the electron directory.
You will also see any lint errors in the console.

npm run electron:build

Builds the app package for production to the dist folder.

Your app is ready to be distributed!

License

BrewMate is licensed under the MIT License. See the LICENSE file for details.