Home

Hourglass Tracker for OBS

First off, thank you so much for showing interest towards my Hourglass Tracker, much appreciated!

You can display the faction you are currently representing and show your streaks, total sinks and rank for each faction. The streaks and ranks are controlled via bot commands or Stream Deck.

You can use this tracker to display your lifetime dive streaks and sinks, or reset the numbers for each stream to display them on a per-stream basis.

This community has been so amazing to me and I just want to give back!

Setup time: 15 minutes

1. Adding the browser source to your OBS scene

This account is for testing purposes only, so don't use it live on stream! The test account is open for everyone, so anyone can alter the numbers at anytime.
If you decide you want to use the tracker, contact me on Discord so I can set up your personal account.
Click the source URL to copy it to the clipboard

The compact size increases the font size of "Current Streak", "Highest Streak" and "Total Sinks". Perfect if you plan to have a small overlay, while still keeping these texts readable.

Size Source Size Setting Browser Source URL
Normal Width: 1500, Height: 200 https://api.solkku.com/hourglass/obs.php?name=test&token=token
Compact Width: 1500, Height: 200 https://api.solkku.com/hourglass/obs.php?name=test&token=token&sizing=Compact

After adding it, you should be able to see the tracker in OBS. You can play around with size and positioning by dragging the source around in OBS.

Note: The Hourglass Tracker refreshes every second. So after using commands, it takes a few seconds to update on screen.

2. Bot commands

This account is for testing purposes only, so don't use it live on stream! The test account is open for everyone, so anyone can alter the numbers at anytime.
If you decide you want to use the tracker, contact me on Discord so I can set up your personal account.

Next we need to setup bot commands for you or your mods to use in chat or in Discord (if your bot supports Discord commands). You can of course allow your VIPs to do it too - userlevel is up to you.

You can name the commands whatever you like, whatever makes sense to you.

