Video Style: ImageKit

Video Style: ImageKit connects Drupal-managed video files to ImageKit for video transformations, remote delivery and poster generation. Editors continue working with Drupal Media, while reusable Video styles control the ImageKit output.

This module is a provider for Video Style. It also works with Responsive Video Style and their optional REST/JSON:API submodules.

Features

• Asynchronous upload of source videos through Drupal's Queue API.
• Video transformations with H.264, VP9 and AV1 output options.
• Configurable dimensions, resize/crop strategy, quality and audio preservation.
• Poster generation with frame timestamp, crop and focus controls.
• Remote poster delivery or asynchronous download into Drupal-managed files.
• Drupal-served original video fallback while remote delivery is unavailable.
• Synchronization status, asynchronous retries and remote cleanup when source files are deleted.
• Configurable binary, Base64 or public-URL upload methods.
• Optional environment ownership protection for remote assets.
• Video dimensions and duration captured from upload metadata when available, plus metadata for locally stored posters.

Getting started

1. Install with composer require drupal/video_style_imagekit. Composer also installs Video Style and the required ImageKit PHP SDK.
2. Enable the module and configure your ImageKit account credentials and URL endpoint in settings.php or settings.local.php.
3. Review the setup and upload settings at Configuration → Media → Video styles → ImageKit.
4. Create a Video style using the ImageKit provider.
5. Use the style in a field formatter, responsive style or API representation.
6. Configure regular cron or queue processing for uploads, poster downloads, retries and cleanup.

Credentials remain in runtime settings rather than exported Drupal configuration. The shared Assets page provides visibility into synchronization and delivery status.

REST and JSON:API

ImageKit delivery is available through Video Style API and Responsive Video Style API. No separate ImageKit API submodule is required.

Enable the appropriate API submodule, expose the desired styles and configure the core transport and Media access. API responses provide delivery URLs, posters, processing states and available metadata. Unknown dimensions and duration remain empty rather than being inferred from configured display sizes.

API reads do not initiate uploads or poster downloads. Use explicit warming or the optional preparation-on-Media-save setting to prepare assets for decoupled delivery.

Scope and GraphQL

This integration is intended for public source videos. It does not provide protected remote delivery for private files; the shared Video Style policy suppresses remote preparation and delivery for those sources.

GraphQL integration is not included. ImageKit delivery can be reused by a custom GraphQL integration through the shared Video Style services.

Documentation and related projects

• Setup and operational documentation
• Video Style
• Responsive Video Style
• Issue queue for bug reports, feature requests and support.

Maintainer

Software Architect & Developer Backend

Sponsorship

The initial implementation of this module was fully sponsored by Helga.

If you are interested in sponsoring additional features, provider integrations, hardening work, or long-term maintenance, please get in touch through the issue queue or maintainer profile.