https://github.com/blackyhawky/clock
Customizable, privacy‑first, open-source clock app inspired by AOSP Clock
https://github.com/blackyhawky/clock
alarm analog-clock android android15 aosp-clock clock clock-java clockwidget digital-clock fdroid foss izzyondroid java material-design material-ui material3 screensaver stopwatch timer widget
Last synced: 7 days ago
JSON representation
Customizable, privacy‑first, open-source clock app inspired by AOSP Clock
- Host: GitHub
- URL: https://github.com/blackyhawky/clock
- Owner: BlackyHawky
- License: gpl-3.0
- Created: 2022-01-22T13:29:52.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2026-03-20T19:41:04.000Z (19 days ago)
- Last Synced: 2026-03-21T10:34:47.489Z (18 days ago)
- Topics: alarm, analog-clock, android, android15, aosp-clock, clock, clock-java, clockwidget, digital-clock, fdroid, foss, izzyondroid, java, material-design, material-ui, material3, screensaver, stopwatch, timer, widget
- Language: Java
- Homepage:
- Size: 68 MB
- Stars: 878
- Watchers: 9
- Forks: 52
- Open Issues: 50
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# 
Clock
**Clock** is a customizable, privacy‑first, open-source clock app inspired by AOSP Clock.
It combines modern design, powerful features, and transparency — giving you full control over your time.
# 📑 Table of Contents
- [Download](#-download)
- [Features](#-features)
- [Common Issues](#-common-issues)
- [Contributing](#-contributing)
- [License](#-license)
- [Screenshots](#-screenshots)
- [Credits](#-credits)
# 📥 Download
[
](https://github.com/BlackyHawky/Clock/releases)
[
](https://f-droid.org/packages/com.best.deskclock/)
[
](https://apt.izzysoft.de/fdroid/index/apk/com.best.deskclock/)
[
](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/BlackyHawky/Clock/releases)
[
](https://www.openapk.net/clock/com.best.deskclock/)
> [!NOTE]
> **Build variants:**
> - **Release:** Stable versions recommended for everyday use (available on all platforms above).
> - **Nightly:** Experimental builds with the latest changes, may be unstable (available on GitHub, and also on Obtainium if you enable _"Include prereleases"_).
> - **Debug:** Developer-oriented builds with extra logging and diagnostics (available only on GitHub).
>
> All variants (Release, Nightly, Debug) can be installed side by side without conflict.
# ✨ Features
### • ⏰ **Advanced alarms**
* Set alarms to a specific date
* Flip or shake to dismiss/postpone
* Use power or volume buttons to snooze/stop
* Swipe to delete, duplicate, or customize alarms
* Custom titles, backgrounds, and ringtones (including random playback)
### • 🎨 **Customization**
* Light, dark, or system theme
* AMOLED mode for deep blacks
* Digital or analog clock styles
* Customizable interface, screensaver, and widgets
* Dynamic colors for Android 12+
### • 🌍 **World clock**
* Display home time when abroad
* View time in multiple cities worldwide
### • ⏱️ **Timer & stopwatch**
* Built-in timer and stopwatch
* Share stopwatch results with contacts
### • ⚙️ **Extra features**
* Quick settings tiles (Android 7+)
* Backup & restore (except custom ringtones)
* Material Design UI
* Support for [Direct Boot](https://developer.android.com/privacy-and-security/direct-boot)
* Alarm support on some Snapdragon devices when powered off
* [Reproducible Builds](https://reproducible-builds.org/) for transparency
> [!NOTE]
> Some extra features may not work on certain devices:
> - **Direct Boot support**: see the discussion [here](https://github.com/BlackyHawky/Clock/issues/396).
> - **Power‑off alarm on Snapdragon devices**: may fail even if the _"com.qualcomm.qti.poweroffalarm"_ system app is present. See the discussion [here](https://github.com/BlackyHawky/Clock/issues/88).
# 🐞 Common Issues
* Device-specific issues may occur due to limited testing.
* On Android 14+ with HyperOS, the _"Full screen notification"_ permission may be revoked. Possible solution [here](https://github.com/BlackyHawky/Clock/discussions/303#discussioncomment-13407709).
* MIUI users may face problems due to aggressive battery optimizations.
* Please make sure that battery optimizations are disabled for the app before opening an issue.
> [!NOTE]
> I’m not an expert developer, so some problems may require community help to solve.
# 🤝 Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on reporting issues, translations, and code contributions.
Click here to see the translation status
[](https://translate.codeberg.org/engage/clock/)
# 📜 License
[](LICENSE)
Clock is licensed under **GNU General Public License v3.0 (GPLv3)**.
This strong copyleft license requires that any modifications or larger works using Clock must also be distributed under the same license, with complete source code available.
See the [LICENSE](LICENSE) file for full details.
> [!NOTE]
> Since Clock is based on **AOSP Clock**, which is licensed under **Apache License 2.0**, an additional [Apache 2.0](LICENSE-Apache-2.0) license file is provided in this repository.
# 📷 Screenshots
Click here to see screenshots
# 🏅 Credits
* 🖼️ **App icon** inspired by [LineageOS DeskClock](https://github.com/LineageOS/android_packages_apps_DeskClock), modified by [BlackyHawky](https://github.com/BlackyHawky)
* 💻 Code references and inspiration from:
* [LineageOS](https://github.com/LineageOS/android_packages_apps_DeskClock)
* [crDroid Android](https://github.com/crdroidandroid/android_packages_apps_DeskClock)
* 🌍 Translations provided by the community via [Weblate](https://translate.codeberg.org/projects/clock/)
* 🤝 Thanks to all [contributors](https://github.com/BlackyHawky/Clock/graphs/contributors) who help improve Clock