Holey Light
Copyright © 2019-2022 – Chainfire\nTwitter: @ChainfireXDA\nSources: github.com/Chainfire/HoleyLight\nTap to visit XDA thread
https://forum.xda-developers.com/galaxy-s10/themes/app-holey-light-t3917675
Permissions needed
Holey Light to stop optimizing battery usage. This is required to keep the notification animation running.]]>
Holey Light with any device. This is required to be able to access notifications colors. It does not seem to matter which device you choose.
Please turn on Wi-Fi and Bluetooth before continuing; you can turn them off again afterwards.
If no popup comes up, try making sure Nearby device scanning is enabled, and pairing with a Bluetooth device.]]>
Holey Light notification access. This is required to be able to detect notifications.]]>
Installed services, and enable Holey Light. This is required to show the notification animation. If this doesn\'t work right, try rebooting.]]>
Holey Light: Test
Test notification, white LED
@string/app_name
Some permissions need to be updated. Tap to start.
Error
Holey Light cannot function while the notch is hidden. Uncheck Settings - Display - Full screen apps - Hide front camera.]]>
Holey Light does not appear to support your device. If you are using a Samsung/Google device please report this code to the XDA thread:
[ %s ]]]>
Help
Some basic advice
Holey Light piggybacks on Always On Display (AOD) (see Android Settings) to show notifications when the screen is off,
so AOD must be enabled for those modes to work.
AOD\'s Show Always, Tap to show and Show as scheduled modes are all supported. If you\'re not using Tap to show
mode, it is strongly advised to enable the schedule to turn off AOD while you are sleeping. This may help prevent
screen burn-in!
While a lot of effort has been put into reducing battery use as much as possible, Holey Light does use additionally battery
compared to only using AOD.
]]>
Enabled
Disabled
Charging: Screen on
Charging: Screen off
Battery: Screen on
Battery: Screen off
Operation
Screen on
Show notification light while the phone is in normal use
@string/charging_screen_off
Show notification light while the screen is off and charging
@string/battery_screen_off
Show notification light while the screen is off and on battery power, consuming additional power
Lockscreen
Show notification light on lockscreen; this may look strange if face unlock is enabled
Mark as seen: Pickup
Stationary for >10s before moving
@string/charging_screen_on
Makes sense when you usually charge your phone where you can see it
@string/charging_screen_off
Makes sense when you usually charge your phone where you can see it
@string/battery_screen_on
Consumes a little additional power
@string/battery_screen_off
Consumes significant additional power
Mark as seen: Lockscreen
On lockscreen
Each time the lockscreen is shown
After unlock
Each time the lockscreen is unlocked
Animation
Tune
Fine-tune size, position, and speed
Colors
Adjust per-package notification colors (use full black to hide)
Power saving animation
Use power saving animation instead of swirl, significantly reduces battery use
@string/charging_screen_on
@string/charging_screen_off
@string/battery_screen_on
@string/battery_screen_off
Chainfire
All my apps
View all my apps available on Google Play
Follow me on Twitter
Stay up to date with my developments
Changes take a full animation cycle to update!
Scale base: %.2fdp
Scale horizontal: %.2fdp
Shift vertical: %.2fdp
Shift horizontal: %.2fdp
Speed: %.1fx
Reset
Refresh
Adjust per-channel notification colors (use full black to hide)
Automatic AOD - WORK IN PROGRESS
Requires AOD Helper package. You need to configure an image without a clock on AOD first. Takes control of AOD.
Translation by:
Never
Currently active
Not currently active
Applications can have multiple channels. Each channel is listed individually here. Entries are added only once a new notification is seen. You cannot add entries manually, because channel names can\'t be known beforehand. Set an entry completely black to disable that notification.]]>
Adjust notification color per package and channel
Installed services, and enable Holey Light. This is required to be able to show notifications, and be able to tap into AOD. If this doesn\'t work right, try rebooting.]]>
@string/charging_screen_on
Show notification light while the screen is on and charging
@string/battery_screen_on
Show notification light while the screen is on and on battery power
When and how to display
Disabled
Do not show notifications
Swirl
Blink
Pie
Unholey Light
Camera
Screen center
Up to %.1f%% battery/hour
Below %.0f%% battery/hour
Mark as seen
Treat notifications as dismissed
When picked up
@string/settings_category_seen_pickup_description
Hide AOD
When the screen is off, hide Always On Display and show only our animation
Notice
Always On Display to be enabled.
Please go to Settings -> Lock screen -> Always On Display and set it to Show Always (or Tap to show if so desired).
Please also make sure its Screen orientation is set to Portrait.
You may also configure AOD\'s schedule and brightness.]]>
Always On Display.
Please go to Themes (AOD section), Download any (free) theme, and Apply it as Image only.
If you apply it as both Clock and image, the clock will eventually become visible.]]>
Open Android Settings
Open Galaxy Themes
Yes
No
Setup wizard
Helps you setup Holey Light
Holey Light! Let\'s get you setup.
A word of warning, this app requires some rather extreme permissions to be able to function. If you are not comfortable with that, you should not continue.
Note that the source code for this app is freely available for anyone to check out.
Several popups will follow, this will take a few minutes!]]>
1% and 5.5% battery per hour, depending on your setup.
This also requires the Always On Display feature to be enabled. If you don\'t like AOD, we can hide it later!
Do you want to show notifications while the screen is off?]]>
Swirl is a light that circles around the camera hole, and uses up to 5.5% battery per hour (worst case).
Blink is a blinking circle around the camera hole, and uses up to 3.5% battery per hour (worst case).
Unholy Light is a big circle in the middle of your screen. It isn\'t animated, but uses less than 1% battery per hour. This option always hides AOD, which is optional for the other two.]]>
Always On Display is a feature that can show various information on your screen while it is turned off, using less than 1% battery per hour. Some find it useful, others find it distracting
We can show AOD together with our notification light, or we can hide AOD and present you with just our notification light and an otherwise black screen.]]>
Show AOD
Hide AOD
Afterwards, there are more settings for you to explore on your own!]]>
Tap to change color, long-press for additional options.]]>
Copy color
Paste color
Edit hex value
%s for new entries]]>
%s entries]]>
Apply to all
black (disabled) entries?]]>
Disable
Full
Hide AOD fully
Partial
Keep charging information and fingerprint visible
If screen on
Ignore notifications arriving while the screen is on
Schedule
Always On Display
Settings -> Lock screen -> Always On Display -> Display mode.]]>
No schedule set
Respect Do Not Disturb mode
Do Not Disturb mode is enabled]]>
On timeout
Show notifications only for a set period
No timeout
%d seconds
%d minutes
%d hours
Unholey Light: Icons
Show notification icons inside the Unholey Light
Location may also need to be (temporarily) enabled for the popup to show.]]>
Debug
Dump logcat
Dump partial logcat to file and exit. A full adb logcat is always preferred!
Ignore notification color state (current: respect)]]>
Respect notification color state (current: ignore)]]>
Track separately
Brightness: Screen off
Settings -> Lock screen -> Always On Display -> Auto brightness.]]>
Hide AOD: Overlay linger time
Delay showing the lockscreen when hiding AOD, may prevent showing AOD on screen shortly
%d milliseconds
Black fill
Fill area between notification and camera with black
Save
Load
An error occurred saving color data
An error occurred loading color data
Load colors
Clear: clear current colors, then load all from file
Add: add colors from file, but keep current color on conflict
Overwrite: add colors from file, overwriting existing colors]]>
Clear
Add
Overwrite
Always On Display to be enabled.
Please go to Settings -> Display -> Advanced -> Lock screen and enable Always show time and info.]]>
This device does not support a display schedule
Holey Light does not officially support this device. If this device has a camera hole inside the display area, it might work. You will probably need to go to the Tune screen to make it look right.
If the app seems to work well, please report your tuning values and this code to the XDA thread:
[ %s ]]]>
Instructions
Ignore
Root
AOD Helper
AOD Helper package needs to be updated. All options using it have been disabled and need to be manually re-enabled after updating. Do you want instructions on how to update?]]>
AOD Helper package needs additional permissions. All options using it have been disabled and need to be manually re-enabled after granting permissions. Do you want instructions on how to update?
If your device is rooted, the problem may be solved for you if choose the Root option. You will get this popup again if it doesn\'t work.]]>
@string/aod_helper
Power users only, experimental
Install
AOD Helper is not currently installed. Tap for instructions.]]>
AOD Helper is not currently installed. Root or adb shell is required. Tap for instructions.]]>
Update
AOD Helper is installed but outdated. It needs to updated to be used again. Tap for instructions.]]>
AOD Helper is installed but does not have the required permissions. Tap for instructions.]]>
Automatic AOD control
Not compatible with AOD in Tap to show mode!]]>
Enabled and disable AOD automatically based on notification status. Reduces power usage when no notifications are active.
Maximize AOD brightness
While still limited to automatic brightness settings, this option usually does increase AOD brightness significantly.
Customization
Language
Default
MANUFACTURER DETECTION ERROR
Donate
Support my efforts, buy me a drink. Completely optional, does not unlock additional features.
Soda
Coffee
Beer
Wine
Scotch
Already purchased
PayPal: chainfire@chainfire.eu
Add thickness: %.2fdp
Not compatible with AOD in Tap to show mode! AOD settings may be locked while enabled.]]>
Unholey Light: Clock
Show AOD\'s clock (if configured)
Not compatible with AOD Helper.]]>
Known issues
AOD Helper works, some Holey Light options may behave differently than expected. For the best experience, use these settings:]]>
AOD Helper to be able to change AOD options in Android Settings]]>
AOD should not be in Tap to show mode in Android Settings]]>
Hide AOD option should be set to Full or Partial]]>
Unholey Light: Clock option should be turned off]]>
Conversation
not a battery state indicator!]]>
Tips
AOD: Image and theme
Unholey Light or Hide AOD is not working correctly, check your AOD background image or theme settings. Tap for instructions.]]>
AOD: Fingerprint icon
Settings -> Biometrics and Security -> Fingerprints -> Show icon when screen is off. It may appear even if Hide AOD is enabled!]]>
AOD: Battery status
Settings -> Battery and device care -> Battery -> More battery settings -> Show charging information.]]>
Always On Display. It cannot be detected if you already performed this step.]]>
image can be pre-applied for you, or you can pick your own image from the gallery. This option always include a clock.]]>
theme, go to Themes (AOD section), Download any (free) theme, and Apply it, optionally with a clock.]]>
with clock can interfere with the Hide AOD option.]]>
Image
Theme
Select debug mode
Disabled
Logging
Logging + Overlay
Default
(current)
Holey Light to manage phone calls. This is required to be able to detect when a phone call is active and prevent our overlay from interfering.
Important: If you just upgraded this app (or your phone), you must reboot your device after granting the permission or phone call detection will not work.]]>