Skip to content

Chainfire/HoleyLight

Repository files navigation

This is the sauce for the Holey Light app.

LICENSE is GPLv3.


Holey Light is a LED emulation app. It animates the edges of the camera cut-out (AKA punch-hole) as replacement for the sadly missing LED on many modern devices.

Additionally, it provides a notification display for when the screen is "off", replacing - or working in conjunction with - the Always-On Display feature. As this display is not around the camera hole, it is aptly named the Unholey Light.

While it was originally written for the Samsung Galaxy S10, the latest version at the time of writing supports all Samsung devices and several Google Pixels as well (as long as they have a camera hole inside the screen).

My personal test devices is the plain S10, if things are out of whack on the other models, let me know.

There is a link to XDA thread at the bottom, which is the place for discussing this app. There's also a Telegram channel where I sometimes even respond.

Features

  • Emulates notification LED
  • Four different display modes: Swirl, Blink, Pie, Unholey Light
  • Configurable animation size, position, and speed
  • Customizable color for each notification channel
  • Selects initial notification color by analyzing dominant color of app icon
  • Displays during screen "off", sub-1% battery use per hour in Unholey Light mode
  • Separate configuration modes for different power and screen states
  • Ability to mark notifications as seen based on various triggers
  • Respects Do-Not-Disturb and AOD schedules
  • Can hide AOD completely, partially, and/or keep the clock visible
  • Additional AOD Helper package for further battery usage reduction

Questions you could and/or should ask

Can I get this or that feature?

Maybe. I am building this for me, and you get to use it if you want. If I want your feature for myself, I may add it. If not, you could always pull request :)

The issue tracker is the TODO list, you might ask for it there.

Aren't there other apps that do this?

Yes there are. Holey Light was one of the first few, and certainly the first to exploit Samsung-specific power saving modes.

This was years ago now. Today there are probably a dozen apps that do the same thing with various amounts of success, compatibility, tracking, ads, and payment.

This one is mine, this one is free, and you get teh sauce.

I heard you built this entire thing just so you could call an app "Holey Light"?

That is absurd. Who would even do such a thing. Certainly not me. /s

Something something ETA?

No.

Battery use

Holey Light tries to use as little battery as possible. Various different modes use different amounts. The Unholey Light (which as the name implies, is not centered around the camera hole) uses least by staying on-screen without the CPU having to be awake.

See tech.md for a more in-depth description.

Rendering

Entire section moved to tech.md

Burn-in

Both the app and Android shift pixels around to reduce risk of burn-in.

See tech.md for a more in-depth description.

Freedom!

This app is 100% free, without ads, without tracking, but with GPLv3 sauce.

In-app purchases exist to donate if you are so inclined, this does not unlock additional features, change app behavior, or entitle you to anything.

Changelogs and release notes

See the changelog page.

Download

You can grab it from Google Play.

Alternatively, APKs are available from the APK directory, both for the main APK (which may become outdated here) and the AOD Helper package (which must stay updated because this is its main distribution channel).

Screenshots: Full options - 1 - 2 - 3 - 4 - 5 - 6 - 7

Feedback

It puts it in the XDA thread or in the GitHub issue tracker.

The workings of the app are quite intricate, so describe what is happening in minute detail.

TODO

You can find the TODO list in the issue tracker.

Translations

app/src/main/res/values/strings.xml is the master English file that needs to be translated.

I add strings in chronological orders, so you can just look at the bottom of the file for new entries.

Enjoy!

Or not.

About

Notification LED for Samsung/Pixel phones with in-screen camera cut-out (punch-hole)

Resources

License

Unknown, GPL-3.0 licenses found

Licenses found

Unknown
LICENSE
GPL-3.0
COPYING

Stars

Watchers

Forks

Packages

No packages published

Languages