Schedules
Setup
Every timed job lives in Settings > Schedules.
Run a job now
Link to Run a job now- Find the job’s row.
- Select Run now. You should see its state change to Queued.
The next timed run does not move. A job already waiting or running is not started twice; HolyArrs tells you.
Change how often a job runs
Link to Change how often a job runs- Select Change on the row. It needs the Change settings permission.
- Pick an interval inside the allowed range and save. You should see the next run move to now plus the new interval.
What a row shows
Link to What a row shows- What the job does, in one line.
- How often it runs, its last run and any failure reason, and its next run.
- Its state: Waiting, Queued, Running, Turned off, Part is off or Safe mode.
- A link to another settings page that also sets it.
Choices
Link to ChoicesDefault ranges
Link to Default ranges| Job | Allowed range | Also set on |
|---|---|---|
| Feed check | 10 min to 2 h | Settings > Search |
| Try Held releases again | 1 min to 1 h | |
| Read Plex watchlists | 3 min to 1 h | Settings > Request rules |
| Read Outside lists | 15 min to 1 day, 5-min steps | |
| Health checks | 1 min to 1 day | Settings > This app |
| Check Library folders | 1 h to 1 day | |
| Find artist pictures | 1 h to 7 days | |
| Look for missing subtitles | 1 h to 7 days | Settings > Subtitles |
| Look for better subtitles | 6 h to 7 days | Settings > Subtitles |
| Check Jackett | 6 h to 7 days | Settings > Sources |
| Refresh movie details | 6 h to 7 days | |
| Refresh show details | 6 h to 7 days | |
| Refresh artist details | 6 h to 7 days | |
| Search for missing | 6 h to 7 days | Settings > Search |
| Rescan the Library | 6 h to 7 days | |
| Clean the holding folder | 6 h to 7 days | |
| Clean up History | 6 h to 7 days | Settings > This app |
Turn a schedule off
Link to Turn a schedule offTwo schedules can be turned off: Refresh movie details and Rescan the Library, for example to let NAS disks sleep. Off survives restarts and leaves other jobs running.
| Off | Cost |
|---|---|
| Rescan the Library | Files you add by hand show up only after Run now |
| Refresh movie details | Queued runs that have not started are cancelled. Names, dates and artwork can go stale. Manual refresh still works |
Turning one back on plans a run at now plus its interval. Missed runs are not replayed.
Background loops
Link to Background loopsBelow the jobs sit loops that run on their own, such as Download sync, Backups and Log masking. Each shows its state, interval, last and next pass, and why it retries. Pause, resume or restart a loop in Settings > Parts.
If it does not work
Link to If it does not workSymptom: Run now says the part is off. Cause: the job’s part is off in Settings > Parts, or HolyArrs is in safe mode and the job is outside the core. Fix: turn the part on, or leave safe mode. See Parts and safe mode.
Symptom: Run now is missing on a turned-off schedule. Cause: only people with Change settings run a turned-off schedule by hand. Fix: ask someone who has it.
Symptom: a job failed. Cause: shown on the row’s last run, masked like the log. Fix: act on that reason, then select Run now.
For experts
Link to For expertsAPI
| Route | Who | What |
|---|---|---|
GET /api/v1/schedules |
Run the Library, read scope | Schedules and loops |
POST /api/v1/schedules/{kind}/run |
Run the Library, write scope | Queue now. 202, or 409 when its part is off or in safe mode |
PUT /api/v1/schedules/{kind} |
Change settings, write scope | {"every_s": 1800} for any schedule; {"enabled": false} only for refresh_titles and rescan_library. 400 outside the range |
Related
Link to RelatedHolyArrs is free. If it saved you time, star it on GitHub, sponsor it or buy me a coffee.