Skip to content
  • There are no suggestions because the search field is empty.

Imagen Media Workflows πŸ“•

This guide will introduce you to Imagen media workflows, what they are, and how they may be used. All media is ingested into Imagen using a Workflow.

Prerequisite knowledge: To make the most of this article it would help to be familiar with Imagen records and media objects

Contents

What is an Imagen Media Workflow?Β 

Transcoder / File ConversionΒ 

Custom workflowsΒ 

Introducing workflow modules

Workflow Selection

Default Workflows

Workflow Usage

Next Steps



What is an Imagen Media Workflow?Β 

Workflows are primarily used to create renditions of your media assets (i.e. versions of videos that differ in resolution, bitrate, codec, frames per second, language, etc.)

For example, an β€˜Original’ (e.g., high-fidelity MP4 video) file can be used to render an β€˜HLS proxy’ (HTTPS Live Streaming) file that is lightweight and optimised for web playback. You may also want to offer a β€˜mezzanine’ rendition to fit (in quality) somewhere between the HLS proxy and the original file.Β Β Renditions may also include thumbnails, reference images, and still frames used in a timeline (see below). Workflow Screengrab

Workflow options allow watermarks or metadata from database fields to be burned into the media to protect content with logos or other images. Predefined text can also be added during the workflow process to set up rights or contact information.


Transcoder / File ConversionΒ 

Imagen’s Transcoder module can output many kinds of media files, as shown in the diagram below (on the right-hand side of the Transcoder module). It can also work with files having more than one audio track (e.g., background crowd noise or alternative languages) that can be preserved or paired down to a single stereo channel. Whole or short sections of audio can be muted to remove sensitive or inappropriate material.Β 


Custom workflowsΒ 

If you are interested in creating custom workflows, please contact your Imagen contact or support@imagen.io. This guide provides an overview of how a custom workflow could be designed to meet your requirements.

Workflows can be created and changed using a β€œdrag and drop” graphical interface. This allows for a granular definition of parameters in each workflow module, to both transcode and store media. Workflow modules can be connected to automate a complex sequence of processes.


Introducing workflow modules

Workflow modules are the building blocks of a workflow.

Starting with the Media Retriever, the workflow can be configured to return the original file, or a proxy version for additional lower resolution conversions - for web/social media etc. The media may also be retrieved from an external HTTP(s) URL.Β 

The Imagen TranscoderΒ or Image Converter modules can then be used to transform your media once retrieval has been configured (above). Both modules will send the media to the Imagen Transcoder Farm for processing.Β Β 

The Store and Update module will store the output from the Image converter and Transcoder in specified Storage Profiles. It is also possible to send the output straight to your Social Media Accounts.Β 

Audio TranscriptionΒ 


The audio transcription module allows you to leverage Microsoft AI services to transcribe the audio in your media, creating time-based metadata (annotations).Β Β 

Follow this link to learn more about how AI servicesΒ can enhance your media workflow.

Media RetrieverΒ 


Whether the workflow is to retrieve the file from an upload,Β anΒ HTTP(S) transfer - or re-transcoding from a file already stored in Imagen - this module will attempt to pull in the file, starting the workflow.Β Β 

Social Media PublisherΒ 


This workflow plugin can be used to push media to your social media channels (e.g., YouTube and Twitter) for direct publishing.

Store and UpdateΒ 


After transcoding or processing an image, the output files (and original) will need to be stored, and the record will need updating.Β 

Image ConverterΒ 


Our Image converter will allow you to create myriad versions of the original file. This could include a watermark or different resolutions and file types.Β 

Update Record Metadata (Embedded Image Metadata)Β 


If your Images contain embedded metadata, you may want to pull this data into your record metadata.Β 

πŸ“• Further Reading on EXIF metadata

TranscoderΒ 


The Imagen transcoder creates copies of the master fileΒ (renditions). This includes a thumbnail, reference image, HLS media, and video thumbnails.Β Β 

Parameters set on this module give granular control over the output file formats, aspect ratio, bitrate, and even burnt-in timecodes and watermarks. Multiple versions of the same media can be offered to users based on their user permissions.Β 


Workflow Selection

Available Workflows will be displayed at the final stage when uploading media. Workflows that will ingest media (Create renditions) and store the media only (for downloads only - no image displayed on page) are shown below:

Workflow Selection


Β 

Job Priorities

Each workflow will have a priority, where 1 is the highest. If only one transcoder slot is available, and two jobs are requested, the job using the workflow with the highest priority will take precedence over the lower priority job.Β 

⚑Pro tip: This could be used, for example, to prioritise customer clipping order workflows over general ingest workflows

Workflows

Clipping orders - Priority 1

General Ingest - Priority 3

Priority is assigned when a workflow is created:


Default Workflows

