# anishathalye/lumen

Magic auto brightness based on screen contents 💡

Repository: https://github.com/anishathalye/lumen
Canonical: https://ross.abutalabs.com/products/anishathalye-lumen
Homepage: https://anishathalye.com/lumen/
Language: Objective-C
License: GPL-3.0
License Family: copyleft
Last push: 2026-06-28T03:27:09+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 89, release rhythm 58, longevity 100
- inputs: {"age_days": 3686, "days_push": 66, "days_rel": 66, "gap_med": 375, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2424, forks 57 (observed 2026-08-28T04:06:50.728861+00:00)

## What it is
Lumen is a macOS menu bar application that automatically adjusts screen brightness based on the lightness of on-screen content rather than ambient light. It learns user preferences by monitoring manual brightness key adjustments.

## Use cases
- automatically adjust screen brightness based on screen contents
- stop terminal being too dark and browser too bright
- reduce eye strain when switching between dark and light windows
- adaptive brightness for macbook at night
- learn my brightness preferences automatically

## When to choose
- you're on macOS and switch between dark terminals and bright web pages
- you want brightness control that adapts to screen content instead of ambient light
- you prefer tools that learn preferences without manual configuration

## When to avoid
- you need external monitor brightness control natively
- you use f.lux or Night Shift, which are incompatible
- you're on Linux or Windows (use dux, wluma, or Luminance instead)

## Facets
- artifact type: application
- maturity: maintenance
- function: gui, image-processing, configuration-management
- domain: desktop-applications, developer-tools
- platform: -
- tags: screen-brightness, menu-bar-app, adaptive-brightness, objective-c, eye-comfort, macos, desktop

## Member repositories
- anishathalye/lumen (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:50.728861+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:31:50.953185+00:00, confidence not recorded.
  - readme: https://github.com/anishathalye/lumen (fetched 2026-08-28T04:06:50.728861+00:00, sha a15febfe0064)
  - homepage: https://anishathalye.com/lumen/ (fetched 2026-08-29T10:13:06.666750+00:00, sha d1a150d43ef7)
- Data as of 2026-08-30T08:39:29.467469+00:00.