# Brutus

> Brutus is a free, open-source (MIT) alarm clock for Android 8.0 and later. A ringing alarm only stops once you complete the challenges you chose for it: solve math problems, shake the phone, or scan a QR code you placed somewhere else in your home — in any combination, one after the other. Hardcore mode keeps the alarm at full volume while it rings; Ultra Hardcore mode re-rings 10 and 15 minutes later unless you walk 30 steps. It also has a world clock, stopwatch, timer and a home-screen widget, runs in English and German, requests no internet permission and has no ads or tracking. Distributed as a signed APK through GitHub Releases.

Everything below is also available without JavaScript: the page's HTML carries the current version and checksums, and `/` returns Markdown for `Accept: text/markdown`.

## Get the app

- [Newest release](https://brutus.celox.io/download): the file for your platform — 302 to the current GitHub release asset
- [APK](https://brutus.celox.io/download/android): Android 8.0+
- [Newest release as JSON](https://brutus.celox.io/latest.json): `version`, `published`, `notes`, and `assets[]` with `target`, `name`, `url`, `size` (bytes), `sha256`; refreshed every 15 minutes
- [All releases and notes](https://github.com/pepperonas/brutus/releases)

## Docs

- [Product page as Markdown](https://brutus.celox.io/index.md): features, install steps, verification, FAQ, with the current version and checksums filled in
- [Agent skill: get Brutus](https://brutus.celox.io/skills/get-brutus/SKILL.md): download, verify and install, step by step
- [Changelog](https://brutus.celox.io/changelog.md): Markdown, mirrored from GitHub every 15 minutes
- [README](https://github.com/pepperonas/brutus#readme)

## Install

1. One file for every phone with Android 8.0 or later — there is nothing to pick.
2. Open the file. Android asks once whether your browser may install apps — allow it.
3. If the alarm list shows a banner — exact alarms, battery optimization, full-screen alarm — tap it and flip the switch. Then test your wake-up chain with *Test wake modes now*.

## Verify

- SHA-256 of every file: `assets[].sha256` in [latest.json](https://brutus.celox.io/latest.json)
- Signing certificate SHA-256: `69d67a10a826cf4050da4b271af9b5ed500c962bfab07a8f8fe863e3d7600382`

## Features

- Challenges, not a button: Math (1–10 problems), shaking (10–100 shakes) and a QR scan. Enable one, two or all three per alarm — they run one after the other, and only then does *Stop alarm* appear.
- Hardcore mode: While the alarm rings, its volume stays at maximum and the volume keys do nothing. The moment it is dismissed, your phone behaves normally again.
- No going back to bed: Ultra Hardcore rings again 10 and 15 minutes after you dismiss it — unless you walk 30 steps with the phone. The follow-ups survive a reboot.
- Sounds made on the phone: Eleven alarm sounds are synthesized in real time — from klaxon, siren and fire alarm to a gentle chime — plus the system tone. Preview each one while you set the alarm.
- Sunrise and widget: An optional pre-alarm brightens the screen over the ten minutes before it rings. A home-screen widget shows the next alarm with a countdown.
- Reliable and offline: Exact alarms that ring in Doze and come back after a reboot, with banners when the system would block them. Brutus requests no internet permission — plus world clock, stopwatch and timer.

## Scope and limits

- Android only; not on Google Play — distributed as an APK through GitHub Releases.
- The QR challenge needs Google Play Services, which delivers the barcode model; math and shake work without it.
- Available in English and German only.
- Android offers no way to truly lock the volume: Hardcore mode snaps it back to maximum and swallows the volume keys while the alarm rings.

## Optional

- [Source code](https://github.com/pepperonas/brutus)
- [Licence (MIT)](https://github.com/pepperonas/brutus/blob/main/LICENSE)
- [Agent resource catalog](https://brutus.celox.io/.well-known/ai-catalog.json)
- [Author: Martin Pfeffer, celox.io](https://celox.io)