Note: These commands will only affect the faction you are currently representing!
If you want to feed the tracker your lifetime highest streak and total sinks, or update the numbers after diving off stream, use the !updatestreaks command.
Nightbot
Command Message Userlevel Usage Response in chat
!switchfaction $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&action=SwitchFaction) Moderator !switchfaction
Switches between Athena and Reaper on screen.		 /me Switched to [athena] OR [reaper]!
!addstreak $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreak) Moderator !addstreak
Adds 1 to current and total, and to highest if needed.		 /me Added one to current streak and rival sinks!
!removestreak $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreak) Moderator !removestreak
Removes 1 from current streak and total sinks.		 /me Removed one from current streak and rival sinks!
!resetstreak $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&action=ResetStreak) Moderator !resetstreak
Resets current streak to 0.		 /me Current [athena] OR [reaper] streak was reset!
!resethourglass $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&action=ResetTracker) Moderator !resethourglass
Resets everything to 0 (not rank), for per-stream usage.		 /me The Hourglass Tracker was reset!
!factionrank $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&updaterank=$(1)) Moderator !factionrank X
Update rank of the faction you are representing.		 /me [athena] OR [reaper] rank updated to X!
!updatestreaks $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&updatenumbers=$(1),$(2),$(3)) Moderator !updatestreaks X Y Z
Updates current, highest and total in one command.		 /me The Hourglass Tracker numbers were updated!
!peek $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&action=Peek) Moderator !peek
Shows the other faction's stats for 15 seconds.		 /me Peeking into [athena] OR [reaper] stats...
!togglehourglass $(urlfetch https://api.solkku.com/hourglass/?name=test&token=token&action=ToggleHourglass) Moderator !togglehourglass /me Showing OR Hiding the Hourglass Tracker!
StreamLabs Chatbot
Note: Because of ChatBot's limitations, we can't have one add command work both ways. All add commands are separated (to either add single or multiple items), use the ones you need.
Command Message Userlevel Usage Response in chat
!switchfaction $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=SwitchFaction) Moderator !switchfaction
Switches between Athena and Reaper on screen.		 /me Switched to [athena] OR [reaper]!
!addstreak $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreak) Moderator !addstreak
Adds 1 to current and total, and to highest if needed.		 /me Added one to current streak and rival sinks!
!addstreaksf $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreakSF) Moderator !addstreaksf
Adds 1 to current streak, not total sinks.
USED FOR SAME FACTION BATTLES 		/me Added one to current streak (same faction battle)!
!removestreak $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreak) Moderator !removestreak
Removes 1 from current streak and total sinks.		 /me Removed one from current streak and rival sinks!
!removestreaksf $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreakSF) Moderator !removestreaksf
Removes 1 from current streak, not total sinks.
USED FOR SAME FACTION BATTLES 		/me Removed one from current streak (same faction battle)!
!resetstreak $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=ResetStreak) Moderator !resetstreak
Resets current streak to 0.		 /me Current [athena] OR [reaper] streak was reset!
!resethourglass $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=ResetTracker) Moderator !resethourglass
Resets everything to 0 (not rank), for per-stream usage.		 /me The Hourglass Tracker was reset!
!factionrank $readapi(https://api.solkku.com/hourglass/?name=test&token=token&updaterank=$num1) Moderator !factionrank X
Update rank of the faction you are representing.		 /me [athena] OR [reaper] rank updated to X!
!updatestreaks $readapi(https://api.solkku.com/hourglass/?name=test&token=token&updatenumbers=$num1,$num2,$num3) Moderator !updatestreaks X Y Z
Updates current, highest and total in one command.		 /me The Hourglass Tracker numbers were updated!
!peek $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=Peek) Moderator !peek
Shows the other faction's stats for 15 seconds.		 /me Peeking into [athena] OR [reaper] stats...
!togglehourglass $readapi(https://api.solkku.com/hourglass/?name=test&token=token&action=ToggleHourglass) Moderator !togglehourglass /me Showing OR Hiding the Hourglass Tracker!
StreamLabs CloudBot
Note: Because of CloudBot's limitations, we can't have one add command work both ways. All add commands are separated (to either add single or multiple items), use the ones you need.
Command Message Userlevel Usage Response in chat
!switchfaction {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=SwitchFaction} Moderator !switchfaction
Switches between Athena and Reaper on screen.		 /me Switched to [athena] OR [reaper]!
!addstreak {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreak} Moderator !addstreak
Adds 1 to current and total, and to highest if needed.		 /me Added one to current streak and rival sinks!
!addstreaksf {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreakSF} Moderator !addstreaksf
Adds 1 to current streak, not total sinks.
USED FOR SAME FACTION BATTLES 		/me Added one to current streak (same faction battle)!
!removestreak {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreak} Moderator !removestreak
Removes 1 from current streak and total sinks.		 /me Removed one from current streak and rival sinks!
!removestreaksf {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreakSF} Moderator !removestreaksf
Removes 1 from current streak, not total sinks.
USED FOR SAME FACTION BATTLES 		/me Removed one from current streak (same faction battle)!
!resetstreak {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=ResetStreak} Moderator !resetstreak
Resets current streak to 0.		 /me Current [athena] OR [reaper] streak was reset!
!resethourglass {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=ResetTracker} Moderator !resethourglass
Resets everything to 0 (not rank), for per-stream usage.		 /me The Hourglass Tracker was reset!
!factionrank {readapi.https://api.solkku.com/hourglass/?name=test&token=token&updaterank={1}} Moderator !factionrank X
Update rank of the faction you are representing.		 /me [athena] OR [reaper] rank updated to X!
!updatestreaks {readapi.https://api.solkku.com/hourglass/?name=test&token=token&updatenumbers=${1},${2},${3}} Moderator !updatestreaks X Y Z
Updates current, highest and total in one command.		 /me The Hourglass Tracker numbers were updated!
!peek {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=Peek} Moderator !peek
Shows the other faction's stats for 15 seconds.		 /me Peeking into [athena] OR [reaper] stats...
!togglehourglass {readapi.https://api.solkku.com/hourglass/?name=test&token=token&action=ToggleHourglass} Moderator !togglehourglass /me Showing OR Hiding the Hourglass Tracker!
StreamElements Bot
Command Message Userlevel Usage Response in chat
!switchfaction ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=SwitchFaction} Moderator !switchfaction
Switches between Athena and Reaper on screen.		 /me Switched to [athena] OR [reaper]!
!addstreak ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreak} Moderator !addstreak
Adds 1 to current and total, and to highest if needed.		 /me Added one to current streak and rival sinks!
!addstreaksf ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreakSF} Moderator !addstreaksf
Adds 1 to current streak, not total sinks.
USED FOR SAME FACTION BATTLES 		/me Added one to current streak (same faction battle)!
!removestreak ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreak} Moderator !removestreak
Removes 1 from current streak and total sinks.		 /me Removed one from current streak and rival sinks!
!removestreaksf ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreakSF} Moderator !removestreaksf
Removes 1 from current streak, not total sinks.
USED FOR SAME FACTION BATTLES 		/me Removed one from current streak (same faction battle)!
!resetstreak ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=ResetStreak} Moderator !resetstreak
Resets current streak to 0.		 /me Current [athena] OR [reaper] streak was reset!
!resethourglass ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=ResetTracker} Moderator !resethourglass
Resets everything to 0 (not rank), for per-stream usage.		 /me The Hourglass Tracker was reset!
!factionrank ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&updaterank=${1|1}} Moderator !factionrank X
Update rank of the faction you are representing.		 /me [athena] OR [reaper] rank updated to X!
!updatestreaks ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&updatenumbers=${1|1},${2|2},${3|3}} Moderator !updatestreaks X Y Z
Updates current, highest and total in one command.		 /me The Hourglass Tracker numbers were updated!
!peek ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=Peek} Moderator !peek
Shows the other faction's stats for 15 seconds.		 /me Peeking into [athena] OR [reaper] stats...
!togglehourglass ${customapi.https://api.solkku.com/hourglass/?name=test&token=token&action=ToggleHourglass} Moderator !togglehourglass /me Showing OR Hiding the Hourglass Tracker!
Stream Deck
Parts of the Hourglass Tracker can be easier to maintain with a press of a button on Stream Deck. Below you can find actions suited for Stream Deck, but of course not all are needed - use the ones you want.
Faction ranks need to be added as commands, so use the bot of your choice for that.
Important: Remember to check the "Access in background" / "GET request in background" option in the Stream Deck software when adding each one!
Button Action Usage URL
Switch Faction Switches between Athena and Reaper on screen. https://api.solkku.com/hourglass/?name=test&token=token&action=SwitchFaction
Add Streak Adds 1 to current and rival sinks, and to highest if needed. https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreak
Add Streak (same faction) Adds 1 to current streak, and to highest if needed.
USED FOR SAME FACTION BATTLES 		https://api.solkku.com/hourglass/?name=test&token=token&action=AddStreakSF
Remove Streak Removes 1 from current and rival sinks. https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreak
Remove Streak (same faction) Removes 1 from current streak.
USED FOR SAME FACTION BATTLES		 https://api.solkku.com/hourglass/?name=test&token=token&action=RemoveStreakSF
Reset Current Streak Resets current streak to 0. https://api.solkku.com/hourglass/?name=test&token=token&action=ResetStreak
Reset Everything to 0 Resets everything to 0 (not rank), good for per-stream usage. https://api.solkku.com/hourglass/?name=test&token=token&action=ResetTracker
Peek into the other faction's stats Shows the other faction for 15 seconds. https://api.solkku.com/hourglass/?name=test&token=token&action=Peek
Show/hide Hourglass Tracker Show/hide the tracker. https://api.solkku.com/hourglass/?name=test&token=token&action=ToggleHourglass

Issues, ideas, interest?

Are you experiencing issues or have ideas how to further develop this tracker?

Are you interested in using the overlay? Is someone in chat showing interest towards this tracker?

Feel free to DM me on Discord.