The workflows delivered out-of-the-box allow for most media ingestion or clipping. It is possible to add data overlays and burnt-in timecodes, and if this would be helpful please check out custom workflows. The default workflows are shown below

Name Usage Description Β 
Generate key images for Audio
Regenerate key images
Regenerate thumbnail and reference images given changes to media object key frame
Context menu
Ingest Audio
General use
Produces HLS audio
Context menu
Order audio clip
Order
Produces an MP3 for your order
Context menu
Store Only Audio
On ingest
Just store the Audio and extract media object metadata where necessary
Context menu
Generate key images for Document
Regenerate key images
Generates key images for a Document.
Context menu
Store Only Document
On ingest
Just store the Document and extract media object metadata where necessary
Context menu
Ingest Image
General use
Produces a large image, reference image and a thumbnail image
Context menu
Store Only Image
On ingest
Just store the Image and extract media object metadata where necessary
Context menu
Ingest Video
General use
Produces HLS video rendition, thumbnail video rendition, thumbnail stills every 5 seconds as well as a thumbnail and reference image.
Context menu
Order video clip
Order
Produces an MP4 for your order
Context menu
Store Only Video
On ingest
Just store the Video and extract media object metadata where necessary
Context menu
Regenerate key images
Regenerate key images
Regenerate the 'thumbnail', 'thumbnail video' and 'reference images' at the point you choose. By default, this will be the middle frame for Video
Β 

Workflow Usage

Usage Description
On Ingest When storing media and processing no renditions, this is the correct Usage
General use When ingesting media and processing renditions, use this is the correct Usage
Order Produces the correct file type for an Order
Regenerate key images Produces new renditions for the key Images: 'thumbnail', 'thumbnail video' and 'reference images'

Next Steps

