ShockAlarm

 

A powerfull app for controling OpenShock shockers and setting alarms with custom tones.

A lite web version can be found here

Features

ShockAlarm is a powerful tool for controlling your Shockers via OpenShock. It allows you to fully manage your shockers, logs, shares, hubs, and share links.

There is advanced functionaity like controling multiple shockers at the same time and specifying a random interval for intensity, duration and a delay (if you're into that).

It's fully material you themed just like the standard Android apps you're already used to and provides a responsive ui with a nice design.

Furthermore it fixes some layout flaws of the official OpenShock Frontend like having shared and own shockers in seperate tabs (which is annoying). On top it also has lots of info buttons you can press to get more insight on what something does.

Installation on Android

Through Obtainium (recommended as you get the updates the fastest)

1. Download Obtainium either via their website or FDroid
2. Add ShockAlarm by clicking here or putting github.com/ComputerElite/ShockAlarmApp as th app source

FDroid

1. Download FDroid
2. Search for ShockAlarm and install it. As easy as that!

GitHub

Install the apk file from the releases

Installation on Linux

Through the AUR

Use your favorite aur helper like paru or yay and install shock-alarm. link to aur

Screenshots

More images

Planned features

• (Un)Pausing of shockers
• Login with username/email and password
• Random delay
• Renaming of shockers (global)
• Viewing of logs
• Change sharing limits
• Create share codes
• Redeem share codes (untested)
• Adding of shockers
• Creation, editing and pairing of hubs
• Add option to repeat default shock/vibration... option for one minute (perhaps adjustable in settings). Needs reworking of the alarm stop feature
• Websocket controlling
• Alarm tones (ui implemented)
• Grouping of shockers
• Redo settings
• Random intensity and duration
• Safety warning
• Share link management
• Allow setting initial limits when adding a shocker
• Add ui to rename tones
• Better desktop support (keybinds)
• Better desktop support (layout)
• Better desktop support (dynamic layout)
• Show 3 point menu when 1 shocker is selected
• Share codes can't be claimed when the app is already open
• Allow toggling of the captive portal
• Add alarm renaming
• Finally code weekday scheduling for alarms
• Add changing of shocker type (and even hub and rfId)
• save last opened tab (and load it on start)
• Random shocking (specify random delay between shocks, min and max intensity/duration)
• Random shocking -> Add background task + notification (works without notification???)
• Fix alarms not sending controls when app is minimized (in testing)
• Live controls
• (Big controls mode)
• Web support (alarms not working)
• Linux support (alarms not working)

Planned settings

• Hide/unhiding of the delay option
• Slider instead of RangeSlider for delay

Development

This app is based on flutter and thus you need to first install flutter: https://docs.flutter.dev/get-started/install

Afterwards clone the repository and get all dependencies:

1. git clone https://github.com/ComputerElite/ShockAlarmApp
2. cd ShockAlarmApp
3. flutter pub get

Publishing

Steps for making a new release

1. Test functionality of app on Android, Web and Linux.
2. (when adding new packages) Test the Android build pipeline by manually triggering
3. Bump the version in pubspec.yaml and main.dart
4. Create a changelog at fastlane/metadata/android/en-US/changelogs in a file names <versioncode>.txt. It should be markdown formatted.
5. Create a new tag (or release) and push it to the repo. Actions will spin up to compile the binaries and add the previously created changelog to the release
6. (optional) Update the screenshots in fastlane/metadata/android/en-US/images/phoneScreenshots/ for FDroid and the ReadMe

Publishing on FDroid

FDroid will publish the update autonomously once a build cycle starts. The changelog we created earlier will be added to the FDroid page automatically