← Back to BloomGauge

BloomGauge guide

Install BloomGauge, learn what each part does, and fix the messages you’re most likely to see. The same guide is in the app under More → Help.

Install

BloomGauge runs on macOS 14+. To earn with Darkbloom you need an Apple Silicon Mac with 48 GB+ memory and macOS 27 or later: from Darkbloom 0.9.18, new providers are only sent work on macOS 27+, and Darkbloom pays base rewards only to Macs on macOS 27 or later that Apple’s app check has approved. BloomGauge can set up Darkbloom for you with no Terminal needed; you sign in to Darkbloom in your browser. New to Darkbloom? See how to set up Darkbloom on a Mac.

Download BloomGauge 1.65.7 · 52.2 MB
  1. Open the disk image and drag BloomGauge Beta into Applications, then open it from there.
  2. Follow setup to connect your Darkbloom account. Your login stays on your Mac.
  3. If macOS blocks the install, don’t turn off Gatekeeper. Send us the exact message instead.
Installer SHA-256c70f1358f6d7ac62c8027ae9a74f621540145de74aea2994e454744674ee797e

Get started

BloomGauge sets up Darkbloom for you and keeps an eye on it.

  1. On a new Mac, press Agree and set up. BloomGauge installs Darkbloom, signs it in, downloads a model that fits this Mac and starts it. No Terminal needed. If Darkbloom is already on this Mac, press Open dashboard: nothing in Darkbloom changes.
  2. Darkbloom then checks the Mac before it sends paid work. That usually takes a few minutes, sometimes a few hours.
  3. Keep BloomGauge in Applications, keep the Mac awake and plugged in, and leave Open at Login on in the BloomGauge menu.
  4. A new Mac starts on Simple view; More → Settings → View adds the pages marked Full view.

Every data switch is in More → Settings → Privacy.

Earnings

Overview starts with what this Mac earns now.

  1. Now ¢/h. What this Mac earns per hour over the last 30 minutes, on the Fair, Good and Great you set under Model demand’s zones. On fire is above your Mac’s best hours; below Fair is Quiet. Until you set them, there are no words. Under it: “2.3× normal for 5 PM”.
  2. Totals. Today, Last 7 days, Balance (what’s in your Darkbloom account) and Earned in total.
  3. What pays now. Which model pays best on this Mac now, and what yours pays.
  4. Confirmed amounts come from your Darkbloom account. Estimates are marked “≈” and never count as earned. Earnings detail shows earnings over time; Days lists each day and Credits every credit.
  5. Reliability, last on Overview in Full view, shows how much of the time Darkbloom paid this Mac and what got in the way.
  6. To see several Macs together (Full view), add each in All Macs › Connect a Mac with its Phone access address. A Mac without Darkbloom can just watch: choose Watch my other Macs during setup. Add another Mac sends the download link.

Control

Control → Now shows what’s running and lets you change it. Pick a mode:

  1. Manual. You pick the models: tick as many as you like, then Confirm. BloomGauge warns when they won’t all fit in memory.
  2. Manager. BloomGauge runs the model expected to pay most here and recovers by itself. It switches only when another clearly pays more for 15 minutes. Once a day at most, it may try an unproven model for an hour (Control → Now → Settings).
  3. Autopilot. Darkbloom manages which of this Mac’s models are loaded. Join or leave it here.
  4. Tap a mode to see its options, then Confirm; nothing changes before that. Manager: Run is Recommended, or a model you choose that it keeps. Manual: tick models, then Run for and Then. End trial or End trip ends it early.
  5. Manager Switching Rules (Full view): Off (the default) or Custom rules. Off: the Manager runs Recommended alone.
  6. To add your own rules, open Control → Manager Switching Rules, set a model to Allowed and choose Switch at and Back below: the Load where it switches and comes back. A trip comes back to the Manager’s model. Manager history lists every move and why.
  7. After 12+ minutes on one request, the status says Working on a long request (Looks stuck if it hung), and Restart Darkbloom offers Restart now (unpaid).

Analysis

Analysis shows each model’s Load: requests per Mac serving it right now.

  1. Models shows which model pays best now and at each Load. Network shows demand over the day and week. Activity (Full view) shows what reached this Mac. Load is often shown against usual for this hour (“2.1× usual”). High load isn’t always better pay: more Macs join, and the load per Mac drops.

More

Settings, This Mac and Help, and your phone.

  1. To check in from your phone, press Set up on your phone on Overview. Private link: view only, nothing to install. Tailscale: the full app with controls; install it on the Mac and phone with one account, then choose Enable phone access in More → Settings and scan the QR code.
  2. More → Settings → Notifications chooses which alerts reach the Mac and your phone, with Demand watch and offline notices.

States you’ll see

Each Mac shows one status; hover or tap for why.

  1. Working on a request · Serving · Waiting for paid jobs · Loading · Switching · Stopped (by you, by BloomGauge or for an update) · Offline · Can't reach (All Macs can’t reach that Mac) · Not earning, with a short reason.
  2. For the story behind Not earning, open More → Why not earning? It names the first thing Darkbloom checks before it pays that isn’t OK, and whether it’s on your Mac or Darkbloom’s side.

Updates

BloomGauge updates itself when you’re away or not using it, never during a model switch.

  1. Check for updates and Update BloomGauge automatically are in More → Help. When an update brings something new, What’s new on Overview says what. Darkbloom updates itself separately.
  2. Reliability (Overview, Full view) shows how long its updates took.

Something wrong?

