Rift Valley Timer

Apple iOS App Store Icon Link
iPhone, iPad, and Mac

Rift Valley Timer is The Ultimate Countdown Timer! It will count down, from a preset time, in intervals of one second.

TIMER MODES:

Figure 1: Total Time
Figure 2: Warning Time
Figure 3: Final Countdown Time

Each timer has three possible modes, that occur at different times:

Total Time (Figure 1)

This is the entire time the timer counts down. It is indicated by a green color. You select this mode by touching the green (leftmost) circle, under the Time Set Picker.

Warning Time (Figure 2)

This threshold, when crossed, causes the timer to turn yellow, indicating that time is running out. You select this mode by touching the yellow (middle) circle, under the Time Set Picker.

Final Countdown Time (Figure 3)

This is when the timer is about to alarm. The timer turns red. You select this mode by touching the red (rightmost) circle, under the Time Set Picker.

Each timer can be set to have these thresholds, which are reflected in the running timer. You can also choose to have no thresholds.

As each threshold is crossed, the screen flashes briefly. On devices that support haptics, you may feel a slight “twitch.”

Running Modes

Figure 4: Digital Mode
Figure 5: Podium Mode

It has two running modes:

Digital (Figure 4: numbers only)

The timer display has the appearance of an old-fashioned “LED display.”

Podium (Figure 5: “traffic lights”)

The timer displays three simple circles that light up, one by one, as the timer progresses. It was specifically designed to reduce distraction.

The display is designed to take up as much space as possible, on the screen.

The mode is chosen in the Settings popover, which is accessed via the “Gear” button, in the top, left of the screen.

Figure 6: The Settings Popover (Mode Switch On Bottom)

At the end of the timer period, the timer goes into “Alarm Mode,” where an audible alarm may sound, the phone may vibrate, and the screen flashes red.

SETTING THE TIMER:

Figure 7: The Time Set Picker

Use the picker in the main screen to set the timer initial (Start) time, along with the Warning and Final thresholds. The three buttons below the picker select which threshold is being set.

NOTE: The Warning and/or Final times must be at least one second less than the Start (Total) time.

You can select between a set of sounds that the device will play, along with vibration (on devices that support vibration). This is done, via the Alarm Setting Popover (accessed by the “Bell” button, in the top, right corner of the screen). The sound and vibration settings apply to all timers (if there are multiple timers).

Figure 8: The Alarm Set Popover

SELECTING ALARM SOUNDS AND VIBRATION:

If you select the Set Alarm button (the “Bell” button, at the top right of the screen), a popover appears, where you can choose to play a sound, and/or vibrate, when the timer ends a countdown (NOTE: vibrate is only supported on iPhones). If you select a sound, you can test it, using the “Speaker” button, next to the sound picker.

MULTIPLE TIMERS:

You can have a minimum of one (1) timer, and a maximum of seven (7) timers.

It is possible to “cascade” between these timers, with one timer following another.

ADDING AND REMOVING TIMERS:

Figure 9: Adding A New Timer
Figure 10: Deleting A Timer
Figure 11: Delete Confirmation

Use the toolbar, on the bottom of the screen, to add, remove, and select timers.

Add timers by touching the “+” on the right side of the toolbar, and delete timers, by selecting the trash can icon, on the left side of the toolbar.

You can choose which timer is being set, by selecting a numbered timer button in the toolbar, or by swiping left and right, in the screen.

OPERATION:

You start the timer by selecting the “Play” button, which is the white triangle, to the right of the Final threshold button, under the time set picker.

Figure 12: Paused Mode (At Start)
Figure 13: Paused Mode (After Running)
Figure 14: Running Mode (With Initial Green “Flash”)

It is possible to have the timer start immediately, or in Paused mode (Paused mode is indicated by a light blue digital color, or dark “traffic lights”). Choose this, in the Settings Popover.

If the timer is running, the digital display will be green (Start), yellow (Warning), or red (Final, or alarming). Note in the figures below (Figure 15B-17B), that the timer optimizes the display, based on the total time, as set. In this case, the maximum time was 12 seconds, so only 2 digits were required (2 digits is the minimum, and 6 digits is the maximum).

Figure 15A: Start Time (Podium Mode)
Figure 16A: Warning Time (Podium Mode)
Figure 17A: Final Time (Podium Mode)
Figure 15B: Start Time (Digital Mode)
Figure 16B: Warning Time (Digital Mode)
Figure 17B: Final Time (Digital Mode)

When the timer is complete, it begins “alarming,” where the screen flashes red, the phone may (or may not) vibrate, and any sound that you choose is played repeatedly.

You can choose to have a toolbar displayed along the bottom of the running timer, or use swipe and tap gestures to control it (without the toolbar).

TIMER CONTROL MODE

The running timer can be controlled by either a visible toolbar, along the bottom, and over the timer (Toolbar Mode), or by gestures (swipes and taps). That is called “Gesture Mode.”