πŸ‘‰Β Now you understand records, media objects and workflows, learn how toΒ create a record and Update a Record

    Accessibility πŸ‘Welcome to Imagen!Automated transcription (Speech-to-Text) πŸ‘¨β€πŸŽ“Welcome to Imagen!Developers' Guide πŸ“• πŸ”’Welcome to Imagen!How We Can Help You Onboard Your Content πŸ“•Welcome to Imagen!Introduction to Imagen πŸ“•Welcome to Imagen!Onboarding Guide πŸ“•Welcome to Imagen!The Imagen Transcoder Farm πŸ“•Welcome to Imagen!The Imagen Video Player πŸ“•Welcome to Imagen!Storage Availability πŸ€”Welcome to Imagen!Storage Options πŸ€”Welcome to Imagen!Storage Security πŸ€”Welcome to Imagen!Which Theme Is Right for Me πŸ€”Welcome to Imagen!Why Is User Experience So Important? πŸ€”Welcome to Imagen!Imagen Term Glossary πŸ“°Welcome to Imagen!Supported Browsers πŸ“°Welcome to Imagen!Video Player Keyboard Shortcuts πŸ“°Welcome to Imagen!What is a Media Object Timeline πŸ‘©β€πŸŽ“Welcome to Imagen!Newbie Checklist πŸ‘‹Welcome to Imagen!Activity History ⚑FindGoogle Analytics πŸ‘©β€πŸŽ“FindAdding Annotations to Your Video Content ⚑FindAnnotation Layers πŸ“•FindAnnotations GuideπŸ“•FindExporting Annotations ⚑FindGenerate Subtitles for Audio Content ⚑FindGenerate subtitles for video content ⚑FindGrouping Annotations on Export ⚑FindImagen Subtitle Guide πŸ“•FindReordering Objects Within a Collection πŸ“•FindCustom ReportingFindHow can I see the Open-Source Programming Languages used by Imagen? πŸ€”FindIf I search on the homepage, I get one type of search URL. But I get a different kind of URL on the "Search Results Page" πŸ€”FindMy search results seem out of date ⚠️FindWhat metadata does Imagen extract from my video content? πŸ€”FindImagen Query Language - Media Viewer Widget ⚑FindImagen Query Language Reference πŸ“°FindUnderstanding Imagen Query Language πŸ‘¨β€πŸ«FindArtificial Intelligence ServicesFindDescriptive Metadata Fields πŸ“•FindExtracting Image Metadata on Import ⚑FindField Types and Record SchemaΒ πŸ“•FindImagen Query Language - Related Records View ⚑FindImagen Query Language Guide πŸ“•FindImagen XML Schema Mapping (XSLT) πŸ“•FindSingle/multi-select fields - remote validationFindActivate a Language license ⚑FindChange My Default Language ⚑FindDisplay Multilanguage Annotations ⚑FindHow to configure multilanguage logos ⚑Findlanguage packs πŸ“•FindCreating Parent/Child Field DependenciesFindDeleting RecordsFindRecords & Media Objects πŸ“•FindUpdating Records ⚑FindAdd Fields to the Search Index ⚑FindAdding a filter to the search page ⚑FindAdvanced Search Reference πŸ“°FindSaved Searches πŸ“•FindSearch Index Guide πŸ“•FindUpdating the Imagen Search Index ⚑FindBespoke Ingestion πŸ“•StoreWhat is a 'Watchfolder'? πŸ“•StoreImport from Dropbox ⚑StoreImport from OneDrive ⚑StoreUsing the Record (XML) Import Widget ⚑StoreCan non-media file types still be uploaded to Imagen?πŸ€”StoreCreate a record with media ⚑StoreCreate an empty record with metadata ⚑StoreCreate Imagen XML in Excel πŸ‘©β€πŸŽ“StoreCreateΒ multiple records, each with a single piece of media ⚑StoreImagen Media Workflows πŸ“•StoreImport Media from a URL ⚑StoreMedia Import and Ingestion πŸ“•StoreOptions for Onboarding your Metadata and Media πŸ€”StorePFR (Partial File Restore) and Segments πŸ“•StoreWhat information do you store about my video during ingest? πŸ€”StoreBurnt-in Timecodes (BITC) πŸ“•StoreThe Imagen Image Editor ⚑StoreWatermarking ⚑Store.PDF ViewerStoreAdd a Document Viewer ⚑StoreConfiguring Amazon S3 Intelligent-TieringStoreStorage Costs πŸ“•StoreStorage Profile Reference πŸ“„StoreStorage Replication 🌐StoreSupported File Types πŸ“°StoreConfiguring Amazon S3 Storage TutorialStoreConfiguring Wasabi Storage TutorialStoreStorage LocationsStoreWhy Has My Media Failed to Ingest to Wasabi? πŸ€”StoreConfiguring "Download Profiles" ⚑DistributeInstalling and Using Imagen Accelerated File Delivery (AFD) ⚑DistributeOrdering Clips on Behalf of Other Users πŸ“•DistributeEdit Live Stream Notification Emails ⚑DistributeImagen Live Connect API πŸ“°DistributeAd-hoc PaymentsDistributeIntroduction to Content Licensing πŸ“•DistributePrep: Imagen License and Stripe Accounts ⚑DistributeShopping Basket ConfigurationπŸ“„DistributeShopping BasketsΒ πŸ“•DistributeSubscription Configuration ⚑DistributeSubscription Overview πŸ“•DistributePOST /iweb/v1/notification πŸ“°DistributeAnonymous Sharing Links to Collections (Septeber Release)DistributeCollections πŸ“•DistributeEmbedding Media on External SitesDistributeShare media with unregistered usersDistributeSocial Media PublishingDistributeSunrise/Sunset Dates for Open Access Links ⚑DistributeCreate an MRSS Feed ⚑DistributeImagen Live Connect πŸ“•DistributeImagen MRSS Feed Response πŸ“°DistributeOver the top (OTT) Delivery πŸ“•DistributeBatch Editing Record & Media ACLManageCustom ACLsManageSet When Your Users Can Access Your Content ⚑ManageSetting Default Access Control Lists (ACL) for Records, Media, and Collections ⚑ManageSetting Record & Media Access Control Lists (ACL)ManageWhat are "ACLs"? πŸ€”ManageChanging Your Theme ⚑ManageDisplay banners on your site πŸ‘©β€πŸŽ“ManageI want to add a theme, which is right for me πŸ€”ManagePreview a theme before you commit ⚑ManageAdding Users to Groups ⚑ManageSet Permissions for a Group of Users ⚑ManageDynamic form ⚑ManageImagen Query Language - The Carousel Widget ⚑ManageMap Viewer Widget ⚑ManageWidgets πŸ“•ManageAdobe Premiere Pro IntegrationManageCache Page πŸ“„ManageCookies Page πŸ“°ManageDisplay Fields πŸ“„ManageEmail πŸ“„ManageEnvironment PageπŸ“°ManageFederations πŸ“°ManageGeolocation database πŸ“°ManageGlobal Settings Page πŸ“„ManageHealth Check Page πŸ“°ManageMailing List πŸ“„ManageMaintenance Mode πŸ“„ManageThe Imagen Admin Interface Directory πŸ“‹ (Private)ManageUpdate Page πŸ“°ManageUser Intelligence πŸ“•ManageCreate an OrganisationManageAdding users to user groups through organisations ⚑ManageConfiguring Federated SSO ⚑ManageConfiguring your SSO service provider ⚑ManageGuide to SSO πŸ‘©β€πŸ«ManageI'm being sent back to ImagenWeb from the IDP but I can't get any further πŸ€”ManageCustom Cookie Policy (Javascript) TutorialManageImagen Event ServiceManageBanning a User from Site Access ⚑ManageClear Users That Have Not Been ValidatedManageCreate a Custom Registration ProcessManageCreating Custom Registration FieldsManageCreating request/approval relationships ⚑ManageCustomizing your Login Page ⚑ManageGrant a User Administrator PermissionsManageGrant a User Developer PermissionsManageGranting Site Permissions to an Individual User ⚑ManageGuide to Building Access Control πŸ“•ManageIntroduction to Users, Groups, and Organisations πŸ“•ManageManage Permissions with Imagen πŸ“•ManagePreview Only AccessManageRestrict user sign-ups by geographyManageSetting User Signup RulesManageUser Permissions πŸ“°ManageHow do I add reCAPTCHA to my Imagen siteManageCore REST Interface πŸ“°DevelopersGET /api/v1/endpoints πŸ“°DevelopersGet /core/v1/application πŸ“°DevelopersGET /imcc/v1/job/list πŸ“°DevelopersGET /licenceStatus/πŸ“° WIPDevelopersGET /user/ πŸ“°DevelopersGET history πŸ“°DevelopersGET imcc/v1/job/count πŸ“°DevelopersGET job/searchπŸ“°DevelopersGET rights πŸ“°DevelopersPut /imcc/v1/job πŸ“°DevelopersAuthentication via Signed StringπŸ“°DevelopersHow to authenticate API calls with a Bearer token πŸ“°DevelopersCreating an Application in Imagen ⚑DevelopersGaining a Bearer Token ⚑DevelopersGET /iweb/v1/search πŸ“°DevelopersImagen API Documentation πŸ“• πŸ”’DevelopersGET /iweb/v1/notifications πŸ“°DevelopersGET Profiles πŸ“°DevelopersExample MRSS Reader (Powershell) πŸ“„DevelopersImagen XML Reference πŸ“°DevelopersNew metadata-only record with no media πŸ“°DevelopersNew record with a single piece of media πŸ“°DevelopersNew record with multiple pieces of mediaπŸ“°DevelopersRecord update adding new mediaπŸ“°DevelopersRecord update with metadata only πŸ“°DevelopersSet ACL by XML πŸ“°DevelopersGET /import/record πŸ“°DevelopersGET /iweb/v1/download πŸ“°DevelopersPUT /import/record/ πŸ“°DevelopersCreating a Video Record with the Imagen API πŸ‘©β€πŸ«DevelopersFind the UMID of a media file πŸ‘©β€πŸ«DevelopersHow to find an Import Record (job) GUID πŸ‘©β€πŸ«DevelopersHow to find your Media Control Centre FQDN ⚑ πŸ”’DevelopersHow to find your media ID πŸ‘©β€πŸ«DevelopersHow to Find Your Resource Group Name πŸ‘©β€πŸ«DevelopersProgrammatic API Call Examples πŸ“°DevelopersScopes πŸ“°DevelopersStandard Failure Response πŸ“°DevelopersWhat is a job priority? πŸ‘©β€πŸ«DevelopersDELETE /import/record/ πŸ“°DevelopersDELETE /media πŸ“°DevelopersGET /iweb/v1/users πŸ“°DevelopersWebhooksDevelopersXML Watch Folder Tutorial (Lambda) πŸ”’Partners & InternalDELETE /imcc/v1/media/ πŸ“° πŸ”’Partners & InternalDELETE /imcc/v1/record/ πŸ“° πŸ”’Partners & InternalDELETE imcc/v1/import/record/ πŸ“° πŸ”’Partners & InternalGET imcc/v1/import/record/ πŸ“° πŸ”’Partners & InternalGET imcc/v1/record/search πŸ“° πŸ”’Partners & InternalGET record/validateSearch πŸ“° πŸ”’Partners & InternalPUT imcc/v1/import/record/ πŸ“° πŸ”’Partners & InternalAdd a Video Player ⚑ πŸ”’Partners & InternalAdd an Audio Player ⚑ πŸ”’Partners & InternalAdd an Image Viewer ⚑ πŸ”’Partners & InternalMake a clip from a live feed in progress ⚑ πŸ”’Partners & InternalImagen Deployment Tutorial πŸ”’Partners & InternalWatchfolder Tutorial (Azure Function Media Uploaded Trigger) πŸ”’Partners & InternalWatchfolder Tutorial (Azure Function XML Uploaded Trigger) πŸ”’Partners & InternalOnboarding Playbook πŸ”’Partners & InternalJob and File Status Codes πŸ“„ πŸ”’Partners & InternalAdd a subtitles workflow to Imagen ⚑ πŸ”’Partners & InternalCreate a New Empty Workflow ⚑ πŸ”’Partners & InternalRest Plugin Setup for Vantage Integration πŸ‘©β€πŸ”¬ πŸ”’Partners & InternalWatch Folder With FTPS Tutorial πŸ‘¨β€πŸ« πŸ”’Partners & InternalXML Watch Folder Tutorial (Windows) πŸ”’Partners & Internal