|
Scripting allows you to create simple commands to control TimeLeft behavior.
For example, you can setup to hide a countdown when it ends; to show and start
the second countdown when the first countdown ends; to start or pause a stopwatch
when a reminder ends; to show a sticker, etc. Also you can setup keyboard shortcuts
- to start or reset a timer (or several timers), to show or hide a clock, etc.
There are two types of scripts:
actions - these scripts run automatically when a reminder/countdown ends;
keyboard shortcuts - these scripts run when the specified shortcut is
pressed.
Specifications
Script is a text line composed of one or more sentences separated
with ; (semicolon). Each sentence describes one simple command. All texts are
case-insensitive.
Sentence format: object, id, command;
Object (a text word) specifies the type of the operated module (Reminder,
Countdown etc.).
ID (a number or a text word) specifies the position of the operated module
instance in the corresponding "Main Window" list (List of Reminders,
Countdowns, etc).
Command (a text word) specifies the command.
Objects
| TimeLeft |
TimeLeft application |
Reminder,
Countdown,
Clock,
Stopwatch,
Timer,
Sticker,
AuctionWatch |
corresponding modules |
ID
Applies only to the modules. Ignored for the "TimeLeft" object.
| 1, 2, 3, ... |
position of the instance in the corresponding "Main Window"
list |
| Current |
(Applies only to the "actions" type of script) Current instance - reminder or countdown which has this script in its actions. |
Previous,
Next |
(Applies only to the "actions" type of script) previous or next instance in the corresponding list |
All,
First,
Last |
All instances in the corresponding list, or first or last instance |
| ActiveAll, ActiveFirst, ActiveLast |
All active (currently shown on the desktop) instances in the corresponding list, or first or last active instance |
| InactiveAll, InactiveFirst, InactiveLast |
All inactive (currently not shown on the desktop) instances in the corresponding list, or first or last inactive instance |
Command
"TimeLeft" object
| Close |
Close TimeLeft application |
| Restore |
Restore TimeLeft |
| Hide |
Minimize TimeLeft |
| RestoreHide |
Restore TimeLeft if it's minimized or vice versa |
Modules - all (common commands for all floating windows)
| Enable |
Enable (show floating window) specified instance(s) |
| Disable |
Disable (hide floating window) specified instance(s) |
| EnableDisable |
Enable if it's currently disabled and vice versa |
Modules - Reminder, Countdown
| Reset |
Reset periodical reminder or countdown with the defined starting point.
Starting point must be "defined time" or "defined date/time" - then reminder or countdown will be restarted from the current date or date/time.
Periodical reminders are: Minutely, Hourly, Daily, Weekly, Monthly and Annually. |
Modules - Stopwatch, Timer
| Start |
Start stopwatch or timer |
| Pause |
Pause stopwatch or timer |
| StartPause |
Start if paused and vice versa |
| Reset |
Reset stopwatch or timer to it's start value |
Examples
actions - setup at Reminder (or Countdown) Settings window, checkbox "Enable Actions".
Perform command when
countdown ends:
| Command |
Script |
| Hide ended countdown |
countdown,current,Disable |
| Show next countdown |
countdown,next,Enable |
| Show sticker #3 |
sticker,3,Enable |
| Start countdown #2 |
countdown,2,Start |
| Show first inactive clock |
clock,InactiveFirst,Show |
| Restore TimeLeft |
timeleft,,Restore |
Setup intermittent reminders: remind in 5 minutes, then in 2 minutes, then in 5 again, so on:
create two periodical reminders - for 5 and for 2 minutes, both set starting point as "defined date/time", then set following action scripts:
First reminder (5 minutes): Reminder,next,enable; Reminder,next,reset; Reminder,current,disable
Second reminder (2 minutes): Reminder,previous,enable; Reminder,previous,reset; Reminder,current,disable
And then enable first reminder.
Keyboard shortcuts - setup at TimeLeft Options, tab Advanced, Enable
shortcuts - "Edit" button.
Perform command when the keyboard shortcut is pressed (e.g. Ctrl-Alt-T):
| Command |
Script |
| Reset first timer |
timer,first,Reset
|
| Toggle show/hide clock #1 |
clock,1,EnableDisable |
| Toggle show/hide all stickers |
sticker,all,EnableDisable |
| Show stopwatch #2 and start it from the beginning |
stopwatch,2,Enable; stopwatch,2,Reset; stopwatch,2,Start
|
| Restore or minimize TimeLeft |
timeleft,,RestoreHide |
|