@ariya/berkala

Berkala

Berkala runs scheduled tasks specified in a YAML-based configuration.

To get started, first download the binary for your operating system from the Releases page. Unpack the ZIP file and run the executable.

Since a config file does not exist yet, you will be offered to create one. Simply accept it and berkala.yml will be created, which may look like the following:

tasks:

  # Without an explicit interval, the task runs immediately
  boot:
    steps:
    - notify: Berkala starts now

  stay-hydrated:
    interval: every 1 hour
    steps:
    - notify: Drink some water! # TODO: how much?
    - print: Reminder was sent

  lunch:
    interval: at 11:58am
    steps:
    - notify: It's lunch time very soon
      title: Important
    - say: Get ready for lunch

  weekend-exercise:
    cron: 0 9 * * 6  # every 9 morning on Saturday
    steps:
    - notify: Time for some exercises!
      title: Stay healthy

Just like any regular YAML, everything from the # character until the end of the line will be ignored. Use this to insert comments.

The schedule for each task can be specified as:

• a human-friendly interval, e.g. every 5 minutes, at 5pm, or
• a cron expression, e.g. 0 9 * * 6

If neither is explicitly stated, then the task runs right away.

Each task consists of one or more steps.

Every step must be one of the following:

print: displays a message to the standard output

notify: sends a desktop notification

The notification is supported on the following system:

• Windows: Windows.UI.Notifications via Powershell scripting
• macOS: display notification with AppleScript
• Linux: notify-send, e.g. part of libnotify-bin package on Debian/Ubuntu

say: converts text to audible speech

The text-to-speech conversion is supported on the following system:

• Windows: System.Speech.Synthesis via Powershell scripting
• macOS: say with AppleScript
• Linux: Festival speech synthesis, e.g. festival and festvox-kallpc16k on Debian/Ubuntu

Found a problem or have a new idea? File an issue!

Alternative way to run Berkala (with Node.js)

With Node.js v14 or later (that has npx):

npx @ariya/berkala

To run the development version, check out this repo and then:

npm install
npm start