Try Troubleshooting in More → Help first.

  1. Then use Report a problem. It sends the app version, Mac chip and memory size, and connection and Manager status codes, never earnings, account details, model names or logs. Add a note if you like, or Ask in Slack.
  2. Export my data (More → Help) saves daily earnings by model as a CSV.
  3. To send reports without being asked, turn on Send problem reports automatically in More → Settings → Privacy.

Keep BloomGauge up to date

  1. BloomGauge installs updates by itself while you’re away from the Mac. You can turn this off in More → Help.
  2. To check now, choose Check for Updates… in the BloomGauge menu, or open More → Help → App updates.
  3. Updates keep your history and settings. They never turn the Manager on or resume a plan you paused, and they never install during a model switch or warm-up.

Arrange your dashboard

  1. On Earnings, choose Edit layout to move, hide or restore cards (on the Mac you can also resize them), then Save layout.
  2. Phone and desktop layouts are saved separately in each browser.

Optional usage sharing

  1. Usage sharing is off unless you turn it on, from the “Help shape BloomGauge.” card that appears once on Overview after setup, or with Share beta usage reports in More → Settings → Privacy (from beta 57; earlier versions: More → About BloomGauge → Help improve BloomGauge).
  2. It sends coarse hardware and daily feature activity, never earnings or account details. Every feature works without it, and you can turn it off and ask for deletion there.

Troubleshooting

Find the message you see, then try the fixes in order.

Darkbloom needs setup, or Provider offline on a new Mac

Darkbloom isn’t installed, signed in or started on this Mac yet, so there is nothing to earn with.

  1. Open Overview and press Agree and set up. BloomGauge installs Darkbloom, signs it in, downloads a model that fits this Mac and starts it. Each step ticks by itself.
  2. If BloomGauge can’t set it up (for example a developer build of Darkbloom), install Darkbloom from darkbloom.dev, then reopen BloomGauge.
  3. Darkbloom then approves the Mac before it sends paid work: usually a few minutes, sometimes a few hours. The card goes away once the Mac is serving.

No Darkbloom login found, or Login expired

BloomGauge reads earnings with the login Darkbloom saves on this Mac, and it is missing or expired.

  1. On the Mac, press Sign in to Darkbloom in the Earnings notice on Overview. Your browser opens: sign in, check that it shows the code BloomGauge shows, and approve this Mac. No Terminal needed.
  2. BloomGauge then restarts Darkbloom so it uses the new login (or starts it, unless you stopped it), and notices the sign-in by itself, usually within seconds and always within a minute.
  3. On the phone, the notice says to do this on the Mac.

Earning stopped after unplugging, closing the lid or a restart

A sleeping Mac can’t earn. On battery, the Mac runs only until the battery is nearly empty, then sleeps. Closing the lid puts it to sleep, even when plugged in, unless an external display is connected. After a restart, it waits for your login when FileVault is on or automatic login is off.

  1. Keep the Mac plugged in while it serves, with the lid open or an external display connected.
  2. After a restart, such as a macOS update, log in so Darkbloom can start again.
  3. Power alerts (More → Settings → Notifications) tell you when this Mac has earned on battery for 2 minutes, and at 30% and 15%.

Getting ready: waiting for a fresh match between this Mac and Darkbloom’s provider list

Before switching models, BloomGauge confirms this Mac appears in Darkbloom’s public provider list. Right after a restart, or while Darkbloom reconnects, the Mac can be missing for a few minutes.

  1. Make sure Darkbloom is running and online: Overview shows Serving or Waiting for paid jobs, not Stopped.
  2. Wait a few minutes, then choose Try turning on again.
  3. If it keeps timing out, choose Manual, restart the current model, wait until it shows Serving, then choose Manager again.

Model switching waits while the Mac is on battery power

On battery, BloomGauge holds off optional moves (trips, trials and automatic tests), because loading a model is heavy work. Restores, your own picks and switching a running model still happen.

  1. Plug in the Mac. Waiting moves continue on their own.

A large model won’t load, or needs more memory

macOS keeps the last model’s files in its file cache, and Darkbloom counts that memory as in use.

  1. Give BloomGauge permission to clear the file cache: open Model & service details on Control → Now, choose Enable cache cleanup and approve with your Mac password. It allows only the purge command, with no options.
  2. With permission, BloomGauge clears the cache before every switch, and the Manager counts that memory when it checks whether a larger model fits.
  3. Close memory-heavy apps if it still says more memory is needed.

Switching waits because the Mac is hot

BloomGauge pauses switches while temperatures are high to avoid throttling.

  1. Leave it be; it resumes when the Mac cools. Make sure vents are not blocked.

Numbers say stale or reconnecting after sleep

Nothing is collected while the Mac sleeps. BloomGauge labels older readings instead of showing them as new.

  1. Wait a minute after waking for fresh readings.
  2. To avoid gaps, keep the Mac awake while it serves.

The phone page won’t load

The phone reaches your Mac through its private link or Tailscale, and only while the Mac is awake.

  1. With Tailscale, check it is connected on both devices with the same account.
  2. Open More → Settings on the Mac and confirm the private link or phone access is on.
  3. Keep the Mac awake and online.

Is it fully automatic?

The Manager keeps your model loaded and restarts Darkbloom if it stalls.

  1. Yes. It runs the recommended model and now and then tries a new one for an hour; Custom rules in Control → Manager Switching Rules add switches on load.

Something else

Anything not listed here.

  1. Open More → Why not earning? It names the first thing Darkbloom checks that isn’t OK.
  2. Send a report from More → Help, or email support@bloomgauge.io.

Problems with Darkbloom itself (no jobs, a drained provider, memory errors)? See Darkbloom help.

Still stuck? Contact Andrew or send a report from the app. See the changelog for what changed in each release. Beta testers can also download the checklist and feedback templates.