Advanced

You don't need anything on this page to run a countdown. It's for operators who want to control the clock without touching the mouse, live-streamers, and IT staff.

Hotkeys (full version)

Hotkeys work even while another program, such as PowerPoint, is in front, so you can adjust the clock without anyone seeing you do it.

Standard hotkeys
ActionKeys
New countdownCtrl+Alt+N
Add 1 minuteCtrl+Alt+↑
Subtract 1 minuteCtrl+Alt+↓
Pause / resumeCtrl+Alt+P
Show / hide the clockCtrl+Alt+H
Click-through on / offCtrl+Alt+T
Drift on / offCtrl+Alt+D

To change one, open Settings → Hotkeys, click its box and press the new keys (Backspace clears it). If another program already uses a combination, TimeToStart says “Unavailable”; choose a different one.

Click-through

With click-through on, mouse clicks pass straight through the clock to whatever is underneath, which is useful when the clock sits over something you need to click. Turn it on in Settings → Screens & streaming, from the TimeToStart icon's menu, or with its hotkey. While it's on, the clock's toolbar doesn't appear; use the icon's menu or hotkeys instead.

Streaming and OBS (full version)

Live-streaming software such as OBS Studio can capture the clock and put it on your stream. Turn on Streaming mode in Settings → Screens & streaming. This:

Setting up OBS Studio

  1. Start a countdown so the clock is showing.
  2. In OBS, under Sources, choose +, then Window Capture.
  3. For Window, choose the one named [TimeToStart.exe]: TimeToStart – …
  4. Set Capture Method to Windows 10 (1903 and up).
  5. Set Window Match Priority to Match title, otherwise find window of same executable. The window's title includes the time, so it changes every second; this setting keeps OBS on the clock.
  6. Right-click the new source, choose Filters, add a Chroma Key filter, and set its key color to match TimeToStart's background (green by default).

Tip: if your clock uses green text, choose a different background in Screens & streaming (such as blue), and set the same color in the Chroma Key filter.

Command line (full version)

TimeToStart.exe accepts options, for desktop shortcuts, scripts and button boxes. If TimeToStart is already running, the options go to the running copy, so the same command can start a countdown or adjust one in progress.

"C:\Program Files\TimeToStart\TimeToStart.exe" --minutes 5 --caption "Service starts in"
Options
OptionWhat it does
--minutes 5Count down for 5 minutes. Also 2.5, 4:30, 1:15:00, 90s.
--until 10:30Count down to a time of day, such as 7:15pm or 19:15.
--caption "text"Set the caption ("" for none). On its own, changes the running clock's caption.
--preset "name"Start a saved preset. Other options given with it take priority.
--add 1Add minutes; use --add -1 to subtract.
--pause, --resume, --toggle-pausePause or resume the countdown.
--show, --hideShow or hide the clock without stopping the countdown.
--stopStop the countdown.
--monitor 2Move the clock to screen 2 (screens are numbered left to right).
--drift curvyoff, straight or curvy.
--click-through onTurn click-through on or off.
--streaming onTurn streaming mode on or off.
--new, --settingsOpen the Start a countdown window, or Settings.
--quitExit TimeToStart.
--helpShow the list of options.

The free version accepts --new, --settings, --quit and --help, plus the installation and license options below.

Stream Deck and other button boxes

Any device that can run a program can control the clock. On an Elgato Stream Deck, add a System → Open action, and enter the path to TimeToStart.exe followed by an option, for example:

"C:\Program Files\TimeToStart\TimeToStart.exe" --add 1

Useful buttons: --minutes 5, --add 1, --add -1, --toggle-pause and --stop.

Installing on many computers

Installation and license options (work in the free version too)
OptionWhat it does
--installShow the install window (install, update, or open the installed copy).
--uninstallRemove TimeToStart. Add --quiet to skip all questions (settings are kept).
--activate TTS-…Activate a license key without opening any windows, then show the result.

TimeToStart installs to C:\Program Files\TimeToStart (for everyone) or %LocalAppData%\Programs\TimeToStart (just for me), and appears in Windows Settings → Apps. Running a newer TimeToStart.exe offers to update the installed copy.

Where settings are kept

Settings are per Windows user. Copying the settings file to another computer copies the look and presets, but not the license.