Figure 18: Toolbar Mode
Figure 19: Gesture Mode
Figure 20: Toolbar (When Timer is Paused)
Figure 21: Toolbar (When Timer Is Running)

TOOLBAR MODE (TOOLBAR IS DISPLAYED):

If the toolbar is displayed, use the buttons in the toolbar to control the running timer. Taps and gestures are not used.

NOTE: The toolbar may “auto-hide” in this mode. If it is hidden, tapping in the display will show the toolbar, but will have no effect on the timer.

The Stop Button (square)

Figure 22: Stop Button

This will always stop the timer, and return you to the timer setting screen.

The Play Button (single triangle)/Pause Button (double bars)

Figure 23: Play Button
Figure 24: Pause Button

This starts the timer, if the timer is paused. If the timer is running, the same button will become a Pause button (indicated by two vertical bars), and selecting it will pause the timer at the current time.

The Fast Forward Button (double arrow, pointing to the right)/Next Timer Button (circle, with a number in it)

Figure 25: Fast Forward Button
Figure 26: Next Timer Button

This button will send a paused (or running) timer directly to Alarm Mode. If there is more than one timer, you can use the same button to select the next timer (in which case, the double arrows are replaced by a timer number, in a circle).

The Rewind Button (double arrow, pointing to the left)/Previous Timer Button (circle, with a number in it)

Figure 27: Rewind Button
Figure 28: Previous Timer Button

This will cause the timer to return to its starting time, and pause (if it was running). If there is more than one timer, you can use the same button to select the previous timer (in which case, the double arrows are replaced by a timer number, in a circle).

Auto-Hide

Figure 29: The Auto-Hide Setting

You can choose to have the toolbar “auto-hide,” in the Settings Popover. If you choose this, then the toolbar disappears, if there has been no interaction with the timer (touching the screen, or selecting a toolbar item). Touching the screen brings it back.

The toolbar does not auto-hide, if the timer is paused, or is alarming.

GESTURE MODE (TOOLBAR IS NOT DISPLAYED):

Figure 30: Gestures

If the toolbar is not displayed, you must rely on gestures to control the timer.

Tap (Timer is paused)

The timer starts (or continues) counting down.

Tap (Timer is running)

The timer pauses at the current countdown time.

Swipe Left (Timer is paused, at the start)

This causes the previous timer to be selected, if there are multiple timers. If there is only one timer, nothing happens.

Swipe Left (Timer is running, or is paused in mid-countdown)

This causes the timer to “reset.” This means that it sets the time back to the beginning, but pauses.

Swipe Right (Timer is paused, at the start)

This causes the following timer to be selected, if there are multiple timers. If there is only one timer, nothing happens.

Swipe Right (Timer is running, or is paused in mid-countdown)

This causes the timer to go directly to Alarm Mode.

Swipe Up or Down (At any time)

Stop the timer, and return to the setting screen.

MAC VERSION KEYBOARD NAVIGATION:

In the Mac (Catalyst) version of the app, it is possible to use the keyboard to control the app:

Space Bar

If the space bar is hit, a paused timer will start (or continue), or a running timer will pause.

Left Arrow (Timer is running, or is paused in mid-countdown)

This causes the timer to “reset.” This means that it sets the time back to the beginning, but pauses.

Left Arrow (Timer is paused, at the start)

This causes the previous timer to be selected, if there are multiple timers. If there is only one timer, nothing happens.

Right Arrow (Timer is running, or is paused in mid-countdown)

This causes the timer to go directly to Alarm Mode.

Right Arrow (Timer is paused, at the start)

This causes the following timer to be selected, if there are multiple timers. If there is only one timer, nothing happens.

Escape (ESC) Key (At any time)

Stop the timer, and return to the setting screen.

DIGITAL MODE POWER USER FEATURE

In Digital Mode, you have the ability to set the time to an arbitrary time, by long-pressing on the bottom of the display, in a running timer.

If you long-press on the display, the timer pauses (if not already paused), and a slider appears, with the thumb under your finger. Slide it right or left, to change the set time of the timer.

If “Start Timer Immediately” (in the Settings Popover) is on, then the timer will start, when you lift your finger from the screen (or release the mouse/trackpad button).

Figure 31: Slider in an iPhone Screen
Figure 32: Slider in an iPad Screen

RUNNING TIMER KEEPS THE PHONE AWAKE

If the Running Timer Screen (the one with the Digital or Stoplight display) is open, the device won’t go to sleep, unless you specifically press the Lock Button.

FOREGROUND APP ONLY

Rift Valley Timer is designed to run in the foreground, and will not alarm, if the app is in the background (it does, however, keep counting). It’s usually a good idea to put the device into Airplane Mode, when using Rift Valley Timer.

SOURCE CODE AVAILABLE

Although Rift Valley Timer is a proprietary app (not licensed for reuse), the source code is available in this GitHub repo.

This is the technical source documentation.