Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/romankurnovskii/brewmate
Homebrew GUI apps manager
https://github.com/romankurnovskii/brewmate
electron gui homebrew homebrew-cask react
Last synced: 2 days ago
JSON representation
Homebrew GUI apps manager
- Host: GitHub
- URL: https://github.com/romankurnovskii/brewmate
- Owner: romankurnovskii
- License: mit
- Created: 2023-03-13T20:40:19.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-05T09:43:53.000Z (about 2 months ago)
- Last Synced: 2025-01-12T02:17:22.755Z (9 days ago)
- Topics: electron, gui, homebrew, homebrew-cask, react
- Language: TypeScript
- Homepage: https://romankurnovskii.com/brewmate/
- Size: 28.8 MB
- Stars: 154
- Watchers: 6
- Forks: 28
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 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](https://github.com/romankurnovskii/homebrew-awesome-brew/)
## Features
- [x] install/uninstall casks
- [x] brew update/upgrade
- [x] list local installed
- [x] top installs
- [x] 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](https://brew.sh/) 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:
```sh
/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](https://github.com/romankurnovskii/BrewMate/releases).
2. Double-click the DMG file to open it.
3. Drag the BrewMate app to your Applications folder.
### Option 2
In terminal:
```sh
brew install romankurnovskii/awesome-brew/brewmate --cask --no-quarantine
```
### Option 3
In terminal:
```sh
brew tap romankurnovskii/awesome-brew
brew update
brew install --cask --no-quarantine brewmate
```
## First time launch
1. Navigate to your "Applications" folder.
1. Find the app `BrewMate` and right-click on it.
1. Select "Open" from the context menu.
1. When the security warning appears, click "Open" to confirm that you want to open the app.
1. 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](LICENSE) file for details.