Ingest Schedules, Editions And Notices
This page covers the rest of an Ingest job: when it runs, how files are checked and placed, how many editions are kept, and who is told when something goes wrong.
When
Under When, say which days and times the job should look for new files.
| Setting | What it does |
|---|---|
| Days | The days it runs (tick Monday to Sunday) |
| From, To | The time window it works in, such as 18:00 to 23:59 |
| Every (Min) | How often it checks inside the window, 1 to 1440 minutes |
| Edition | Today's or Tomorrow's: which date the names and the deadline count from |
| Deadline | A time (hh:mm) on the edition's day. If the edition is not all there by then, it is late |
A job is checked every 30 seconds to see whether it is due, and runs in the background, so a slow source never holds up the air.
Files
Under Files, say what an edition is.
| Setting | What it does |
|---|---|
| Parts | How many parts make up an edition, 1 to 40. Use 0 to take the newest new files instead (a podcast, a news folder) |
| Newest | With parts set to 0, how many of the newest files to bring |
| Shortest (S) | A file shorter than this many seconds is refused. The default is 10 |
| Into | The folder the files go in, for example @Ingest/Programs/The Show/{n} |
| Named | What to call each file. Empty keeps its own name. {ext} is its file type |
| Keep | How many editions to keep. The default is 2 |
How An Edition Arrives
- Each part is fetched into a holding area first, never straight into the library. Files are only fetched when they are new.
- Each part is checked: it must play to its end, be at least the shortest length and not be silent.
- When every part is in, all of them are placed together, so a half-new show never airs. Meanwhile the last complete edition keeps playing.
- Older editions beyond Keep are removed. Only files the job itself placed are ever removed.
A failed fetch is tried again after 1, 5 and 15 minutes, then at the next run. Auricast leaves at least 2 GB of free space, and refuses a file over 1 GB.
Auricast plays files as they are: it does not convert them, and does not change their loudness.
What You See
While an edition is being gathered, the job's Now line says which parts are in, for example "parts in 1, 2 of 4", and shows the last error if a run failed. The job's row shows In, Failing or Paused. Run Now forces a check.
Who Is Told
Under Who Is Told, list the addresses to mail, separated by commas. Leave it empty and the station's alert address is used. A producer's address can be added so they hear about their own show.
| Event | When it is mailed |
|---|---|
| A job failing | Once per edition, after its third failed run in a row (a refusal, a missing file, or a file that does not play), and again when it works |
| Late | Once, when the deadline has passed on the edition's day and the edition is not all there |
When a late edition is airing the last complete edition instead, a program that a job feeds also shows as Late in Programs.
Removing A Job
Remove Job stops it and leaves every file it placed where it was.
Passwords And Safety
A job's password, key or token is kept on the box, never shown back and never written to the job's log. A job writes only into its own folders, inside your library locations. Names from a remote server are cleaned so they cannot escape their folder.