Support

Product: Task Scheduler Monitor (Stream Deck plugin for Windows) ยท Provider: GRAMSHIFT (Tokyo, Japan)

Contact

Email contact@gramshift.com in English or Japanese. We reply within 7 business days, usually sooner. Please include your Windows version, your Stream Deck app version and, if possible, a photo or screenshot of the key.

Failed Tasks

  1. Install the plugin from the Elgato Marketplace. In the Stream Deck app, find Task Scheduler Monitor in the action list and drag Failed Tasks onto a key.
  2. The key shows how many scheduled tasks failed their last run. 0 / all OK with a green frame means nothing failed; a number on a red key means that many tasks failed.
  3. Press the key to see the failing tasks one by one: their name and last result code (for example 0x1), newest first. After the last one, or after 15 seconds, the key shows the count again.
  4. Select the key to choose what it watches: Settings are saved as soon as you change them.
  5. The task list is read once a minute while a key of this plugin is on screen. Press the key to step through the names; press a Watch Task key to check again at once.

Watch Task

  1. Drag Watch Task onto a key, select it and choose a task. The list shows every task Windows lets your account see, grouped by folder.
  2. The key shows the task name, the last result (OK; a result code such as 0x1 or Stopped on a red key; Running; Queued; or Not run), the last run and the next run (or Disabled).
  3. Press the key to check again at once.
  4. Optional: turn on Run the task now to make a press start the task, like "Run" in Task Scheduler. It is off by default. The key briefly shows a check mark when Windows accepted the request, or a warning triangle when it refused (for example the task's setting "Allow task to be run on demand" is off, or your account may not run that task).

What counts as failed

The last result that Windows Task Scheduler keeps for each task is used. The meaning of the codes comes from Microsoft's list Task Scheduler error and success constants.

Last resultCounted as failed?
0x0 (the program ended with 0)No
0x41301 running, 0x41303 has not run yet, 0x41325 queued, and the other Task Scheduler status codes 0x41300โ€“0x41308, 0x4131B, 0x4131C (except 0x41306, below)No
0x41306: the last run was stopped before it finished. Microsoft describes it as "terminated by the user", but Windows also records it when it stops a task that ran longer than its "Stop the task if it runs longer than" limit, for example a backup that hung.Yes
Any other code: the program's own exit code (for example 0x1), Windows error codes (for example 0x800710E0 "the request was refused", 0x80070002 "file not found"), Task Scheduler error codes (for example 0x8004131F "an instance is already running")Yes

To look up a Windows error code, Microsoft suggests the command net helpmsg with the last four hex digits converted to a decimal number (for example 0x80070002 โ†’ net helpmsg 2).

Common questions

The count is different from what I see in Task Scheduler.
Check the Folders setting: by default only the top folder of the Task Scheduler Library is counted, and disabled tasks are not counted. Tasks that belong to other users or to the system may not be visible to your account; the plugin shows what Task Scheduler shows you without "Run as administrator".

A task I fixed still counts as failed.
The last result changes only when the task runs again. Run it once from Task Scheduler (or with a Watch Task key that has "Run the task now" on).

The key shows "--" / "cannot read" and a warning triangle.
The plugin reads tasks through Windows PowerShell, which is included with Windows. If PowerShell is blocked on your PC (for example by a company policy), or the Task Scheduler service is not running, the tasks cannot be read. The plugin tries again every 5 minutes; press the key to try again at once.

A Watch Task key shows "not found".
The task was deleted or renamed. Select the key and choose the task again.

What can it not see?
It sees the last result that Windows records. A run that was skipped (for example the PC was off and the task is not set to run as soon as possible afterwards) leaves the last result unchanged. A script that fails but still ends with exit code 0 looks like a success. Some programs use non-zero exit codes for success (for example robocopy returns 1 when it copied files); such tasks show as failed. Folders your account may not read are skipped.

A task from another program keeps the key red.
Use Name starts with to count only your own tasks (for example give them a common prefix such as My_).

Does it slow down my PC?
One small PowerShell process reads the list once a minute (well under a second on a typical PC) and only while a key of this plugin is on screen. It closes shortly after you switch to a page without these keys.

Does it work on Mac?
No. This plugin is for Windows 10 or later only.

Privacy

The plugin runs entirely on your PC and sends no data anywhere. See the Privacy Policy.