mirror of
https://git.wetfence.xyz/RandyTheSilly/Trigalarm.git
synced 2026-10-26 19:09:56 -04:00
Begin v2 conversion
This commit is contained in:
1 parent
98f13a941d
commit
ce67fc3081
9 files changed
+95
-275
No files matched your search
@@ -6,28 +6,27 @@
|
||||
### Simple
|
||||
The alarm setter is only one page. You can only set one alarm. There is no snooze, there is no weekly schedule, and there is no way to disable the alarm (you'll always have one set - every day - like it or not).
|
||||
### Persistent
|
||||
The alarm goes off at least twice. The first time, you must solve a triangle to silence the alarm. The second time, you must do it again, but within a strict time limit (and no constant vibration). Fail to solve it within the time limit? The alarm is scheduled for a third time. This process continues until you solve within the time limit - this is to prove you managed to stay awake between alarms before allowing it to be fully disarmed. Even if you force-quit Trigalarm, it will shortly re-open to continue nagging you.
|
||||
The alarm cannot be disabled until the user solves their configured number of triangles. Each triangle comes with a time limit. Failure to solve a triangle within the time limit will demote the user to the previous triangle.
|
||||
|
||||
Guards are in place to prevent the user from force-quitting/resetting the alarm when an alarm is meant to be active.
|
||||
### Adaptable
|
||||
Trigalarm is meant to be adapted to your needs, and you should adjust its settings as you progress on your sleep journey. For example, as your trig skills improve, you may want to lower the time limit for the disarming alarm. You can also adjust the gap between alarms to account for how quickly you find yourself getting out of bed.
|
||||
|
||||
Perhaps the most unique, Trigalarm features optional [Pavlok](https://pavlok.com/pages/how-it-works) API integration to punish you via minor electrocution if you fall back asleep, force-quit the app, or attempt to overwrite your active alarm cycle.
|
||||
|
||||
## Learn the Lingo
|
||||
- Main alarm
|
||||
- The first alarm that goes off; comes with continuous vibration and does not disarm Trigalarm when solved. If Pavlok integration is enabled, this alarm can zap the user after a configurable amount of time if they do not respond. Solving this alarm will schedule an awareness alarm.
|
||||
- Awareness alarm
|
||||
- Any subsequent alarm after the main alarm has been solved; comes with only one brief vibration to indicate to the user it has opened. It has a configurable time limit it must be solved within to disarm Trigalarm. If the time limit expires, it will begin vibrations (and optionally Pavlok zaps), and once solved, it will schedule another awareness alarm.
|
||||
|
||||
Trigalarm is meant to be adapted to your needs with as little confusion as possible. There are three powerful settings:
|
||||
1. Number of triangles to solve in order to disarm the alarm
|
||||
2. The time limit for the final (fastest) triangle
|
||||
- Time limits for prior triangles are calculated automatically based on this one
|
||||
3. Pavlok integration (API key + zap intensity)
|
||||
- Punishes the user via mild electrocution if they...
|
||||
- ...take too long to respond to the first triangle
|
||||
- ...get demoted from a higher level triangle
|
||||
- ...force quit the app by holding the back button (the app re-opens and sends a zap)
|
||||
## Tips & Tricks
|
||||
- When you successfully disarm the alarm, you are prompted with the options to either exit and keep the same alarm time for tomorrow, or to select a new time. If choosing the latter, whatever time you select will assume you mean tomorrow. This avoids situations where you wake up at 6 on a Friday, set an alarm intended for 9 on Saturday, and end up with your wrist buzzing in three hours!
|
||||
- If you are stuck waiting for an awareness alarm or there is a bug that schedules an alarm incorrectly, there is a "Reset Alarm" button in the phone-side settings that will set your alarm to 00:00.
|
||||
- There is a "Reset Alarm" button in the phone-side settings to help if you make an unsolvable alarm configuration by mistake.
|
||||
|
||||
## Some Neat Stuff
|
||||
- The vibration pattern is randomized. It derives the length of the three pulses from the angles in the generated triangle. Neat!
|
||||
- Some of the alarm scheduling code was taken from [Gentle Wake](https://github.com/SeaPea/GentleWake). It seems trusted by the community, so... I stole it! The beauty of open source, no AI needed!
|
||||
- A custom font was made to satisfy the need for something that looks like LECO but is monospaced. The version I made contains only numbers, period, and colon, but if you want to build off of it, [it's public](https://git.wetfence.xyz/RandyTheSilly/pebble-misc/src/branch/main/fonts) and easy to modify!
|
||||
|
||||
## Future Goals (1.1 and beyond)
|
||||
- Full touch navigation
|
||||
- Draw measurements based on triangle side locations, rather than in fixed positions
|
||||
## Future Goals (2.1 and beyond)
|
||||
- Custom, self-hosted Pavlok API support (going to try some Bluetooth reverse engineering)
|
||||
Reference in new issue
Block a user