Job priority
Which job gets uploaded next, and how to change it.
Why priority exists
At a busy event the queue is usually longer than the connection can drain. Some videos matter more than others: the front-angle recording of a medal contest is wanted immediately, while a rear-angle recording of a preliminary round can wait an hour.
Priority lets you decide that order instead of relying on the order files happened to arrive in.
The priority scale
Priority is a number from 1 to 10. Lower is more urgent. Jobs are processed in priority order; jobs with the same priority are processed oldest first.
| Priority | Label | Indicator |
|---|---|---|
| 1 | Top | ▲▲ red |
| 2 | Highest | ▲▲ orange |
| 3 | High 1 | ▲ amber |
| 4 | High 2 | ▲ amber |
| 5 | Medium 1 | = blue |
| 6 | Medium 2 | = blue |
| 7 | Low 1 | ▼ green |
| 8 | Low 2 | ▼ green |
| 9 | Bottom 1 | ▼▼ grey |
| 10 | Bottom 2 | ▼▼ grey |
The Priority column in the job grid shows the arrow and the number, coloured by tier, so the shape of the queue is readable at a glance.
Default priority
New jobs are created with priority 5 (Medium). This is deliberately in the middle of the range, so there is as much room to promote a job as to demote one.
The default can be changed with the DefaultPriority setting in settings.json.
Older versions used a much larger scale where the default was 100. When the Ingester starts and finds a DefaultPriority greater than 10, it automatically resets it to 5, so an upgraded installation does not end up with every new job pinned to the bottom of a 1–10 queue.
Automatic priority boost
The Raise priority when filename contains setting promotes matching files automatically as they are discovered: any file whose name contains the text is created at priority 4 (High 2) instead of the default 5 (Medium 1). The comparison ignores upper and lower case.
The usual case is two camera angles per fight, front and rear, where the front angle should be published first. Entering front there means every front-angle file jumps the queue with no manual intervention.
See the settings reference.
Changing priority by hand
Right-click a job in the grid:
| Menu item | Effect |
|---|---|
| ▲ Move Up (5 → 4) | Makes the job one step more urgent. |
| ▼ Move Down (5 → 6) | Makes the job one step less urgent. |
| Set Priority ▸ | Choose any value from 1 to 10 directly. The current value is ticked. |
You can select several jobs at once (Ctrl-click or Shift-click) and set their priority in one action.
Priority can only be changed on jobs with status pending or new — that is, jobs that have not started uploading yet. Once a file is being transferred, reordering the queue would not help, so the priority options are hidden.
After the grid refreshes, higher-priority jobs move to the top.
What priority does not do
- It does not affect jobs that are already uploading — those run to completion.
- It does not affect encoding. Once a file is uploaded, encode requests are made in the same priority order but they complete in seconds, so the effect is not noticeable.
- It does not make an individual upload faster. It only decides which job starts next.