Skip to content

lukemmtt/FAHMenuBar

Repository files navigation

FAH MenuBar – macOS Menubar Control for Folding@home

A lightweight, native macOS utility for monitoring and managing Folding@home directly from your menubar.

Not officially affiliated with Folding@home.

Screenshot 2025-07-28 at 3 27 07 PM


What is FAH MenuBar?

FAH MenuBar is a convenient macOS app that provides instant, native access to your Folding@home status and controls—no browser required. Track your contributions to disease research effortlessly from your Mac’s menubar.

Features

  • 📊 Real-time Monitoring: View live folding status with visual progress bars, percentages, and completion estimates directly from your menubar.
  • Quick Controls: Pause/resume/finish folding with a single click.
  • 🔧 Supports Multiple Resource Groups: Monitor and control all your configured Folding@home resource groups.
  • 🎨 Native macOS Design: Blends seamlessly with your macOS interface.
  • 🪶 Resource-Friendly: Minimal CPU and memory usage.
  • 🔄 Auto Updates: Keeps itself up-to-date automatically via Sparkle.
  • 🔒 Privacy & Security: No external data collection. No modification to your Folding@home installation.

Why Use FAH MenuBar?

Folding@home typically runs as a background process with a web-based interface. FAH MenuBar makes folding more accessible by providing:

  • Easy Monitoring: Instantly see your work unit's progress.
  • Convenience: No need to open browsers or remember web addresses.
  • Improved Engagement: Making folding visible encourages ongoing participation.

Getting Started

Requirements

  • macOS 14.0 (Sonoma) or later
  • Folding@home v8 client installed (Download here)
  • Intel or Apple Silicon Mac

Installation

Option 1: Pre-built App (Recommended)

  1. Download the latest release from the Releases page.
  2. Unzip and move FAH MenuBar.app to your Applications folder.
  3. Launch the app—it will appear in your menubar.

Option 2: Build from Source

git clone https://github.com/lukemmtt/FAHMenuBar.git
cd FAHMenuBar
open FAHMenuBar.xcworkspace
# Build and run via Xcode

Usage

  • Ensure Folding@home v8 is running.
  • Click the cube icon in your menubar to view status and controls.
  • Pause or resume folding directly from the dropdown.

How It Works

FAH MenuBar connects to Folding@home v8's official WebSocket API (from FAH's own open source client repository) to display real-time updates and manage your folding status.

Contributing

This is an open-source project—your input is welcome!

  • Report issues or request features via GitHub Issues.
  • Submit code improvements via Pull Requests.

License

MIT License – see LICENSE.

About Folding@home

Folding@home is a distributed computing project aiding scientists in understanding diseases by simulating protein folding. Learn more at foldingathome.org.


Enjoying FAH MenuBar? Star it on GitHub and share with fellow folders!

🤝 Official Adoption: This project is MIT licensed and open for official Folding@home adoption.

Created by Luke Memet.

About

macOS Menubar Control for Folding@home

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •