Skip to content

Releases

CellAlertHook 1.0.0

CellAlertHook 1.0.0 Latest
Latest

Choose a tag to compare

View all tags
@dr2015 dr2015 released this 02 Nov 11:31
v1.0.0
c2d3c5c

First public release of CellAlertHook, an Android app that turns official Cell Broadcast emergency alerts into URL calls, with no server.

Test it on your own phone before you rely on it. It is not a certified warning system. Cell Broadcast is not signed, so a fake base station could trigger it. Nobody confirms an alert once the app is armed. A live alert reaching the app on a real phone and firing a real system has not been proven. See the README.

Downloads

File What it is
CellAlertHook-1.0.0.apk The app, signed
CellAlertHook-Viewer-1.0.0.apk Optional read-only tool that lists the alerts already stored on a phone. Used by tools/check-phone.js.

Install over USB, not by opening the file. Android does not give the Cell Broadcast permission to an APK opened from a file.

git clone https://github.com/dr2015/CellAlertHook.git
cd CellAlertHook
node tools/provision-device.js --apk CellAlertHook-1.0.0.apk

Then follow the setup guide.

The default phrases come from real alerts in one country. Anywhere else, set your own phrases, or nothing will fire.

What is in it

  • Calls an on URL for a threat phrase, and an off URL for an all-clear phrase.
  • Only alerts from Android's Cell Broadcast stack can fire. Screen text, notifications, test channels and simulations never do.
  • Works with the phone locked, and before the first unlock after a restart.
  • Optional active days and hours.
  • PIN lock, hidden and encrypted links, and protection from Force stop and Clear storage.
  • Check connection, which tests a server without sending a request.
  • Support for self-signed servers.
  • Preset builds with your links sealed inside the APK.

Tested

  • 190 unit tests and 38 tool tests pass.
  • On an Android 15 emulator, the signed release passed all 24 lock checks, and a debug build fired URLs from real PDUs through the telephony stack with the app locked.
  • Only one real phone has been used, and no live alert has fired a real system.

Checksums (SHA-256)

a51cad85c2105a4aac6e8d40e1cc66e2e43e606a82d991bc26bd06cda3e52926  CellAlertHook-1.0.0.apk
9304eb3d5504a95e690e3fb26e53f123d35acd1cfed17fa3bc27c8398fea436f  CellAlertHook-Viewer-1.0.0.apk
Assets 4
Loading