A cross-platform task scheduler and reminder configured in YAML.
Schedrem is a Python package that provides a tool for scheduling tasks and setting reminders.
As a resident program, it monitors changes in the configuration file, triggers tasks to execute commands or display message boxes as reminders. It also validates the configuration format every time the file is saved.
The configuration file, which is a YAML file, is easy to read and write. You can use your favorite text editor to configure your schedules.
Audible alarm using a sound file (currently WAV format only) is available.
Python 3.11 or later is required.
Install from PyPI using pip:
python -m pip install -U schedrem
git clone https://github.com/hikyae/schedrem
cd schedrem
python -m pip install -e .
There also exists an AUR package.
Install from AUR using a helper such as yay or paru:
yay -S schedrem
paru -S schedrem
git clone https://aur.archlinux.org/packages/schedrem
cd schedrem
makepkg -si
Schedrem searches for the configuration file in the order specified below and uses the first one that is found. The actual path depends on the platform and environment variables.
The file format must be YAML. Use your favorite text editor to edit the file.
Schedrem will automatically detect the changes you've made to the configuration file. If there is an error in the file, a message box will pop up and it will try to tell you the reason. Please fix the file and save it, then close the message box. Otherwise, the message box will keep popping up.
Note that there is no configuration file to set command-line options such as --config or --debug.
You can set the file path by passing it as a command-line parameter:
schedrem --config path/to/config
${XDG_CONFIG_HOME}/schedrem/config.yml${XDG_CONFIG_HOME}/schedrem/config.yaml${HOME}/.config/schedrem/config.yml${HOME}/.config/schedrem/config.yaml%USERPROFILE%\.config\schedrem\config.yml%USERPROFILE%\.config\schedrem\config.yaml%APPDATA%\schedrem\config.yml%APPDATA%\schedrem\config.yamlPlease refer to the examples directory in this repository.
All the schedules should be listed here.
Each schedule is an item in the list of schedules, denoted by a leading hyphen (-).
It can have description (abbreviated as desc), time, wait, enabled, and an action that consists of message (abbreviated as msg), yesno, command (abbreviated as cmd), sound, and font.
Basically, every key is optional with a few exceptions. If there is no action specified out of message, yesno, or command, an error occurs.
schedules:
- message: This is the simplest schedule. This message is shown every minute.
- description: The message "Good morning" is shown every day at 6 o'clock.
time:
hour: 6
minute: 0
message: Good morning.
A string to describe the schedule.
The time specification is inspired by cron, but is more readable and has some differences.
Specify integers or a list of integers for year, month, day, hour, minute to schedule the date(s) and time(s).
Specify string or a list of strings for weekday (abbreviated as dow) to schedule the day(s) of the week.
If you omit any of them, then the task is triggered at any of the times within that range. This is similar to using * in a crontab.
If you don't specify the time, then the task is triggered every minute.
The time to wait before triggering the task. The task won't be triggered until the specified time has elapsed.
You can specify integers for year, month, day, hour, minute, but only year is mandatory.
A boolean (true/false, yes/no, on/off) to set whether the task should be triggered or not. The default value is true.
Useful when you toggle multiple schedules with a single flag using an anchor in YAML.
The "action" is a conceptual term, not a configuration file key. The configuration file consists of the following keys: message (abbreviated as msg), yesno, command (abbreviated as cmd), sound, and font.
The detail of these keys is as follows:
message: A string to show in a message box with an OK button.yesno: A string to display in a message box asking for a Yes or No response. If the user selects "Yes", the command will be executed, and the message will be shown if they are specified. If "No" is selected, neither the command nor the message will be run.command: A string of an arbitrary shell command.sound: A string of the path to a sound file to play, or a boolean (true/false, yes/no, on/off) to set whether the default sound should be played while showing a message box. The only acceptable sound file format is WAV.font: A string specifying the font family and font size to use in the message box, in the format <font family> <font size>, for example, "Cica 40".These are optional settings that affect all schedules.
disabled: A boolean (true/false, yes/no, on/off) to set whether Schedrem should run or not. Set this to true when you want Schedrem to stop waiting for all schedules or when you want all running tasks, including all visible message boxes, to be killed. The default value is false.
disabled: true
weekdaynames: A list of lists of strings to set the names for the days of the week. They start from Monday and are case-insensitive. The default value is [mon, tue, wed, thu, fri, sat, sun].
weekdaynames:
- [mon, tue, wed, thu, fri, sat, sun]
- [月, 火, 水, 木, 金, 土, 日]
schedules:
- description: Time to take out the burnable trash
time:
hour: 7
minute: 50
weekday: 月
message: 燃えるゴミを捨てる
font: A string specifying the font family and font size to use in the message box, in the format <font family> <font size>, for example, "Cica 40". If you set this value outside of schedules, each action will use this font setting unless the font is explicitly set within the action. The default value is Arial 19.
font: Arial 70
schedules:
- description: You will see the huge text every minute
message: HUGE
aliases: Thanks to the YAML specification, it is possible to make aliases for values for schedules. The naming of the key aliases is not mandatory.
aliases:
- &workdays [mon, tue, wed, thu, fri]
- &friday13th
day: 13
dow: fri
schedules:
- desc: Time to go
time:
hour: 8
minute: 0
dow: *workdays
msg: Go to work
- desc: Beware of unluckiness in the morning
time:
hour: 8
minute: 0
<<: *friday13th
msg: Good morning, and beware!
First, you need to put your configuration file into one of the places described in the Configuration section.
Try starting Schedrem from a terminal to check for any errors:
schedrem --debug
This starts Schedrem in the foreground with the debug option, displaying configuration information if there are no issues. If no errors appear, you're good to proceed. You can stop the process by pressing <Ctrl>+C.
Set the config path if you put it besides the defaults:
schedrem --config path/to/config
On Linux, to start Schedrem as a background program in a stand-alone window manager, add the following line to your startup script, such as ~/.xinitrc:
schedrem &
The trailing ampersand "&" means that the program should run in the background. To stop Schedrem, just type pkill schedrem.
In a desktop environment (such as GNOME, KDE, Xfce, MATE, Cinnamon, etc.), you can simply add Schedrem to the list of autostarted applications without the trailing "&".
On Windows, you need to create a shortcut for the command:
shell:startup, and press Enter.powershell -windowstyle hidden -command "schedrem"
On macOS, you need to put a plist file as ~/Library/LaunchAgents/com.yourusername.schedrem.plist:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.yourusername.schedrem</string>
<key>ProgramArguments</key>
<array>
<string>schedrem</string> <!-- Assuming "schedrem" is accessible via PATH -->
</array>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>
--action that can receive a JSON string as an action.
Though this option is used internally for executing tasks, you can also manually execute it as a command. Answering "No" to yesno prompt lets the command exit with the code 1.schedrem --action '{"msg":"test","sound":true}'
schedrem --action '{"yesno":"yes?","cmd":"echo yes"}'; echo $?
schedrem --action '{"yesno":"Did you do push-ups?","msg":"Nice."}' || schedrem --action '{"msg":"Do it."}'
FAQs
A cross-platform task scheduler and reminder configured in YAML.
We found that schedrem demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Ransomware negotiators share how modern cybercriminals operate like corporations, using specialized teams, negotiation tactics, and reputation management.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.