How to use the schedule feature

[stefansundin]

In addition to allowing you to adjust the bandwidth limit interactively using the keyboard while the upload is running, shrimp has a feature to automatically adjust the bandwidth limit based on a schedule. This is useful if you want to limit the impact that the upload might have on other internet usage that is more important during certain hours (e.g. work).

See https://github.com/stefansundin/shrimp/blob/main/example-schedule.txt for an example schedule file.

Quick example:

default: unlimited
mon-fri 0800-1800: 200k
sat 1000-1830: 400k
sun 0900-1300: 250k

This schedule sets the bandwidth limit to 200 kB/s Mondays through Fridays from 8:00 to 18:00 (8am to 6pm), and 400 kB/s on Saturdays from 10:00 to 18:30 (10am to 6:30pm), and 250 kB/s on Sundays from 9:00 to 13:00 (9am to 1pm). All other times the default limit applies (no limit in this case).

You can still manually change the bandwidth limit using the keyboard controls as usual, but the manually set limit will be overridden once the next block on the schedule starts (or if the current one ends). At this time there is no way to suspend the schedule while shrimp is running.

Please feel free to ask questions about this feature in the comments below.