MediaHub Settings: Auto Ingest

Auto Ingest allows you to create watchfolders (Sources) either on your local drive, or on a network drive. Any files placed into these watchfolders will be automatically imported into MediaHub based on the configuration below.

You can also define Rules that filter which files get processed, and Actions that define what happens to those files.

General Settings

Maximum concurrent processes: Auto ingesting might be a heavy process (as well as a manual upload). You can manage the load that MediaHub puts on the system by setting a maximum number of processes that can ingest assets simultaneously.
Leaving the maximum at 0 will set no restriction on the number of concurrent processes.

Source Settings

Interval: When adding a new source you can set an interval — the number of seconds MediaHub will wait after detecting a new file before ingesting it.
Use this for sources with large files, to prevent MediaHub from ingesting files that are still being written to the folder.

Auto Delete: When enabled, the original file will be automatically removed from the source folder after successful ingestion.

Add New Source

To define a source:

1. Go to MediaHub → Auto Ingest.

2. Click Add new source.

   1. There will be a permanent button on the top right.
   2. If you already have sources configured, you can turn on/off the toggles under them.

   

3. Under Path — enter the path to the source folder from which files will be uploaded.
   This can be a local path (e.g. C:\My\Ingest\Folder) or a network path (e.g. \\127.0.0.1\My\Shared\Folder).

   Success

   By completing steps 1–3 and filling in a destination Folder in the Action (step 9), you will have a fully functional Auto Ingest watchfolder. Rules and conversion are optional.

   Tip

   You can delete rules and actions by clicking the that appears next to their name.

   

   Adding upload rules

   By following these steps you will create a rule to filter which files are ingested:

4. Click Add rule.

5. Choose a file type from the Media type dropdown, or choose Any media to match all types.
6. Under Whitelist and Blacklist you can click Add new to choose file formats that are allowed (whitelist) or forbidden (blacklist) to auto ingest.

7. Under Matches you can enter a regex (regular expression) to filter files by name. Only files whose names match the expression will be processed. Leave empty to match all files.

   Adding upload actions

   Following steps 8–13 will allow you to define what happens to each file that is automatically ingested:

8. Click Add action.

9. Folder: enter the destination folder in MediaHub where the file will be stored. Always start with /.
   You can click to browse MediaHub storage and select the desired folder.

10. Filename: enter a new name for the uploaded file. Leave empty to keep the original filename.
    You can use the variables {folder}, {filename} and {extension} to build a dynamic name based on the original file.

11. Command: choose how the file should be handled:

    • Copy — upload the file as-is, without any changes.
    • Convert — transcode the file during ingestion. Select Convert and click the icon to open the Conversion Command Builder. The builder lets you configure all conversion options visually — no manual command writing required. The resulting command is shown at the bottom of the dialog and applied automatically when you click OK. Available options in the Command Builder:

    • Video Codec — the encoding format for the output video:

      Codec	Description
      Copy video stream	No re-encoding. Fastest — preserves original quality.
      H.264	Universal format, recommended for general use.
      H.265 (HEVC)	More efficient than H.264. Smaller files at equal quality.
      Apple ProRes	High-quality editing format.
      Avid DNxHD	High-quality format for Avid-based environments.
      Bink	Real-time playback format for broadcast graphics and Unreal Engine. Output: .bk2

    • Container — the file format wrapper (MP4, MOV, MKV). Not applicable for Copy or Bink.

    • Video Bitrate — target bitrate in Mbps. Enable Constant Bitrate for a fixed, predictable file size.
    • Resolution — optionally downscale the output. Select Keep original resolution to leave it unchanged.
    • Trim — extract a specific portion of the video by setting Start and End timecodes.
    • Audio — copy the source audio, remove it, or re-encode to AAC or PCM.

    Note

    To convert files to Bink (.bk2), the Bink converter tool must be installed on your MediaHub server. The output file extension is set to .bk2 automatically. Contact your system administrator if this option is unavailable.

    Tip

    Advanced users can type a conversion command directly into the Command field without opening the builder.

12. Expiry: by enabling expiry you can set for how many days files will remain in MediaHub before being automatically deleted.
    This will not delete the original source file. Leave disabled if you prefer to manage deletion manually.

13. Tags: assign tags to the ingested assets automatically. Tags can be used for search and organisation inside MediaHub.

    Note

    Actions work on a template basis: the Folder, Filename and Command values are applied to each file that passes the rule.