-
Notifications
You must be signed in to change notification settings - Fork 0
Click Rate Formats
The --rate CLI flag and the GUI's click-rate field both use the same parser (ClickRateParser) across all three platforms. The parser accepts delay formats (time between clicks) and frequency formats (clicks per unit of time), all case-insensitive.
| Limit | Value |
|---|---|
| Minimum delay | 1 ms (maximum rate: 1000 clicks/second) |
| Maximum delay | 360 minutes |
Any rate that would produce a delay outside these bounds is rejected with a descriptive error message. The OS may enforce a lower practical ceiling — Windows SendInput is typically reliable to about 1000 clicks/second; actual throughput depends on system load.
A delay is the time between clicks.
| Format | Example | Meaning |
|---|---|---|
| Bare integer | 100 |
100 milliseconds |
| Milliseconds | 100ms |
100 milliseconds |
| Seconds | 5s |
5 seconds (5000 ms) |
| Seconds | 5sec |
5 seconds |
| Seconds | 5secs |
5 seconds |
| Seconds | 5second |
5 seconds |
| Seconds | 5seconds |
5 seconds |
| Minutes | 2m |
2 minutes (120 000 ms) |
| Minutes | 2min |
2 minutes |
| Minutes | 2mins |
2 minutes |
| Minutes | 2minute |
2 minutes |
| Minutes | 2minutes |
2 minutes |
Spaces between the number and unit are accepted: 5 sec, 2 min, 100 ms.
Decimal values are accepted: 0.5sec (500 ms), 0.5min (30 000 ms).
A frequency is how many clicks occur per unit of time. The parser converts it to a delay internally.
| Format | Example | Meaning | Resulting delay |
|---|---|---|---|
| Per second (slash) | 10/s |
10 clicks per second | 100 ms |
| Per second (cps) | 10cps |
10 clicks per second | 100 ms |
| Per second (words) | 10 times per second |
10 clicks per second | 100 ms |
| Per minute (slash) | 600/min |
600 clicks per minute | 100 ms |
| Per minute (cpm) | 600cpm |
600 clicks per minute | 100 ms |
| Per minute (words) | 600 times per minute |
600 clicks per minute | 100 ms |
| Per hour (slash) | 60/h |
60 clicks per hour | 60 000 ms |
| Per hour (cph) | 60cph |
60 clicks per hour | 60 000 ms |
| Per hour (words) | 60 times per hour |
60 clicks per hour | 60 000 ms |
The parser disambiguates formats that share trailing letters using guards:
-
10/min→ frequency (per minute), not the "minutes" delay path -
600cpm→ frequency (per minute), not minutes -
600 times per minute→ frequency (per minute), not minutes -
10/s→ frequency (per second), not the "seconds" delay path -
10cps→ frequency (per second), not seconds
The following produce an error (exit 1 in CLI mode, inline error in GUI mode):
- Empty or whitespace-only string
- Non-numeric value:
abc,foo/s - Zero or negative value:
0ms,-1ms,0/s - Rate above the maximum (delay < 1 ms):
2000/s,1001/s - Delay above the maximum:
361min,0.001/h - Unrecognized format:
10clicks
In the GUI, you select the mode (Delay or Frequency) with radio buttons, then type just the number. The unit is chosen from a dropdown. In the GUI you never type 100ms — you type 100 and select ms.
In the CLI, you always pass the full string to --rate. Every format in the tables above is accepted.