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
- Click-through
- Streaming and OBS
- Command line
- Stream Deck and other button boxes
- Installing on many computers
- Where settings are kept
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.
| Action | Keys |
|---|---|
| New countdown | Ctrl+Alt+N |
| Add 1 minute | Ctrl+Alt+↑ |
| Subtract 1 minute | Ctrl+Alt+↓ |
| Pause / resume | Ctrl+Alt+P |
| Show / hide the clock | Ctrl+Alt+H |
| Click-through on / off | Ctrl+Alt+T |
| Drift on / off | Ctrl+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:
- lists the clock in the taskbar, so OBS can find its window; and
- paints a solid background behind the clock (green by default) that OBS can remove.
Setting up OBS Studio
- Start a countdown so the clock is showing.
- In OBS, under Sources, choose +, then Window Capture.
- For Window, choose the one named [TimeToStart.exe]: TimeToStart – …
- Set Capture Method to Windows 10 (1903 and up).
- 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.
- 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"
| Option | What it does |
|---|---|
--minutes 5 | Count down for 5 minutes. Also 2.5, 4:30, 1:15:00, 90s. |
--until 10:30 | Count 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 1 | Add minutes; use --add -1 to subtract. |
--pause, --resume, --toggle-pause | Pause or resume the countdown. |
--show, --hide | Show or hide the clock without stopping the countdown. |
--stop | Stop the countdown. |
--monitor 2 | Move the clock to screen 2 (screens are numbered left to right). |
--drift curvy | off, straight or curvy. |
--click-through on | Turn click-through on or off. |
--streaming on | Turn streaming mode on or off. |
--new, --settings | Open the Start a countdown window, or Settings. |
--quit | Exit TimeToStart. |
--help | Show 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
| Option | What it does |
|---|---|
--install | Show the install window (install, update, or open the installed copy). |
--uninstall | Remove 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, presets and license:
%AppData%\TimeToStart\settings.json. The exact path is shown in Settings → About, with a button to open the folder. - Error log, if something goes wrong:
%AppData%\TimeToStart\error.log. Attach it when you email support. - Portable mode: put an empty file named
TimeToStart.settings.jsonnext to TimeToStart.exe, and settings are kept there instead. A license is tied to the computer it was activated on, so it doesn't travel with a portable copy.
Settings are per Windows user. Copying the settings file to another computer copies the look and presets, but not the license.