# HELP: Job Scheduler

Job Scheduler (job-scheduler) is a gui frontend to the crontab task scheduling system,
a long standing linux standard, providing some convienence features such as help with
cron time code formatting and setting of environment variables.

## Command Tab

The opening tab for job-scheduler shows the current task profiles in the left pane
and a job editor in the right pane. The currently selected job from the left is displayed
in the right pane.

Clicking the "New Item" button in the toolbar will start a new entry for editing.
The user can manually enter a cron job here. The "Reload" button in the toolbar
will reload the last saved job list.

The schedule for the task appears at the bottom of the Command Pane, showing
actual time the task will be launched. This list changes as the user formats
the cron time format string either directly or via the Edit button.

No changes to the cron job schedule will take place until the "Save" button is executed.

Selecting the "Time Settings Editor" button in the Command pane will open the
Time Settings Editor to help the user with time formatting. It is possible
to select multiple time buttons, each affecting a different area of the
cron time format string, which the user can see change in real time

The buttons are actual numbers on the clock face. So "5" under Minutes is 5 minutes
after the hour. 2 under Hours is 2:00 in the morning. The cron time format string
will be generated as you select numbers.

## Variables Tab

The Variables tab of the right pane allows the user to set up certain
environment variables the the task may require. By default, PATH, SHELL, and HOME
are already set.

## Job List Tab

The Job List tab shows all currently scheduled jobs and when they will run.
The user may filter the list via the "Max Item" and "Max Date" boxes at the
bottom of the tab. Changing values and pressing "Update" will change the list

### Tips and Tricks

- Job Scheduler shows jobs on a per-user basis
- If you want to edit a root level task, launch the app as root (sudo, gksu, mx-pkexec, etc...)
- Jobs scheduled via methods other than crontab may not show in Job Scheduler

License: GPL3