> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darkbloom.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage your provider with the Darkbloom Mac app

> The native macOS menu bar app lets you start and stop your provider, monitor throughput, view earnings, configure scheduling, and enable idle detection.

The Darkbloom macOS app lives in your menu bar and gives you a native interface for managing your provider without touching the terminal. It wraps the same `darkbloom` CLI under the hood, so everything you can do in the app you can also do from the command line — the two are fully equivalent.

## Features

<CardGroup cols={2}>
  <Card title="One-click start and stop" icon="power-off">
    Start or stop your provider from the menu bar with a single click. No need to open a terminal.
  </Card>

  <Card title="Real-time throughput" icon="chart-line">
    See tokens per second and active request counts update live as your Mac serves inference requests.
  </Card>

  <Card title="Idle detection" icon="moon">
    The app monitors whether you are actively using your Mac. When it detects activity, it pauses the provider so inference does not compete with your own work. Serving resumes automatically when the Mac goes idle again.
  </Card>

  <Card title="Provider scheduling" icon="calendar">
    Set specific hours and days when your Mac should serve. Outside those windows, the provider disconnects and the backend shuts down to free GPU memory.
  </Card>

  <Card title="Earnings dashboard" icon="dollar-sign">
    View your balance and recent earnings history without leaving the app.
  </Card>

  <Card title="Auto-start at login" icon="play">
    Optionally start the provider automatically when you log in to your Mac, so your machine earns whenever it is on and idle.
  </Card>
</CardGroup>

## Accessing settings

Click the Darkbloom icon in the menu bar to open the status panel. From there, click **Settings** to access the full configuration view, where you can:

* Choose which model to serve
* Configure scheduling windows
* Enable or disable auto-start at login
* Enable or disable automatic updates

## Idle detection

Idle detection watches for keyboard, mouse, and other user activity signals from macOS. When you start using your Mac — opening applications, typing, moving the mouse — the provider pauses so the GPU is available for your own work. When your Mac goes idle again, the provider resumes automatically.

This happens transparently. You do not need to manually stop and start the provider around your work sessions.

<Note>
  Idle detection is separate from [scheduling](/provider/scheduling). Scheduling defines fixed time windows when the provider is allowed to run. Idle detection operates within those windows and further pauses serving when you are actively using the machine.
</Note>

## Earnings display

The menu bar panel shows your current balance and a summary of recent earnings. For a full breakdown with per-request detail and withdrawal options, use the web console at [darkbloom.dev](https://darkbloom.dev) or run `darkbloom earnings` in the terminal.

## Setup wizard

When you launch the app for the first time, a setup wizard walks you through:

1. Detecting your hardware
2. Downloading a model matched to your machine's memory
3. Linking your Darkbloom account
4. Starting the provider

If you have already installed and configured the provider via the CLI, the app connects to the existing configuration and launchd service automatically.