Skip to content

newnight/brew-services-menubar

 
 

Repository files navigation

BrewServicesMenubar

A powerful macOS menu bar application for managing Homebrew services and executing quick shell commands.

BrewServicesMenubar provides quick access to Homebrew services management and allows you to execute custom shell commands directly from the menu bar.

Features

  • Homebrew Services Management: Start, stop, and restart Homebrew services with a single click
  • Quick Commands: Execute frequently used shell commands instantly from the menu bar
  • Custom Commands: Run any shell command on-demand with a simple dialog
  • Configurable: Enable/disable quick commands and add your own custom commands
  • Safe Execution: Built-in timeout mechanism prevents commands from hanging your system
  • Keyboard Shortcuts: Use Option+Click to restart services, Cmd+, for preferences

Screenshot

Install

Manually

Download from the Releases page.

⚠️ You'll see a warning "BrewServicesMenubar" can't be opened because Apple cannot check it for malicious software. This is because I haven't paid Apple for a developer account.

More info about this malicious software warning.

Autostart

The program doesn't have an option to autostart itself, so you may want to open System Preferences -> Users & Groups -> Login Items and add the application to the list to have it start when you log in.

Usage

Homebrew Services

  • Start a specific service by clicking its name
  • Stop a specific running service (indicated with a tick) by clicking its name
  • Hold the Option key to allow a single service to be restarted
  • Use "Start all", "Stop all", or "Restart all" to manage all services at once

Quick Commands

  • Click on any enabled quick command to execute it instantly
  • Commands execute with a 30-second timeout to prevent hanging
  • Error alerts will appear if a command fails

Custom Commands

  • Select "Run Custom Command..." from the menu to execute any shell command
  • Enter your command and click "Run" to execute

Preferences

  • Press Cmd+, or select "Preferences..." to open the preferences window
  • Add new quick commands with custom names and shell commands
  • Enable/disable quick commands by toggling the checkbox
  • Remove unwanted commands with the "Remove" button

Configuration

Homebrew Path

By default looks for Homebrew at /usr/local/bin/brew and /opt/Homebrew/bin/brew. If this not correct for your setup, you can customize it using:

defaults write com.brewservicesmenubar.app brewExecutable /usr/local/bin/brew

Quick Commands

Quick commands are stored in UserDefaults and can be configured through the Preferences window. Default commands include:

  • Clear DNS Cache
  • Restart Finder
  • Show/Hide Hidden Files

Default Quick Commands

BrewServicesMenubar comes with several useful pre-configured commands:

  1. Clear DNS Cache: Flushes the DNS cache
  2. Restart Finder: Restarts the Finder process
  3. Show Hidden Files: Shows hidden files in Finder
  4. Hide Hidden Files: Hides hidden files in Finder

You can disable, modify, or remove these commands and add your own in Preferences.

Contributors

License

Icon is Beer by Enemen from the Noun Project.

About

An OS X menu item for starting and stopping homebrew services

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Swift 100.0%