mirror/android-brightness
1
0
Fork 0
mirror of https://github.com/crueber/android-brightness.git synced 2026-03-14 21:41:28 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description
28 commits 1 branch 4 tags 717 KiB
Find a file
Exact
Christopher Rueber b9996fd7d8 README.md update
2026-03-10 16:50:07 -05:00
.github/workflows fix: create workspace tmp dir required by Gradle on CI runners 2026-03-10 13:36:51 -05:00
app fix: add small right padding to 100% label 2026-03-10 14:08:02 -05:00
fastlane/metadata/android/en-US update image 2026-03-10 16:48:40 -05:00
gradle feat(phase-1): project scaffold — Gradle build, manifest, resources, stub classes 2026-03-10 11:54:42 -05:00
plans docs: add research and implementation plan for brightness widget 2026-03-10 11:42:51 -05:00
research docs: add research and implementation plan for brightness widget 2026-03-10 11:42:51 -05:00
.gitignore feat(phase-4): CI/CD — GitHub Actions release workflow and signing config 2026-03-10 12:01:19 -05:00
build.gradle.kts feat(phase-1): project scaffold — Gradle build, manifest, resources, stub classes 2026-03-10 11:54:42 -05:00
F-DROID.md fix: CI release build and add F-Droid publishing guide 2026-03-10 13:26:06 -05:00
gradle.properties feat(phase-1): project scaffold — Gradle build, manifest, resources, stub classes 2026-03-10 11:54:42 -05:00
gradlew feat(phase-1): project scaffold — Gradle build, manifest, resources, stub classes 2026-03-10 11:54:42 -05:00
LICENSE docs: add README and MIT license 2026-03-10 12:08:51 -05:00
README.md README.md update 2026-03-10 16:50:07 -05:00
RELEASING.md feat(phase-4): CI/CD — GitHub Actions release workflow and signing config 2026-03-10 12:01:19 -05:00
settings.gradle.kts fix: remove foojay plugin and add Android SDK setup to CI 2026-03-10 13:30:09 -05:00

README.md

Brightness Widget icon

Brightness Widget

A minimal Android home screen widget for controlling screen brightness with a single tap.
No bloat, no ads, no tracking — just a clean bar you tap to set brightness.

Widget close-up

Screenshots

Widget on home screen

Features

  • Tap to set brightness — 10-segment horizontal bar, tap any segment
  • Gamma-corrected — steps match the Quick Settings slider positions
  • Auto-brightness disabled automatically on tap so your setting sticks
  • Visual indicators — subtle brightness icon, 50% and 100% labels
  • Resizable — defaults to 4 columns wide, resize to any width
  • Lightweight — no background services, no internet permission, no data collection

Requirements

  • Android 8.0 (API 26) or newer
  • Modify System Settings permission (granted once through a simple setup screen)

Installation

Via Obtainium (recommended)

  1. Install Obtainium
  2. Tap + and enter: https://github.com/crueber/android-brightness
  3. Obtainium finds the latest release APK and notifies you of future updates

Direct APK download

Grab the latest signed APK from the Releases page.

Getting started

  1. Open Brightness Widget from your launcher
  2. Tap Open Settings to Grant Permission and enable the toggle
  3. Long-press your home screen > Widgets > drag Brightness Widget onto your home screen
  4. Tap any segment to set brightness — done!

Building from source

Prerequisites

  • JDK 17 — brew install --cask temurin@17
  • Android SDK — installed automatically by Android Studio, or set ANDROID_HOME manually

Build & install

# Build debug APK
JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home \
  ./gradlew assembleDebug

# Install to connected device
adb install -r app/build/outputs/apk/debug/app-debug.apk

Useful commands

Task Command
Debug APK ./gradlew assembleDebug
Release APK ./gradlew assembleRelease
Install to device ./gradlew installDebug
Lint ./gradlew lint
Clean ./gradlew clean

Customization

Edit BrightnessConfig.kt to adjust the number of segments:

const val BRIGHTNESS_STEPS = 10   // 10% increments (default)
const val BRIGHTNESS_STEPS = 20   // 5% increments, finer control

Remove and re-add the widget after changing.

Publishing

License

MIT — see LICENSE