Skip to content

☕ A lightweight macOS utility that serves up a perfectly organized menubar. #caffeinated

License

Notifications You must be signed in to change notification settings

stacksjs/barista

Repository files navigation

Barista Logo

GitHub Actions Commitizen friendly macOS macOS Ventura+

Barista

Barista is a sleek, lightweight menu bar manager for macOS that helps you declutter your menu bar by hiding items you don't need to see all the time. Also, if you activate caffeinated-mode, your computer will not sleep or dim.

Stay caffeinated & craft pretty menu bars.

Features

  • 🔄 Menu Bar Manager Manage your menu bar with ease
  • Caffeinate Caffeinate your Mac to prevent it from sleeping (or dimming)
  • 🍎 Native macOS Experience Built with SwiftUI for a seamless Mac experience
  • ⚙️ Customizable Choose which items to hide and when
  • ⏱️ Auto-Hide Automatically hide items after a customizable delay
  • 🔑 Global Hotkey Toggle visibility with a keyboard shortcut
  • 🚀 Startup Launch Option to launch at login
  • 🌙 Always-Hidden Section Keep certain items permanently hidden
  • 🌐 RTL Support Full support for right-to-left languages

Installation

Homebrew

brew install --cask barista

Manual Download

  • Download latest version
  • Open and drag the app to the Applications folder
  • Launch Barista and drag the icon in your menu bar (hold CMD to move) to position it where you want

Usage

  1. Position the Icons: Hold (Command) and drag to arrange the Barista icons in your menu bar
  2. Hide Menu Items: Click the "vertical ellipsis" to hide items to the left of the divider
  3. Show Hidden Items: Click the "vertical ellipsis" again to reveal hidden items
  4. Access Settings: Right-click the "vertical ellipsis" to access preferences

Requirements

  • macOS Ventura (13.5) or later

For Developers

To release a new version with auto-update support:

  1. Make your changes and increase the version number
  2. Create a new tag and push it to GitHub
  3. GitHub Actions will automatically:
    • Build the application
    • Sign it for Sparkle updates
    • Create a release
    • Update the appcast.xml file

For more details on how to work with the auto-update system, see:

Troubleshooting

Build Issues

If you encounter build issues with dependencies like HotKey or Sparkle:

  1. Run the dependency setup script:

    ./scripts/setup-dependencies.sh
  2. For "No such module 'HotKey'" errors:

  3. For Sparkle framework issues:

    • Make sure the Copy Frameworks build phase is added to your Xcode project
    • Check that the Sparkle framework is properly copied to the app bundle

For complete troubleshooting steps, see Build Instructions.

Contributing

We welcome contributions! Please feel free to submit a Pull Request.

Credits

Many thanks to...

Sponsors

We would like to extend our thanks to the following sponsors for funding Stacks development. If you are interested in becoming a sponsor, please reach out to us.

License

The MIT License (MIT). Please see LICENSE for more information.

Made with 💙

About

☕ A lightweight macOS utility that serves up a perfectly organized menubar. #caffeinated

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project