diff --git a/databox/api/config/services.yaml b/databox/api/config/services.yaml
index 4c13a3c69..b00efb993 100644
--- a/databox/api/config/services.yaml
+++ b/databox/api/config/services.yaml
@@ -131,3 +131,5 @@ services:
             $decorated: '@.inner'
 
     Alchemy\RenditionFactory\Templating\TemplateResolverInterface: '@App\Asset\Attribute\TemplateResolver'
+
+    App\Validator\ValidRenditionDefinitionConstraintValidator: ~
diff --git a/databox/api/src/Command/DocumentationDumperCommand.php b/databox/api/src/Command/DocumentationDumperCommand.php
new file mode 100644
index 000000000..32aded42d
--- /dev/null
+++ b/databox/api/src/Command/DocumentationDumperCommand.php
@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Command;
+
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+use Alchemy\RenditionFactory\RenditionBuilderConfigurationDocumentation;
+
+
+#[AsCommand('app:documentation:dump')]
+class DocumentationDumperCommand extends Command
+{
+    public function __construct(
+        private readonly RenditionBuilderConfigurationDocumentation $renditionBuilderConfigurationDocumentation,
+    )
+    {
+        parent::__construct();
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        $output->writeln('# ' . $this->renditionBuilderConfigurationDocumentation::getName());
+        $output->writeln($this->renditionBuilderConfigurationDocumentation->generate());
+
+        return Command::SUCCESS;
+    }
+}
diff --git a/databox/api/src/Entity/Core/RenditionDefinition.php b/databox/api/src/Entity/Core/RenditionDefinition.php
index e0231b57c..d0df77b6b 100644
--- a/databox/api/src/Entity/Core/RenditionDefinition.php
+++ b/databox/api/src/Entity/Core/RenditionDefinition.php
@@ -5,6 +5,8 @@
 namespace App\Entity\Core;
 
 use Alchemy\CoreBundle\Entity\AbstractUuidEntity;
+use Alchemy\CoreBundle\Entity\Traits\CreatedAtTrait;
+use Alchemy\CoreBundle\Entity\Traits\UpdatedAtTrait;
 use ApiPlatform\Metadata\ApiProperty;
 use ApiPlatform\Metadata\ApiResource;
 use ApiPlatform\Metadata\Delete;
@@ -16,10 +18,8 @@
 use App\Api\Model\Input\RenditionDefinitionInput;
 use App\Api\Provider\RenditionDefinitionCollectionProvider;
 use App\Controller\Core\RenditionDefinitionSortAction;
-
-use Alchemy\CoreBundle\Entity\Traits\CreatedAtTrait;
-use Alchemy\CoreBundle\Entity\Traits\UpdatedAtTrait;
 use App\Entity\Traits\WorkspaceTrait;
+use App\Validator as CustomAssert;
 use Doctrine\Common\Collections\ArrayCollection;
 use Doctrine\Common\Collections\Collection as DoctrineCollection;
 use Doctrine\DBAL\Types\Types;
@@ -153,6 +153,7 @@ class RenditionDefinition extends AbstractUuidEntity implements \Stringable
     #[Groups([RenditionDefinition::GROUP_LIST, RenditionDefinition::GROUP_READ, RenditionDefinition::GROUP_WRITE])]
     #[ORM\Column(type: Types::TEXT, nullable: true)]
     #[ApiProperty(security: self::GRANT_ADMIN_PROP)]
+    #[CustomAssert\ValidRenditionDefinitionConstraint]
     private ?string $definition = null;
 
     #[Groups([RenditionDefinition::GROUP_READ])]
diff --git a/databox/api/src/Validator/ValidRenditionDefinitionConstraint.php b/databox/api/src/Validator/ValidRenditionDefinitionConstraint.php
new file mode 100644
index 000000000..ecf01a68c
--- /dev/null
+++ b/databox/api/src/Validator/ValidRenditionDefinitionConstraint.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Validator;
+
+use Symfony\Component\Validator\Constraint;
+
+/** @uses ValidRenditionDefinitionConstraintValidator */
+#[\Attribute]
+class ValidRenditionDefinitionConstraint extends Constraint
+{
+    public function getTargets(): string|array
+    {
+        return self::PROPERTY_CONSTRAINT;
+    }
+}
diff --git a/databox/api/src/Validator/ValidRenditionDefinitionConstraintValidator.php b/databox/api/src/Validator/ValidRenditionDefinitionConstraintValidator.php
new file mode 100644
index 000000000..496b379f4
--- /dev/null
+++ b/databox/api/src/Validator/ValidRenditionDefinitionConstraintValidator.php
@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Validator;
+
+use Alchemy\RenditionFactory\Config\BuildConfigValidator;
+use Alchemy\RenditionFactory\Config\YamlLoader;
+use Symfony\Component\Validator\Constraint;
+use Symfony\Component\Validator\ConstraintValidator;
+
+class ValidRenditionDefinitionConstraintValidator extends ConstraintValidator
+{
+    /** @uses BuildConfigValidator */
+    public function __construct(private readonly YamlLoader $yamlLoader, private readonly BuildConfigValidator $validator)
+    {
+    }
+
+    /**
+     * @param string $value
+     * @param ValidRenditionDefinitionConstraint $constraint
+     */
+    public function validate($value, Constraint $constraint): void
+    {
+        if(!$value) {
+            return;
+        }
+        try {
+            $config = $this->yamlLoader->parse($value);
+            $this->validator->validate($config);
+        } catch (\Exception $e) {
+            $this->context
+                ->buildViolation($e->getMessage())
+                ->addViolation();
+        }
+    }
+}
diff --git a/lib/php/rendition-factory-bundle/Resources/config/services.yaml b/lib/php/rendition-factory-bundle/Resources/config/services.yaml
index 16dbfd75c..b52b3d83b 100644
--- a/lib/php/rendition-factory-bundle/Resources/config/services.yaml
+++ b/lib/php/rendition-factory-bundle/Resources/config/services.yaml
@@ -4,6 +4,7 @@ services:
         autoconfigure: true
 
     Alchemy\RenditionFactory\Command\CreateCommand: ~
+    Alchemy\RenditionFactory\Command\ConfigurationValidateCommand: ~
 
     Alchemy\RenditionFactory\Context\TransformationContextFactory: ~
     Alchemy\RenditionFactory\FileFamilyGuesser: ~
@@ -44,43 +45,56 @@ services:
         tags:
             - { name: !php/const Alchemy\RenditionFactory\Transformer\TransformerModuleInterface::TAG }
 
-    # FFMpeg "formats"
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\JpegFormat:
+    # Output "formats"
+    Alchemy\RenditionFactory\Transformer\Video\Format\JpegFormat:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\MkvFormat:
+    Alchemy\RenditionFactory\Transformer\Video\Format\MkvFormat:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\Mpeg4Format:
+    Alchemy\RenditionFactory\Transformer\Video\Format\Mpeg4Format:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\MpegFormat:
+    Alchemy\RenditionFactory\Transformer\Video\Format\MpegFormat:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\QuicktimeFormat:
+    Alchemy\RenditionFactory\Transformer\Video\Format\QuicktimeFormat:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\WebmFormat:
+    Alchemy\RenditionFactory\Transformer\Video\Format\WebmFormat:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\AnimatedGifFormat:
+    Alchemy\RenditionFactory\Transformer\Video\Format\AnimatedGifFormat:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\AnimatedPngFormat:
+    Alchemy\RenditionFactory\Transformer\Video\Format\AnimatedPngFormat:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
-    Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\AnimatedWebpFormat:
+    Alchemy\RenditionFactory\Transformer\Video\Format\AnimatedWebpFormat:
         tags:
-            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface::TAG }
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
 
+    Alchemy\RenditionFactory\Transformer\Video\Format\WavFormat:
+        tags:
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
+
+    Alchemy\RenditionFactory\Transformer\Video\Format\AacFormat:
+        tags:
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
+
+    Alchemy\RenditionFactory\Transformer\Video\Format\Mp3Format:
+        tags:
+            - { name: !php/const Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface::TAG }
+
+    Alchemy\RenditionFactory\Transformer\Video\Format\OutputFormatsDocumentation: ~
 
     Imagine\Imagick\Imagine: ~
     Imagine\Image\ImagineInterface: '@Imagine\Imagick\Imagine'
@@ -89,3 +103,7 @@ services:
     Alchemy\RenditionFactory\Format\FormatGuesser: ~
     Alchemy\RenditionFactory\Format\FormatFactory: ~
     Alchemy\RenditionFactory\Config\ModuleOptionsResolver: ~
+
+    Alchemy\RenditionFactory\RenditionBuilderConfigurationDocumentation: ~
+
+    Alchemy\RenditionFactory\Config\BuildConfigValidator: ~
diff --git a/lib/php/rendition-factory/src/Command/ConfigurationValidateCommand.php b/lib/php/rendition-factory/src/Command/ConfigurationValidateCommand.php
new file mode 100644
index 000000000..b52b425bf
--- /dev/null
+++ b/lib/php/rendition-factory/src/Command/ConfigurationValidateCommand.php
@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Alchemy\RenditionFactory\Command;
+
+use Alchemy\RenditionFactory\Config\BuildConfigValidator;
+use Alchemy\RenditionFactory\Config\YamlLoader;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+#[AsCommand('alchemy:rendition-factory:conf:validate')]
+class ConfigurationValidateCommand extends Command
+{
+    public function __construct(
+        private readonly YamlLoader $yamlLoader,
+        private readonly BuildConfigValidator $validator,
+    ) {
+        parent::__construct();
+    }
+
+    protected function configure(): void
+    {
+        parent::configure();
+
+        $this->addArgument('config', InputArgument::REQUIRED, 'A build config YAML file to validate')
+            ->setHelp('Validate a config file.')
+        ;
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        $config = $this->yamlLoader->load($input->getArgument('config'));
+        $this->validator->validate($config);
+
+        $output->writeln('Configuration is valid.');
+
+        return Command::SUCCESS;
+    }
+}
diff --git a/lib/php/rendition-factory/src/Command/CreateCommand.php b/lib/php/rendition-factory/src/Command/CreateCommand.php
index 2317a9ff1..2e88ffbc8 100644
--- a/lib/php/rendition-factory/src/Command/CreateCommand.php
+++ b/lib/php/rendition-factory/src/Command/CreateCommand.php
@@ -45,34 +45,38 @@ protected function configure(): void
 
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
-        $ret = 0;
+        $ret = Command::SUCCESS;
         $src = $input->getArgument('src');
         if (is_dir($src)) {
             if (false === ($od = opendir($src))) {
                 $output->writeln(sprintf('Directory "%s" could not be opened.', $src));
 
-                return 1;
+                return Command::FAILURE;
             }
             while ($f = readdir($od)) {
                 if ('.' === $f || '..' === $f) {
                     continue;
                 }
-                $ret |= $this->doFile($input, $output, $src.'/'.$f);
+                if(false === $this->doFile($input, $output, $src.'/'.$f)) {
+                    $ret = Command::FAILURE;
+                }
             }
             closedir($od);
         } else {
-            $ret = $this->doFile($input, $output, $src);
+            if(false === $this->doFile($input, $output, $src)) {
+                $ret = Command::FAILURE;
+            }
         }
 
         return $ret;
     }
 
-    protected function doFile(InputInterface $input, OutputInterface $output, string $src): int
+    protected function doFile(InputInterface $input, OutputInterface $output, string $src): bool
     {
         if (!file_exists($src)) {
             $output->writeln(sprintf('File "%s" does not exist.', $src));
 
-            return 1;
+            return false;
         }
 
         $time = microtime(true);
@@ -104,7 +108,7 @@ protected function doFile(InputInterface $input, OutputInterface $output, string
         } catch (\InvalidArgumentException $e) {
             $output->writeln(sprintf('<error>%s</error>', $e->getMessage()));
 
-            return 1;
+            return false;
         }
 
         if ($outputPath = $input->getOption('output')) {
@@ -121,7 +125,7 @@ protected function doFile(InputInterface $input, OutputInterface $output, string
         if ($src === $outputFile->getPath()) {
             $output->writeln('No transformation needed');
 
-            return 1;
+            return false;
         }
 
         if (!$input->getOption('debug')) {
@@ -130,6 +134,6 @@ protected function doFile(InputInterface $input, OutputInterface $output, string
 
         $output->writeln(sprintf('Execution time: %0.2f', microtime(true) - $time));
 
-        return 0;
+        return true;
     }
 }
diff --git a/lib/php/rendition-factory/src/Config/BuildConfigValidator.php b/lib/php/rendition-factory/src/Config/BuildConfigValidator.php
new file mode 100644
index 000000000..fb9acdbf2
--- /dev/null
+++ b/lib/php/rendition-factory/src/Config/BuildConfigValidator.php
@@ -0,0 +1,57 @@
+<?php
+
+namespace Alchemy\RenditionFactory\Config;
+
+use Alchemy\RenditionFactory\DTO\BuildConfig\BuildConfig;
+use Alchemy\RenditionFactory\DTO\FamilyEnum;
+use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
+use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException;
+use Symfony\Component\Config\Definition\Processor;
+use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+use Symfony\Component\DependencyInjection\ServiceLocator;
+
+readonly class BuildConfigValidator
+{
+    public function __construct(
+        #[TaggedLocator(TransformerModuleInterface::TAG, defaultIndexMethod: 'getName')]
+        private ServiceLocator $transformers,
+    ) {
+    }
+
+    public function getTransformers(): ServiceLocator
+    {
+        return $this->transformers;
+    }
+
+    public function validate(BuildConfig $config): void
+    {
+        foreach (FamilyEnum::cases() as $family) {
+            $familyConfig = $config->getFamily($family);
+            if (null === $familyConfig) {
+                continue;
+            }
+            foreach ($familyConfig->getTransformations() as $transformation) {
+                $transformerName = $transformation->getModule();
+
+                /** @var TransformerModuleInterface $transformer */
+                $transformer = $this->transformers->get($transformerName);
+
+                try {
+                    $this->checkTransformerConfiguration($transformer, $transformation->toArray());
+                } catch (\Throwable $e) {
+                    $msg = sprintf("Error in module \"%s\"\n%s", $transformerName, $e->getMessage());
+                    throw new InvalidConfigurationException($msg);
+                }
+            }
+        }
+    }
+
+    private function checkTransformerConfiguration(TransformerModuleInterface $transformer, array $options): void
+    {
+        $documentation = $transformer->getDocumentation();
+        $treeBuilder = $documentation->getTreeBuilder();
+
+        $processor = new Processor();
+        $processor->process($treeBuilder->buildTree(), ['root' => $options]);
+    }
+}
diff --git a/lib/php/rendition-factory/src/Config/YamlLoader.php b/lib/php/rendition-factory/src/Config/YamlLoader.php
index 372df8806..bed285f97 100644
--- a/lib/php/rendition-factory/src/Config/YamlLoader.php
+++ b/lib/php/rendition-factory/src/Config/YamlLoader.php
@@ -60,9 +60,7 @@ private function parseFamilyConfig(array $data): FamilyBuildConfig
 
         $transformations = [];
         foreach ($data['transformations'] as $transformation) {
-            if ($transformation['enabled'] ?? true) {
-                $transformations[] = $this->parseTransformation($transformation);
-            }
+            $transformations[] = $this->parseTransformation($transformation);
         }
 
         return new FamilyBuildConfig($transformations, $data['normalization'] ?? []);
@@ -72,6 +70,7 @@ private function parseTransformation(array $transformation): Transformation
     {
         return new Transformation(
             $transformation['module'],
+            $transformation['enabled'] ?? true,
             $transformation['options'] ?? [],
             $transformation['description'] ?? null
         );
diff --git a/lib/php/rendition-factory/src/DTO/BuildConfig/FamilyBuildConfig.php b/lib/php/rendition-factory/src/DTO/BuildConfig/FamilyBuildConfig.php
index 9d4293d0b..68829b05a 100644
--- a/lib/php/rendition-factory/src/DTO/BuildConfig/FamilyBuildConfig.php
+++ b/lib/php/rendition-factory/src/DTO/BuildConfig/FamilyBuildConfig.php
@@ -17,6 +17,13 @@ public function getTransformations(): array
         return $this->transformations;
     }
 
+    public function getEnabledTransformations(): array
+    {
+        return array_filter($this->transformations, function (Transformation $transformation) {
+            return $transformation->isEnabled();
+        });
+    }
+
     public function getNormalization(): array
     {
         return $this->normalization;
diff --git a/lib/php/rendition-factory/src/DTO/BuildConfig/Transformation.php b/lib/php/rendition-factory/src/DTO/BuildConfig/Transformation.php
index e4c8b30ce..90fca1916 100644
--- a/lib/php/rendition-factory/src/DTO/BuildConfig/Transformation.php
+++ b/lib/php/rendition-factory/src/DTO/BuildConfig/Transformation.php
@@ -6,6 +6,7 @@
 {
     public function __construct(
         private string $module,
+        private bool $enabled,
         private array $options,
         private ?string $description,
     ) {
@@ -25,4 +26,19 @@ public function getOptions(): array
     {
         return $this->options;
     }
+
+    public function isEnabled(): bool
+    {
+        return $this->enabled;
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'module' => $this->module,
+            'enabled' => $this->enabled,
+            'options' => $this->options,
+            'description' => $this->description,
+        ];
+    }
 }
diff --git a/lib/php/rendition-factory/src/RenditionBuilderConfigurationDocumentation.php b/lib/php/rendition-factory/src/RenditionBuilderConfigurationDocumentation.php
new file mode 100644
index 000000000..5ff25d4fc
--- /dev/null
+++ b/lib/php/rendition-factory/src/RenditionBuilderConfigurationDocumentation.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace Alchemy\RenditionFactory;
+
+use Alchemy\RenditionFactory\Transformer\Documentation;
+use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
+use Symfony\Component\Config\Definition\Dumper\YamlReferenceDumper;
+use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+use Symfony\Component\DependencyInjection\ServiceLocator;
+
+final readonly class RenditionBuilderConfigurationDocumentation
+{
+    public function __construct(
+        #[TaggedLocator(TransformerModuleInterface::TAG, defaultIndexMethod: 'getName')]
+        private ServiceLocator $transformers,
+    ) {
+    }
+
+    public static function getName(): string
+    {
+        return 'rendition-factory';
+    }
+
+    public function generate(): string
+    {
+        $text = '';
+        foreach ($this->transformers->getProvidedServices() as $transformerName => $transformerFqcn) {
+            /** @var TransformerModuleInterface $transformer */
+            $transformer = $this->transformers->get($transformerName);
+            $text .= $this->getTransformerDocumentation($transformerName, $transformer);
+        }
+
+        return $text;
+    }
+
+    private function getTransformerDocumentation(string $transformerName, TransformerModuleInterface $transformer): string
+    {
+        $docToText = function (Documentation $documentation, int $depth = 0) use (&$docToText): string {
+
+            $text = '';
+            if ($t = $documentation->getHeader()) {
+                $text .= $t."\n";
+            }
+
+            $treeBuilder = $documentation->getTreeBuilder();
+            $node = $treeBuilder->buildTree();
+            $dumper = new YamlReferenceDumper();
+
+            $t = $dumper->dumpNode($node);
+            $t = preg_replace("#^root:($|(\s+)\[]$)#m", "-\n", (string) $t);
+            $t = preg_replace("#\n+#", "\n", $t);
+            $t = trim($t);
+
+            $text .= "```yaml\n".$t."\n```\n";
+
+            if ($t = $documentation->getFooter()) {
+                $text .= $t."\n";
+            }
+
+            foreach ($documentation->getChildren() as $child) {
+                $text .= $docToText($child, $depth + 1);
+            }
+
+            return $text;
+        };
+
+        $documentation = $transformer->getDocumentation();
+
+        return "## `$transformerName` transformer module\n".$docToText($documentation);
+    }
+}
diff --git a/lib/php/rendition-factory/src/RenditionCreator.php b/lib/php/rendition-factory/src/RenditionCreator.php
index 86cea27ef..179a6d879 100644
--- a/lib/php/rendition-factory/src/RenditionCreator.php
+++ b/lib/php/rendition-factory/src/RenditionCreator.php
@@ -43,7 +43,7 @@ public function createRendition(
             NoBuildConfigException::throwNoFamily($inputFile->getFamily()->value, $mimeType);
         }
 
-        $transformations = $familyBuildConfig->getTransformations();
+        $transformations = $familyBuildConfig->getEnabledTransformations();
         if (empty($transformations)) {
             NoBuildConfigException::throwNoTransformation($inputFile->getFamily()->value, $mimeType);
         }
@@ -98,7 +98,7 @@ public function buildHashesDiffer(
                 return true;
             }
 
-            $transformations = $familyBuildConfig->getTransformations();
+            $transformations = $familyBuildConfig->getEnabledTransformations();
             if (empty($transformations)) {
                 return true;
             }
diff --git a/lib/php/rendition-factory/src/Transformer/Document/DocumentToPdfTransformerModule.php b/lib/php/rendition-factory/src/Transformer/Document/DocumentToPdfTransformerModule.php
index e1546d0ea..fb8932ba4 100644
--- a/lib/php/rendition-factory/src/Transformer/Document/DocumentToPdfTransformerModule.php
+++ b/lib/php/rendition-factory/src/Transformer/Document/DocumentToPdfTransformerModule.php
@@ -8,7 +8,10 @@
 use Alchemy\RenditionFactory\DTO\OutputFile;
 use Alchemy\RenditionFactory\DTO\OutputFileInterface;
 use Alchemy\RenditionFactory\Transformer\Document\Libreoffice\PdfConverter;
+use Alchemy\RenditionFactory\Transformer\Documentation;
+use Alchemy\RenditionFactory\Transformer\TransformerConfigHelper;
 use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
 
 final readonly class DocumentToPdfTransformerModule implements TransformerModuleInterface
 {
@@ -17,6 +20,30 @@ public static function getName(): string
         return 'document_to_pdf';
     }
 
+    public function getDocumentation(): Documentation
+    {
+        $treeBuilder = TransformerConfigHelper::createBaseTree(self::getName());
+        $this->buildConfiguration($treeBuilder->getRootNode()->children());
+
+        return new Documentation(
+            $treeBuilder,
+            <<<HEADER
+            **documentation to be done**.
+            HEADER
+        );
+    }
+
+    public function buildConfiguration(NodeBuilder $builder): void
+    {
+        // @formatter:off
+        $builder
+            ->arrayNode('options')
+            ->ignoreExtraKeys(false)
+            ->end()
+        ;
+        // @formatter:on
+    }
+
     public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFileInterface
     {
         if ('application/pdf' === $inputFile->getType()) {
diff --git a/lib/php/rendition-factory/src/Transformer/Document/PdfToImageTransformerModule.php b/lib/php/rendition-factory/src/Transformer/Document/PdfToImageTransformerModule.php
index 0447d9c16..bc03b9013 100644
--- a/lib/php/rendition-factory/src/Transformer/Document/PdfToImageTransformerModule.php
+++ b/lib/php/rendition-factory/src/Transformer/Document/PdfToImageTransformerModule.php
@@ -7,9 +7,12 @@
 use Alchemy\RenditionFactory\DTO\InputFileInterface;
 use Alchemy\RenditionFactory\DTO\OutputFile;
 use Alchemy\RenditionFactory\DTO\OutputFileInterface;
+use Alchemy\RenditionFactory\Transformer\Documentation;
+use Alchemy\RenditionFactory\Transformer\TransformerConfigHelper;
 use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
 use Spatie\PdfToImage\Enums\OutputFormat;
 use Spatie\PdfToImage\Pdf;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
 
 final readonly class PdfToImageTransformerModule implements TransformerModuleInterface
 {
@@ -18,6 +21,30 @@ public static function getName(): string
         return 'pdf_to_image';
     }
 
+    public function getDocumentation(): Documentation
+    {
+        $treeBuilder = TransformerConfigHelper::createBaseTree(self::getName());
+        $this->buildConfiguration($treeBuilder->getRootNode()->children());
+
+        return new Documentation(
+            $treeBuilder,
+            <<<HEADER
+            **documentation to be done**.
+            HEADER
+        );
+    }
+
+    public function buildConfiguration(NodeBuilder $builder): void
+    {
+        // @formatter:off
+        $builder
+            ->arrayNode('options')
+            ->ignoreExtraKeys(false)
+            ->end()
+        ;
+        // @formatter:on
+    }
+
     public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFileInterface
     {
         if ('application/pdf' !== $inputFile->getType()) {
diff --git a/lib/php/rendition-factory/src/Transformer/Documentation.php b/lib/php/rendition-factory/src/Transformer/Documentation.php
new file mode 100644
index 000000000..68a2fe920
--- /dev/null
+++ b/lib/php/rendition-factory/src/Transformer/Documentation.php
@@ -0,0 +1,41 @@
+<?php
+
+namespace Alchemy\RenditionFactory\Transformer;
+
+use Symfony\Component\Config\Definition\Builder\TreeBuilder;
+
+class Documentation
+{
+    /** @var Documentation[] */
+    private array $children;
+
+    public function __construct(private readonly TreeBuilder $treeBuilder, private readonly string $header = '', private readonly string $footer = '')
+    {
+        $this->children = [];
+    }
+
+    public function addChild(Documentation $child): void
+    {
+        $this->children[] = $child;
+    }
+
+    public function getTreeBuilder(): TreeBuilder
+    {
+        return $this->treeBuilder;
+    }
+
+    public function getChildren(): array
+    {
+        return $this->children;
+    }
+
+    public function getHeader(): string
+    {
+        return $this->header;
+    }
+
+    public function getFooter(): string
+    {
+        return $this->footer;
+    }
+}
diff --git a/lib/php/rendition-factory/src/Transformer/Image/Imagine/ImagineTransformerModule.php b/lib/php/rendition-factory/src/Transformer/Image/Imagine/ImagineTransformerModule.php
index e7722e3ef..b5679e802 100644
--- a/lib/php/rendition-factory/src/Transformer/Image/Imagine/ImagineTransformerModule.php
+++ b/lib/php/rendition-factory/src/Transformer/Image/Imagine/ImagineTransformerModule.php
@@ -9,8 +9,11 @@
 use Alchemy\RenditionFactory\DTO\OutputFileInterface;
 use Alchemy\RenditionFactory\MimeType\ImageFormatGuesser;
 use Alchemy\RenditionFactory\Transformer\BuildHashDiffInterface;
+use Alchemy\RenditionFactory\Transformer\Documentation;
+use Alchemy\RenditionFactory\Transformer\TransformerConfigHelper;
 use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
 use Liip\ImagineBundle\Model\FileBinary;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
 
 final readonly class ImagineTransformerModule implements TransformerModuleInterface, BuildHashDiffInterface
 {
@@ -24,6 +27,30 @@ public static function getName(): string
         return 'imagine';
     }
 
+    public function getDocumentation(): Documentation
+    {
+        $treeBuilder = TransformerConfigHelper::createBaseTree(self::getName());
+        $this->buildConfiguration($treeBuilder->getRootNode()->children());
+
+        return new Documentation(
+            $treeBuilder,
+            <<<HEADER
+            **documentation to be done**.
+            HEADER
+        );
+    }
+
+    public function buildConfiguration(NodeBuilder $builder): void
+    {
+        // @formatter:off
+        $builder
+            ->arrayNode('options')
+                ->ignoreExtraKeys(false)
+            ->end()
+        ;
+        // @formatter:on
+    }
+
     public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFileInterface
     {
         $inputFormat = ImageFormatGuesser::getFormat($inputFile->getType());
diff --git a/lib/php/rendition-factory/src/Transformer/TransformerConfigHelper.php b/lib/php/rendition-factory/src/Transformer/TransformerConfigHelper.php
new file mode 100644
index 000000000..d70de0192
--- /dev/null
+++ b/lib/php/rendition-factory/src/Transformer/TransformerConfigHelper.php
@@ -0,0 +1,36 @@
+<?php
+
+namespace Alchemy\RenditionFactory\Transformer;
+
+use Symfony\Component\Config\Definition\Builder\TreeBuilder;
+
+class TransformerConfigHelper
+{
+    /**
+     * helper to create a base tree for a module, including common options.
+     */
+    public static function createBaseTree(string $name): TreeBuilder
+    {
+        $treeBuilder = new TreeBuilder('root');
+        $rootNode = $treeBuilder->getRootNode();
+        // @formatter:off
+        $rootNode
+            ->children()
+                ->scalarNode('module')
+                    ->isRequired()
+                    ->defaultValue($name)
+                ->end()
+                ->scalarNode('description')
+                    ->info('Description of the module action')
+                ->end()
+                ->scalarNode('enabled')
+                    ->defaultTrue()
+                    ->info('Whether to enable this module')
+                ->end()
+            ->end()
+        ;
+        // @formatter:on
+
+        return $treeBuilder;
+    }
+}
diff --git a/lib/php/rendition-factory/src/Transformer/TransformerModuleInterface.php b/lib/php/rendition-factory/src/Transformer/TransformerModuleInterface.php
index 2966c982b..97d703bf3 100644
--- a/lib/php/rendition-factory/src/Transformer/TransformerModuleInterface.php
+++ b/lib/php/rendition-factory/src/Transformer/TransformerModuleInterface.php
@@ -13,4 +13,6 @@ interface TransformerModuleInterface
     public static function getName(): string;
 
     public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFileInterface;
+
+    public function getDocumentation(): Documentation;
 }
diff --git a/lib/php/rendition-factory/src/Transformer/Video/AbstractVideoTransformer.php b/lib/php/rendition-factory/src/Transformer/Video/AbstractVideoTransformer.php
deleted file mode 100644
index bc55d1c62..000000000
--- a/lib/php/rendition-factory/src/Transformer/Video/AbstractVideoTransformer.php
+++ /dev/null
@@ -1,16 +0,0 @@
-<?php
-
-namespace Alchemy\RenditionFactory\Transformer\Video;
-
-use Alchemy\RenditionFactory\Config\ModuleOptionsResolver;
-use Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface;
-use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
-use Symfony\Component\DependencyInjection\ServiceLocator;
-
-abstract readonly class AbstractVideoTransformer
-{
-    public function __construct(#[AutowireLocator(FormatInterface::TAG, defaultIndexMethod: 'getFormat')] protected ServiceLocator $formats,
-        protected ModuleOptionsResolver $optionsResolver,
-    ) {
-    }
-}
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Filter/ResizeFilter.php b/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Filter/ResizeFilter.php
new file mode 100644
index 000000000..d1a18765a
--- /dev/null
+++ b/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Filter/ResizeFilter.php
@@ -0,0 +1,128 @@
+<?php
+
+namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Filter;
+
+use FFMpeg\Coordinate\Dimension;
+use FFMpeg\Exception\RuntimeException;
+use FFMpeg\Filters\Video\VideoFilterInterface;
+use FFMpeg\Format\VideoInterface;
+use FFMpeg\Media\Video;
+
+class ResizeFilter implements VideoFilterInterface
+{
+    /** fits to the dimensions, might introduce anamorphosis */
+    public const RESIZEMODE_FIT = 'fit';
+    /** resizes the video inside the given dimension, no anamorphosis */
+    public const RESIZEMODE_INSET = 'inset';
+    /** resizes the video to fit the dimension width, no anamorphosis */
+    public const RESIZEMODE_SCALE_WIDTH = 'width';
+    /** resizes the video to fit the dimension height, no anamorphosis */
+    public const RESIZEMODE_SCALE_HEIGHT = 'height';
+
+
+    public function __construct(
+        private Dimension $dimension,
+        private string $mode = self::RESIZEMODE_FIT,
+        private bool $forceStandards = true,
+        private int $priority = 0)
+    {
+    }
+
+    public function getPriority(): int
+    {
+        return $this->priority;
+    }
+
+    public function getDimension(): Dimension
+    {
+        return $this->dimension;
+    }
+
+    public function getMode(): string
+    {
+        return $this->mode;
+    }
+
+    public function areStandardsForced(): bool
+    {
+        return $this->forceStandards;
+    }
+
+    public function apply(Video $video, VideoInterface $format): array
+    {
+        $rotation = 0;
+
+        try {
+            $command = [
+                '-loglevel', 'error',
+                '-select_streams', 'v:0',
+                '-print_format', 'json',
+                '-show_entries', 'stream_side_data=rotation',
+                '-i', $video->getPathfile(),
+            ];
+            $r = json_decode($video->getFFProbe()->getFFProbeDriver()->command($command), true, 16, JSON_THROW_ON_ERROR);
+            $rotation = (int) $r['streams'][0]['side_data_list'][0]['rotation'];
+        } catch (\Exception $e) {
+            // ignore (failed to get orientation)
+        }
+
+        $dimensions = null;
+        $commands = [];
+
+        foreach ($video->getStreams() as $stream) {
+            if ($stream->isVideo()) {
+                try {
+                    $dimensions = $stream->getDimensions();
+                    if (90 === $rotation || -90 === $rotation) {
+                        $dimensions = new Dimension($dimensions->getHeight(), $dimensions->getWidth());
+                    }
+                    break;
+                } catch (RuntimeException $e) {
+                }
+            }
+        }
+
+        if (null !== $dimensions) {
+            $dimensions = $this->getComputedDimensions($dimensions, $format->getModulus());
+
+            // Using Filter to have ordering
+            $commands[] = '-vf';
+            $commands[] = '[in]scale='.$dimensions->getWidth().':'.$dimensions->getHeight().' [out]';
+        }
+
+        return $commands;
+    }
+
+    private function getComputedDimensions(Dimension $dimension, $modulus): Dimension
+    {
+        $originalRatio = $dimension->getRatio($this->forceStandards);
+        switch ($this->mode) {
+            case self::RESIZEMODE_SCALE_WIDTH:
+                $height = $this->dimension->getHeight();
+                $width = $originalRatio->calculateWidth($height, $modulus);
+                break;
+            case self::RESIZEMODE_SCALE_HEIGHT:
+                $width = $this->dimension->getWidth();
+                $height = $originalRatio->calculateHeight($width, $modulus);
+                break;
+            case self::RESIZEMODE_INSET:
+                $targetRatio = $this->dimension->getRatio($this->forceStandards);
+
+                if ($targetRatio->getValue() > $originalRatio->getValue()) {
+                    $height = $this->dimension->getHeight();
+                    $width = $originalRatio->calculateWidth($height, $modulus);
+                } else {
+                    $width = $this->dimension->getWidth();
+                    $height = $originalRatio->calculateHeight($width, $modulus);
+                }
+                break;
+            case self::RESIZEMODE_FIT:
+            default:
+                $width = $this->dimension->getWidth();
+                $height = $this->dimension->getHeight();
+                break;
+        }
+
+        return new Dimension($width, $height);
+    }
+}
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpegHelper.php b/lib/php/rendition-factory/src/Transformer/Video/FFMpegHelper.php
index c232e1bc6..225209b59 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpegHelper.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/FFMpegHelper.php
@@ -3,6 +3,7 @@
 namespace Alchemy\RenditionFactory\Transformer\Video;
 
 use FFMpeg;
+use FFMpeg\Coordinate\TimeCode;
 
 class FFMpegHelper
 {
@@ -39,9 +40,35 @@ public static function coordAsText(array $coord): string
     {
         $s = [];
         foreach ($coord as $k => $v) {
-            $s[] = sprintf('%s=%d', $k, $v);
+            $s[] = sprintf('%s=%s', $k, $v);
         }
 
         return '['.implode(', ', $s).']';
     }
+
+    public static function optionAsTimecode($value): ?TimeCode
+    {
+        if (is_numeric($value) && $value >= 0.0) {
+            return TimeCode::fromSeconds($value);
+        } elseif (is_string($value)) {
+            return TimeCode::fromString($value);
+        }
+
+        return null;
+    }
+
+    public static function timecodeToseconds(TimeCode $timecode): float
+    {
+        if (preg_match('/^[0-9]+:[0-9]+:[0-9]+\.[0-9]+$/', (string) $timecode)) {
+            [$hours, $minutes, $seconds, $frames] = sscanf($timecode, '%d:%d:%d.%d');
+        }
+        $s = 0.0;
+
+        $s += $hours * 60 * 60;
+        $s += $minutes * 60;
+        $s += $seconds;
+        $s += $frames / 100;
+
+        return $s;
+    }
 }
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpegTransformerModule.php b/lib/php/rendition-factory/src/Transformer/Video/FFMpegTransformerModule.php
index 854d593e7..f3a2c2396 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpegTransformerModule.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/FFMpegTransformerModule.php
@@ -2,25 +2,358 @@
 
 namespace Alchemy\RenditionFactory\Transformer\Video;
 
+use Alchemy\RenditionFactory\Config\ModuleOptionsResolver;
 use Alchemy\RenditionFactory\Context\TransformationContextInterface;
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use Alchemy\RenditionFactory\DTO\InputFileInterface;
 use Alchemy\RenditionFactory\DTO\OutputFile;
 use Alchemy\RenditionFactory\DTO\OutputFileInterface;
+use Alchemy\RenditionFactory\Transformer\Documentation;
+use Alchemy\RenditionFactory\Transformer\TransformerConfigHelper;
 use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
+use Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Filter\ResizeFilter;
+use Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface;
+use Alchemy\RenditionFactory\Transformer\Video\Format\MkvFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\Mp3Format;
+use Alchemy\RenditionFactory\Transformer\Video\Format\Mpeg4Format;
+use Alchemy\RenditionFactory\Transformer\Video\Format\MpegFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\OutputFormatsDocumentation;
+use Alchemy\RenditionFactory\Transformer\Video\Format\QuicktimeFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\WavFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\WebmFormat;
 use FFMpeg;
 use FFMpeg\Coordinate\TimeCode;
 use FFMpeg\Format\FormatInterface as FFMpegFormatInterface;
 use FFMpeg\Media\Clip;
 use FFMpeg\Media\Video;
-
-final readonly class FFMpegTransformerModule extends AbstractVideoTransformer implements TransformerModuleInterface
+use Imagine\Image\ImagineInterface;
+use Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
+use Symfony\Component\Config\Definition\Builder\TreeBuilder;
+use Symfony\Component\Config\Definition\Exception\InvalidConfigurationException;
+use Symfony\Component\Config\Definition\Processor;
+use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
+use Symfony\Component\DependencyInjection\ServiceLocator;
+
+final readonly class FFMpegTransformerModule implements TransformerModuleInterface
 {
+    public function __construct(#[AutowireLocator(FormatInterface::TAG, defaultIndexMethod: 'getFormat')] private ServiceLocator $formats,
+        private ModuleOptionsResolver $optionsResolver,
+        private ImagineInterface $imagine,
+        private OutputFormatsDocumentation $outputFormatsDocumentation,
+    ) {
+    }
+
     public static function getName(): string
     {
         return 'ffmpeg';
     }
 
+    private static function getSupportedOutputFormats(): array
+    {
+        return [
+            MkvFormat::getFormat(),
+            Mpeg4Format::getFormat(),
+            MpegFormat::getFormat(),
+            QuicktimeFormat::getFormat(),
+            WebmFormat::getFormat(),
+            WavFormat::getFormat(),
+            Mp3Format::getFormat(),
+        ];
+    }
+
+    public function getDocumentation(): Documentation
+    {
+        $treeBuilder = TransformerConfigHelper::createBaseTree(self::getName());
+        $this->buildConfiguration($treeBuilder->getRootNode()->children());
+        $doc = new Documentation(
+            $treeBuilder,
+            <<<HEADER
+            apply filters to a video using FFMpeg.
+            HEADER,
+            $this->outputFormatsDocumentation->listFormats(self::getSupportedOutputFormats()).
+            <<<FOOTER
+            ### List of `ffmpeg` filters:
+            FOOTER
+        );
+
+        foreach ($this->getExtraConfigurationBuilders() as $name => $builder) {
+            $tree = new TreeBuilder('root');
+            $builder($tree->getRootNode());
+            $doc->addChild(new Documentation(
+                $tree,
+                <<<HEADER
+                - `$name` filter
+                HEADER
+            ));
+        }
+
+        return $doc;
+    }
+
+    public function buildConfiguration(NodeBuilder $builder): void
+    {
+        // @formatter:off
+        $builder
+            ->arrayNode('options')
+                ->children()
+                    ->scalarNode('format')
+                        ->info('output format')
+                    ->end()
+                    ->scalarNode('extension')
+                        ->info('extension of the output file')
+                    ->end()
+                    ->scalarNode('video_codec')
+                        ->info('Change the default video codec used by the output format')
+                    ->end()
+                    ->scalarNode('audio_codec')
+                        ->info('Change the default audio codec used by the output format')
+                    ->end()
+                    ->scalarNode('video_kilobitrate')
+                        ->info('Change the default video_kilobitrate used by the output format')
+                    ->end()
+                    ->scalarNode('audio_kilobitrate')
+                        ->info('Change the default audio_kilobitrate used by the output format')
+                    ->end()
+                    ->scalarNode('passes')
+                        ->defaultValue(2)
+                        ->info('Change the number of ffmpeg passes')
+                    ->end()
+                    ->scalarNode('timeout')
+                        ->info('Change the default timeout used by ffmpeg (defaults to symphony process timeout)')
+                    ->end()
+                    ->scalarNode('threads')
+                        ->info('Change the default number of threads used by ffmpeg')
+                    ->end()
+                    ->arrayNode('filters')
+                        ->info('Filters to apply to the video')
+                        ->arrayPrototype()
+                            ->info('see list of available filters below')
+                            ->validate()->always()->then(function ($x) {
+                                $this->validateFilter($x);
+                            })->end()
+                            ->children()
+                                ->scalarNode('name')
+                                    ->isRequired()
+                                    ->info('Name of the filter')
+                                ->end()
+                                ->scalarNode('enabled')
+                                    ->defaultTrue()
+                                    ->info('Whether to enable the filter')
+                                ->end()
+                            ->end()
+                            // false: (undocumented) ignore extra keys on general validation, but do NOT suppress (so the validate..then() can check them)
+                            ->ignoreExtraKeys(false)
+                        ->end()
+                    ->end()
+                ->end()
+            ->end();
+        // @formatter:on
+    }
+
+    private function validateFilter(array $filter): void
+    {
+        $name = $filter['name'];
+        unset($filter['enabled']);
+        if ($builder = $this->getExtraConfigurationBuilders()[$name] ?? null) {
+            $tree = new TreeBuilder($name);
+            $builder($tree->getRootNode());
+            $processor = new Processor();
+            $processor->process($tree->buildTree(), [$name => $filter]);
+        } else {
+            throw new InvalidConfigurationException(sprintf('Unknown filter: %s', $name));
+        }
+    }
+
+    private function getExtraConfigurationBuilders(): iterable
+    {
+        static $configurations = [
+            // @formatter:off
+            'pre_clip' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Clip the video before applying other filters')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('pre_clip')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                        ->scalarNode('start')
+                            ->defaultValue(0)
+                            ->info('Offset of frame in seconds or timecode')
+                            ->example('2.5 ; "00:00:02.500" ; "{{ attr.start }}"')
+                        ->end()
+                        ->scalarNode('duration')
+                            ->defaultValue(null)
+                            ->info('Duration in seconds or timecode')
+                            ->example('30 ; "00:00:30" ; "{{ input.duration/2 }}"')
+                        ->end()
+                    ->end();
+            },
+            'clip' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Clip the video')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('clip')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                        ->scalarNode('start')
+                            ->defaultValue(0)
+                            ->info('Offset of frame in seconds or timecode')
+                            ->example('2.5 ; "00:00:02.500" ; "{{ attr.start }}"')
+                        ->end()
+                        ->scalarNode('duration')
+                            ->defaultValue(null)
+                            ->info('Duration in seconds or timecode')
+                            ->example('30 ; "00:00:30" ; "{{ input.duration/2 }}"')
+                        ->end()
+                    ->end();
+            },
+            'remove_audio' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Remove the audio from the video')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('remove_audio')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                    ->end();
+            },
+            'resize' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Resize the video')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('resize')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                        ->scalarNode('width')
+                            ->isRequired()
+                            ->info('Width of the video')
+                        ->end()
+                        ->scalarNode('height')
+                            ->isRequired()
+                            ->info('Height of the video')
+                        ->end()
+                        ->scalarNode('mode')
+                            ->defaultValue(FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_INSET)
+                            ->info('Resize mode')
+                            ->example('inset')
+                        ->end()
+                            ->scalarNode('force_standards')
+                            ->defaultValue(true)
+                            ->info('Correct the width/height to the closest "standard" size')
+                        ->end()
+                    ->end();
+            },
+            'rotate' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Rotate the video')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('rotate')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                        ->scalarNode('angle')
+                            ->isRequired()
+                            ->info('Angle of rotation [0 | 90 | 180 | 270]')
+                            ->example('90')
+                        ->end()
+                    ->end();
+            },
+            'pad' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Pad the video')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('pad')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                        ->scalarNode('width')
+                            ->isRequired()
+                            ->info('Width of the video')
+                        ->end()
+                        ->scalarNode('height')
+                            ->isRequired()
+                            ->info('Height of the video')
+                        ->end()
+                    ->end();
+            },
+            'crop' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Crop the video')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('crop')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                        ->scalarNode('x')
+                            ->isRequired()
+                            ->info('X coordinate')
+                        ->end()
+                        ->scalarNode('y')
+                            ->isRequired()
+                            ->info('Y coordinate')
+                        ->end()
+                        ->scalarNode('width')
+                            ->isRequired()
+                            ->info('Width of the video')
+                        ->end()
+                        ->scalarNode('height')
+                            ->isRequired()
+                            ->info('Height of the video')
+                        ->end()
+                    ->end();
+            },
+            'watermark' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Apply a watermark on the video')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('watermark')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                        ->scalarNode('position')
+                            ->isRequired()
+                            ->info('"relative" or "absolute" position')
+                        ->end()
+                        ->scalarNode('path')
+                            ->isRequired()
+                            ->info('Path to the watermark image')
+                        ->end()
+                            ->scalarNode('top')
+                            ->info('top coordinate (only if position is "relative", set top OR bottom)')
+                        ->end()
+                            ->scalarNode('bottom')
+                            ->info('bottom coordinate (only if position is "relative", set top OR bottom)')
+                        ->end()
+                        ->scalarNode('left')
+                            ->info('left coordinate (only if position is "relative", set left OR right)')
+                        ->end()
+                        ->scalarNode('right')
+                            ->info('right coordinate (only if position is "relative", set left OR right)')
+                        ->end()
+                        ->scalarNode('x')
+                            ->info('X coordinate (only if position is "absolute")')
+                        ->end()
+                        ->scalarNode('y')
+                            ->info('Y coordinate (only if position is "absolute")')
+                        ->end()
+                    ->end();
+            },
+            'framerate' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('Change the framerate')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('framerate')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                        ->scalarNode('framerate')
+                            ->isRequired()
+                            ->info('framerate')
+                        ->end()
+                        ->scalarNode('gop')
+                            ->info('gop')
+                        ->end()
+                    ->end();
+            },
+            'synchronize' => function (ArrayNodeDefinition $root): void {
+                $root
+                    ->info('re-synchronize audio and video')
+                    ->children()
+                        ->scalarNode('name')->isRequired()->defaultValue('synchronize')->end()
+                        ->scalarNode('enabled')->defaultTrue()->end()
+                    ->end();
+            },
+            // @formatter:on
+        ];
+
+        return $configurations;
+    }
+
     public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFileInterface
     {
         $context->log("Applying '".self::getName()."' module");
@@ -29,14 +362,14 @@ public function transform(InputFileInterface $inputFile, array $options, Transfo
             throw new \InvalidArgumentException('Invalid input file family, should be video');
         }
 
-        $commonArgs = new ModuleCommonArgs($this->formats, $options, $context, $this->optionsResolver);
+        $commonArgs = new ModuleCommonArgs($this->formats, self::getSupportedOutputFormats(), $options, $context, $this->optionsResolver);
 
         if (FamilyEnum::Video === $commonArgs->getOutputFormat()->getFamily()) {
             return $this->doVideo($options, $inputFile, $context, $commonArgs);
         }
 
         if (FamilyEnum::Audio === $commonArgs->getOutputFormat()->getFamily()) {
-            return $this->doAudio($options, $inputFile, $context, $commonArgs);
+            return $this->doVideo($options, $inputFile, $context, $commonArgs);
         }
 
         throw new \InvalidArgumentException(sprintf('Invalid format %s, only video or audio format supported', $commonArgs->getOutputFormat()->getFormat()));
@@ -48,7 +381,7 @@ private function doVideo(array $options, InputFileInterface $inputFile, Transfor
         $format = $outputFormat->getFormat();
 
         if (!method_exists($outputFormat, 'getFFMpegFormat')) {
-            throw new \InvalidArgumentException('format %s does not declare FFMpeg format', $format);
+            throw new \InvalidArgumentException(sprintf('format %s does not declare FFMpeg format', $format));
         }
 
         /** @var FFMpegFormatInterface $FFMpegFormat */
@@ -57,10 +390,8 @@ private function doVideo(array $options, InputFileInterface $inputFile, Transfor
         /** @var Video $video */
         $video = $commonArgs->getFFMpeg()->open($inputFile->getPath());
 
-        $resolverContext = [
-            'metadata' => $transformationContext->getTemplatingContext(),
-            'input' => $video->getStreams()->videos()->first()->all(),
-        ];
+        $resolverContext = $transformationContext->getTemplatingContext();
+        $resolverContext['input'] = $video->getStreams()->videos()->first()->all();
 
         if ($videoCodec = $this->optionsResolver->resolveOption($options['video_codec'] ?? null, $resolverContext)) {
             if (!in_array($videoCodec, $FFMpegFormat->getAvailableVideoCodecs())) {
@@ -126,7 +457,7 @@ function ($filter) use ($resolverContext) {
             }
 
             /* @uses self::resize(), self::rotate(), self::pad(), self::crop(), self::clip(), self::synchronize()
-             *  @uses self::watermark(), self::framerate(), self::remove_audio()
+             * @uses self::watermark(), self::framerate(), self::remove_audio()
              */
             $this->{$filter['name']}($clip, $filter, $resolverContext, $transformationContext, $isProjection);
         }
@@ -151,9 +482,7 @@ function ($filter) use ($resolverContext) {
      */
     private function doAudio(array $options, InputFileInterface $inputFile, TransformationContextInterface $context, ModuleCommonArgs $commonArgs): OutputFileInterface
     {
-        $resolverContext = [
-            'metadata' => $context->getTemplatingContext(),
-        ];
+        $resolverContext = $context->getTemplatingContext();
 
         $format = $commonArgs->getOutputFormat()->getFormat();
         if (!method_exists($commonArgs->getOutputFormat(), 'getFFMpegFormat')) {
@@ -175,37 +504,29 @@ private function doAudio(array $options, InputFileInterface $inputFile, Transfor
     private function preClip(Video $video, array $options, array $resolverContext, TransformationContextInterface $transformationContext, bool &$isProjection): Clip
     {
         $start = $this->optionsResolver->resolveOption($options['start'] ?? 0, $resolverContext);
-        $duration = $this->optionsResolver->resolveOption($options['duration'] ?? null, $resolverContext);
-
-        $startAsTimecode = false;
-        $durationAsTimecode = null;
+        $startAsTimecode = FFMpegHelper::optionAsTimecode($start);
 
-        if (is_numeric($start) && (float) $start >= 0) {
-            $startAsTimecode = TimeCode::fromSeconds($start);
-        } elseif (is_string($start)) {
-            $startAsTimecode = TimeCode::fromString($start);
-        }
-        if (false === $startAsTimecode) {
-            throw new \InvalidArgumentException('Invalid start for filter "clip"');
+        if (null === $startAsTimecode) {
+            throw new \InvalidArgumentException('Invalid start for filter "pre_clip"');
         }
-        if ($startAsTimecode->toSeconds() > 0) {
+        $start = FFMpegHelper::timecodeToseconds($startAsTimecode);
+        if ($start > 0.0) {
             $isProjection = false;
         }
 
+        $duration = $this->optionsResolver->resolveOption($options['duration'] ?? null, $resolverContext);
         if (null !== $duration) {
-            if (is_numeric($duration) && (float) $duration > 0) {
-                $durationAsTimecode = TimeCode::fromSeconds($duration);
-            } elseif (is_string($duration)) {
-                $durationAsTimecode = TimeCode::fromString($duration);
-            }
-            if (false === $durationAsTimecode) {
+            $durationAsTimecode = FFMpegHelper::optionAsTimecode($duration);
+            if (null === $durationAsTimecode) {
                 throw new \InvalidArgumentException('Invalid duration for filter "pre_clip"');
             }
             $isProjection = false;
+            $transformationContext->log(sprintf("  Applying 'pre_clip' filter: start=%s (%.02f), duration=%s (%.02f)", $startAsTimecode, $start, $durationAsTimecode, $duration));
+        } else {
+            $durationAsTimecode = null;
+            $transformationContext->log(sprintf("  Applying 'pre_clip' filter: start=%s (%.02f), duration=null", $startAsTimecode, $start));
         }
 
-        $transformationContext->log(sprintf("  Applying 'pre_clip' filter: start=%s, duration=%s", $startAsTimecode, $durationAsTimecode));
-
         return $video->clip($startAsTimecode, $durationAsTimecode);
     }
 
@@ -220,6 +541,7 @@ private function resize(Clip $clip, array $options, array $resolverContext, Tran
     {
         $dimension = $this->getDimension($options, $resolverContext, 'resize');
         $mode = $this->optionsResolver->resolveOption($options['mode'] ?? FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_INSET, $resolverContext);
+        $forceStandards = $this->optionsResolver->resolveOption($options['force_standards'] ?? true, $resolverContext);
         if (!in_array(
             $mode,
             [
@@ -233,10 +555,7 @@ private function resize(Clip $clip, array $options, array $resolverContext, Tran
         }
 
         $transformationContext->log(sprintf("  Applying 'resize' filter: dimension=[width=%s, height=%s], mode=%s", $dimension->getWidth(), $dimension->getHeight(), $mode));
-        $clip->filters()->resize(
-            $dimension,
-            $mode
-        );
+        $clip->addFilter(new ResizeFilter($dimension, $mode, $forceStandards));
 
         $isProjection = false;
     }
@@ -288,36 +607,29 @@ private function crop(Clip $clip, array $options, array $resolverContext, Transf
     private function clip(Clip $clip, array $options, array $resolverContext, TransformationContextInterface $transformationContext, bool &$isProjection): void
     {
         $start = $this->optionsResolver->resolveOption($options['start'] ?? 0, $resolverContext);
-        $duration = $this->optionsResolver->resolveOption($options['duration'] ?? null, $resolverContext);
-
-        $startAsTimecode = false;
-        $durationAsTimecode = null;
+        $startAsTimecode = FFMpegHelper::optionAsTimecode($start);
 
-        if (is_numeric($start) && (float) $start >= 0) {
-            $startAsTimecode = TimeCode::fromSeconds($start);
-        } elseif (is_string($start)) {
-            $startAsTimecode = TimeCode::fromString($start);
-        }
-        if (false === $startAsTimecode) {
+        if (null === $startAsTimecode) {
             throw new \InvalidArgumentException('Invalid start for filter "clip"');
         }
-        if ($startAsTimecode->toSeconds() > 0) {
+        $start = FFMpegHelper::timecodeToseconds($startAsTimecode);
+        if ($start > 0.0) {
             $isProjection = false;
         }
 
+        $duration = $this->optionsResolver->resolveOption($options['duration'] ?? null, $resolverContext);
         if (null !== $duration) {
-            if (is_numeric($duration) && (float) $duration > 0) {
-                $durationAsTimecode = TimeCode::fromSeconds($duration);
-            } elseif (is_string($duration)) {
-                $durationAsTimecode = TimeCode::fromString($duration);
-            }
-            if (false === $durationAsTimecode) {
-                throw new \InvalidArgumentException('Invalid duration for filter "pre_clip"');
+            $durationAsTimecode = FFMpegHelper::optionAsTimecode($duration);
+            if (null === $durationAsTimecode) {
+                throw new \InvalidArgumentException('Invalid duration for filter "clip"');
             }
             $isProjection = false;
+            $transformationContext->log(sprintf("  Applying 'clip' filter: start=%s (%.02f), duration=%s (%.02f)", $startAsTimecode, $start, $durationAsTimecode, $duration));
+        } else {
+            $durationAsTimecode = null;
+            $transformationContext->log(sprintf("  Applying 'clip' filter: start=%s (%.02f), duration=null", $startAsTimecode, $start));
         }
 
-        $transformationContext->log(sprintf("  Applying 'clip' filter: start=%s, duration=%s", $startAsTimecode, $durationAsTimecode));
         $clip->filters()->clip($startAsTimecode, $durationAsTimecode);
     }
 
@@ -330,6 +642,14 @@ private function synchronize(Clip $clip, array $options, array $resolverContext,
     private function watermark(Clip $clip, array $options, array $resolverContext, TransformationContextInterface $transformationContext, bool &$isProjection): void
     {
         $path = $this->optionsResolver->resolveOption($options['path'] ?? null, $resolverContext);
+        $path = $transformationContext->getRemoteFile($path);
+        $wmImage = $this->imagine->open($path);
+        $wmWidth = $wmImage->getSize()->getWidth();
+        $wmHeight = $wmImage->getSize()->getHeight();
+        unset($wmImage);
+
+        $resolverContext['watermark'] = ['width' => $wmWidth, 'height' => $wmHeight];
+
         if (!file_exists($path)) {
             throw new \InvalidArgumentException('Watermark file for filter "watermark" not found');
         }
@@ -348,6 +668,7 @@ private function watermark(Clip $clip, array $options, array $resolverContext, T
         }
 
         array_walk($coord, fn (&$v) => $v = (int) $this->optionsResolver->resolveOption($v, $resolverContext));
+        $coord['position'] = $position;
 
         $transformationContext->log(sprintf("  Applying 'watermark' filter: path=%s, coord=%s", $path, FFMpegHelper::coordAsText($coord)));
         $clip->filters()->watermark($path, $coord);
@@ -359,7 +680,7 @@ private function framerate(Clip $clip, array $options, array $resolverContext, T
         if ($framerate <= 0) {
             throw new \InvalidArgumentException('Invalid framerate for filter "framerate"');
         }
-        $gop = (int) ($options['gop'] ?? 0);
+        $gop = (int) $this->optionsResolver->resolveOption($options['gop'] ?? 0, $resolverContext);
 
         $transformationContext->log(sprintf("  Applying 'framerate' filter: framerate=%d, gop=%d", $framerate, $gop));
         $clip->filters()->framerate(new FFMpeg\Coordinate\FrameRate($framerate), $gop);
diff --git a/lib/php/rendition-factory/src/Transformer/Video/Format/AacFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/AacFormat.php
new file mode 100644
index 000000000..acb738e29
--- /dev/null
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/AacFormat.php
@@ -0,0 +1,41 @@
+<?php
+
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
+
+use Alchemy\RenditionFactory\DTO\FamilyEnum;
+use Alchemy\RenditionFactory\Transformer\Video\Format\Audio\Aac;
+
+class AacFormat implements FormatInterface
+{
+    private Aac $format;
+
+    public function __construct()
+    {
+        $this->format = new Aac();
+    }
+
+    public static function getAllowedExtensions(): array
+    {
+        return ['aac', 'm4a'];
+    }
+
+    public static function getMimeType(): string
+    {
+        return 'audio/aac';
+    }
+
+    public static function getFormat(): string
+    {
+        return 'audio-aac';
+    }
+
+    public static function getFamily(): FamilyEnum
+    {
+        return FamilyEnum::Audio;
+    }
+
+    public function getFFMpegFormat(): Aac
+    {
+        return $this->format;
+    }
+}
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedGifFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedGifFormat.php
similarity index 87%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedGifFormat.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedGifFormat.php
index 8237387f9..e5c3efa0b 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedGifFormat.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedGifFormat.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedPngFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedPngFormat.php
similarity index 87%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedPngFormat.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedPngFormat.php
index f61785e90..080dfe4aa 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedPngFormat.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedPngFormat.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedWebpFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedWebpFormat.php
similarity index 87%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedWebpFormat.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedWebpFormat.php
index ddddf8df7..5528addc5 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/AnimatedWebpFormat.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/AnimatedWebpFormat.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 
diff --git a/lib/php/rendition-factory/src/Transformer/Video/Format/Audio/Aac.php b/lib/php/rendition-factory/src/Transformer/Video/Format/Audio/Aac.php
new file mode 100644
index 000000000..366235b40
--- /dev/null
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/Audio/Aac.php
@@ -0,0 +1,25 @@
+<?php
+
+/*
+ * This file replaces FFMpeg\Format\Audio\aac because alpine lacks libfdk
+ */
+
+namespace Alchemy\RenditionFactory\Transformer\Video\Format\Audio;
+
+use FFMpeg\Format\Audio\DefaultAudio;
+
+/**
+ * The AAC audio format.
+ */
+class Aac extends DefaultAudio
+{
+    public function __construct()
+    {
+        $this->audioCodec = 'aac';
+    }
+
+    public function getAvailableAudioCodecs()
+    {
+        return ['aac'];
+    }
+}
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/FormatInterface.php b/lib/php/rendition-factory/src/Transformer/Video/Format/FormatInterface.php
similarity index 84%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/FormatInterface.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/FormatInterface.php
index e8fc07895..8a587617a 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/FormatInterface.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/FormatInterface.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/JpegFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/JpegFormat.php
similarity index 87%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/JpegFormat.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/JpegFormat.php
index 0ae0b44c6..de2dc4a38 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/JpegFormat.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/JpegFormat.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/MkvFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/MkvFormat.php
similarity index 91%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/MkvFormat.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/MkvFormat.php
index 0cab40629..7d48ed7fd 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/MkvFormat.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/MkvFormat.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use FFMpeg\Format\Video\X264;
diff --git a/lib/php/rendition-factory/src/Transformer/Video/Format/Mp3Format.php b/lib/php/rendition-factory/src/Transformer/Video/Format/Mp3Format.php
new file mode 100644
index 000000000..2e9e5db9f
--- /dev/null
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/Mp3Format.php
@@ -0,0 +1,41 @@
+<?php
+
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
+
+use Alchemy\RenditionFactory\DTO\FamilyEnum;
+use FFMpeg\Format\Audio\Mp3;
+
+class Mp3Format implements FormatInterface
+{
+    private Mp3 $format;
+
+    public function __construct()
+    {
+        $this->format = new Mp3();
+    }
+
+    public static function getAllowedExtensions(): array
+    {
+        return ['mp3'];
+    }
+
+    public static function getMimeType(): string
+    {
+        return 'audio/mp3';
+    }
+
+    public static function getFormat(): string
+    {
+        return 'audio-mp3';
+    }
+
+    public static function getFamily(): FamilyEnum
+    {
+        return FamilyEnum::Audio;
+    }
+
+    public function getFFMpegFormat(): Mp3
+    {
+        return $this->format;
+    }
+}
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/Mpeg4Format.php b/lib/php/rendition-factory/src/Transformer/Video/Format/Mpeg4Format.php
similarity index 91%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/Mpeg4Format.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/Mpeg4Format.php
index 6280581d3..72f9301dc 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/Mpeg4Format.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/Mpeg4Format.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use FFMpeg\Format\Video\X264;
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/MpegFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/MpegFormat.php
similarity index 91%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/MpegFormat.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/MpegFormat.php
index 914fcb3e5..ae22f80cc 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/MpegFormat.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/MpegFormat.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use FFMpeg\Format\Video\X264;
diff --git a/lib/php/rendition-factory/src/Transformer/Video/Format/OutputFormatsDocumentation.php b/lib/php/rendition-factory/src/Transformer/Video/Format/OutputFormatsDocumentation.php
new file mode 100644
index 000000000..452af32ba
--- /dev/null
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/OutputFormatsDocumentation.php
@@ -0,0 +1,51 @@
+<?php
+
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
+
+use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+use Symfony\Component\DependencyInjection\ServiceLocator;
+
+class OutputFormatsDocumentation
+{
+    public function __construct(
+        #[TaggedLocator(FormatInterface::TAG, defaultIndexMethod: 'getFormat')]
+        private readonly ServiceLocator $formats,
+    ) {
+    }
+
+    public function listFormats(array $supportedFormats): string
+    {
+        $formats = [];
+        foreach ($this->formats->getProvidedServices() as $formatName => $formatFqcn) {
+            if (!in_array($formatName, $supportedFormats)) {
+                continue;
+            }
+            /** @var FormatInterface $format */
+            $format = $this->formats->get($formatName);
+            $family = $format->getFamily()->value;
+            if (!array_key_exists($family, $formats)) {
+                $formats[$family] = [];
+            }
+            $formats[$family][] = $format;
+        }
+        ksort($formats);
+
+        $text = "### Supported output `format`s.\n";
+        $text .= "| Family | Format | Mime type | Extensions |\n";
+        $text .= "|-|-|-|-|\n";
+        foreach ($formats as $familyFormats) {
+            $text .= sprintf("| %s ||||\n",
+                $familyFormats[0]->getFamily()->value,
+            );
+            foreach ($familyFormats as $format) {
+                $text .= sprintf("|| %s | %s | %s |\n",
+                    $format->getFormat(),
+                    $format->getMimeType(),
+                    implode(', ', $format->getAllowedExtensions())
+                );
+            }
+        }
+
+        return $text;
+    }
+}
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/QuicktimeFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/QuicktimeFormat.php
similarity index 91%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/QuicktimeFormat.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/QuicktimeFormat.php
index 951e10bed..07c9f99c8 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/QuicktimeFormat.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/QuicktimeFormat.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use FFMpeg\Format\Video\X264;
diff --git a/lib/php/rendition-factory/src/Transformer/Video/Format/WavFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/WavFormat.php
new file mode 100644
index 000000000..ccd8cf393
--- /dev/null
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/WavFormat.php
@@ -0,0 +1,41 @@
+<?php
+
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
+
+use Alchemy\RenditionFactory\DTO\FamilyEnum;
+use FFMpeg\Format\Audio\Wav;
+
+class WavFormat implements FormatInterface
+{
+    private Wav $format;
+
+    public function __construct()
+    {
+        $this->format = new Wav();
+    }
+
+    public static function getAllowedExtensions(): array
+    {
+        return ['wav'];
+    }
+
+    public static function getMimeType(): string
+    {
+        return 'audio/wav';
+    }
+
+    public static function getFormat(): string
+    {
+        return 'audio-wav';
+    }
+
+    public static function getFamily(): FamilyEnum
+    {
+        return FamilyEnum::Audio;
+    }
+
+    public function getFFMpegFormat(): Wav
+    {
+        return $this->format;
+    }
+}
diff --git a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/WebmFormat.php b/lib/php/rendition-factory/src/Transformer/Video/Format/WebmFormat.php
similarity index 91%
rename from lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/WebmFormat.php
rename to lib/php/rendition-factory/src/Transformer/Video/Format/WebmFormat.php
index e9f98cd6a..566595992 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/FFMpeg/Format/WebmFormat.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/Format/WebmFormat.php
@@ -1,6 +1,6 @@
 <?php
 
-namespace Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format;
+namespace Alchemy\RenditionFactory\Transformer\Video\Format;
 
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use FFMpeg\Format\Video\WebM;
diff --git a/lib/php/rendition-factory/src/Transformer/Video/ModuleCommonArgs.php b/lib/php/rendition-factory/src/Transformer/Video/ModuleCommonArgs.php
index c9a275563..ece3860ad 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/ModuleCommonArgs.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/ModuleCommonArgs.php
@@ -4,7 +4,7 @@
 
 use Alchemy\RenditionFactory\Config\ModuleOptionsResolver;
 use Alchemy\RenditionFactory\Context\TransformationContextInterface;
-use Alchemy\RenditionFactory\Transformer\Video\FFMpeg\Format\FormatInterface;
+use Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface;
 use FFMpeg;
 use Symfony\Component\DependencyInjection\ServiceLocator;
 
@@ -16,19 +16,18 @@ class ModuleCommonArgs
 
     public function __construct(
         ServiceLocator $formats,
+        array $supportedOutputFormats,
         array $options,
         TransformationContextInterface $context,
         ModuleOptionsResolver $optionsResolver)
     {
-        $resolverContext = [
-            'metadata' => $context->getTemplatingContext(),
-        ];
+        $resolverContext = $context->getTemplatingContext();
 
         $format = $optionsResolver->resolveOption($options['format'] ?? null, $resolverContext);
         if (!$format) {
             throw new \InvalidArgumentException('Missing format');
         }
-        if (!$formats->has($format)) {
+        if (!$formats->has($format) || !in_array($format, $supportedOutputFormats)) {
             throw new \InvalidArgumentException(sprintf('Invalid format %s', $format));
         }
 
diff --git a/lib/php/rendition-factory/src/Transformer/Video/VideoSummaryTransformerModule.php b/lib/php/rendition-factory/src/Transformer/Video/VideoSummaryTransformerModule.php
index afb172340..969fb8486 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/VideoSummaryTransformerModule.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/VideoSummaryTransformerModule.php
@@ -2,25 +2,118 @@
 
 namespace Alchemy\RenditionFactory\Transformer\Video;
 
+use Alchemy\RenditionFactory\Config\ModuleOptionsResolver;
 use Alchemy\RenditionFactory\Context\TransformationContextInterface;
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use Alchemy\RenditionFactory\DTO\InputFileInterface;
 use Alchemy\RenditionFactory\DTO\OutputFile;
 use Alchemy\RenditionFactory\DTO\OutputFileInterface;
+use Alchemy\RenditionFactory\Transformer\Documentation;
+use Alchemy\RenditionFactory\Transformer\TransformerConfigHelper;
 use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
+use Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface;
+use Alchemy\RenditionFactory\Transformer\Video\Format\MkvFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\Mpeg4Format;
+use Alchemy\RenditionFactory\Transformer\Video\Format\MpegFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\OutputFormatsDocumentation;
+use Alchemy\RenditionFactory\Transformer\Video\Format\QuicktimeFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\WebmFormat;
 use FFMpeg;
 use FFMpeg\Coordinate\TimeCode;
 use FFMpeg\Format\VideoInterface;
+use Imagine\Image\ImagineInterface;
 use Psr\Container\ContainerExceptionInterface;
 use Psr\Container\NotFoundExceptionInterface;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
+use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
+use Symfony\Component\DependencyInjection\ServiceLocator;
 
-final readonly class VideoSummaryTransformerModule extends AbstractVideoTransformer implements TransformerModuleInterface
+final readonly class VideoSummaryTransformerModule implements TransformerModuleInterface
 {
+    public function __construct(#[AutowireLocator(FormatInterface::TAG, defaultIndexMethod: 'getFormat')] private ServiceLocator $formats,
+        private ModuleOptionsResolver $optionsResolver,
+        private ImagineInterface $imagine,
+        private OutputFormatsDocumentation $outputFormatsDocumentation,
+    ) {
+    }
+
     public static function getName(): string
     {
         return 'video_summary';
     }
 
+    private static function getSupportedOutputFormats(): array
+    {
+        return [
+            MkvFormat::getFormat(),
+            Mpeg4Format::getFormat(),
+            MpegFormat::getFormat(),
+            QuicktimeFormat::getFormat(),
+            WebmFormat::getFormat(),
+        ];
+    }
+
+    public function getDocumentation(): Documentation
+    {
+        $treeBuilder = TransformerConfigHelper::createBaseTree(self::getName());
+        $this->buildConfiguration($treeBuilder->getRootNode()->children());
+
+        return new Documentation(
+            $treeBuilder,
+            <<<HEADER
+            Assemble multiple extracts (clips) of the video.
+            HEADER,
+            $this->outputFormatsDocumentation->listFormats(self::getSupportedOutputFormats()),
+        );
+    }
+
+    public function buildConfiguration(NodeBuilder $builder): void
+    {
+        // @formatter:off
+        $builder
+            ->arrayNode('options')
+                ->children()
+                    ->scalarNode('start')
+                        ->defaultValue(0)
+                        ->info('Skip video start, in seconds or timecode')
+                        ->example('2.5 ; "00:00:02.50" ; "{{ attr.start }}"')
+                    ->end()
+                    ->scalarNode('period')
+                        ->isRequired()
+                        ->info('Extract one video clip every period, in seconds or timecode')
+                        ->example('5 ; "00:00:05.00"')
+                    ->end()
+                    ->scalarNode('duration')
+                        ->isRequired()
+                        ->info('Duration of each clip, in seconds or timecode')
+                        ->example('0.25 ; "00:00:00.25"')
+                   ->end()
+                   ->scalarNode('format')
+                        ->isRequired()
+                        ->info('output format')
+                        ->example('video-mpeg')
+                   ->end()
+                    ->scalarNode('extension')
+                        ->defaultValue('default extension from format')
+                        ->info('extension of the output file')
+                        ->example('mpeg')
+                    ->end()
+                    ->scalarNode('passes')
+                        ->defaultValue(2)
+                        ->info('Change the number of ffmpeg passes')
+                    ->end()
+                        ->scalarNode('timeout')
+                        ->info('Change the default timeout used by ffmpeg (defaults to symphony process timeout)')
+                    ->end()
+                    ->scalarNode('threads')
+                        ->info('Change the default number of threads used by ffmpeg')
+                    ->end()
+                ->end()
+            ->end()
+        ;
+        // @formatter:on
+    }
+
     /**
      * @throws ContainerExceptionInterface
      * @throws NotFoundExceptionInterface
@@ -33,77 +126,131 @@ public function transform(InputFileInterface $inputFile, array $options, Transfo
             throw new \InvalidArgumentException('Invalid input file family, should be video');
         }
 
-        $commonArgs = new ModuleCommonArgs($this->formats, $options, $context, $this->optionsResolver);
+        $commonArgs = new ModuleCommonArgs($this->formats, self::getSupportedOutputFormats(), $options, $context, $this->optionsResolver);
         $outputFormat = $commonArgs->getOutputFormat();
         $format = $outputFormat->getFormat();
 
         /** @var FFMpeg\Media\Video $video */
         $video = $commonArgs->getFFMpeg()->open($inputFile->getPath());
 
-        $resolverContext = [
-            'metadata' => $context->getTemplatingContext(),
-            'input' => $video->getStreams()->videos()->first()->all(),
-        ];
+        $resolverContext = $context->getTemplatingContext();
+        $resolverContext['input'] = $video->getStreams()->videos()->first()->all();
 
         $period = $this->optionsResolver->resolveOption($options['period'] ?? 0, $resolverContext);
-        if ($period <= 0) {
+        $periodAsTimecode = FFMpegHelper::optionAsTimecode($period);
+        if (null === $periodAsTimecode || ($period = FFMpegHelper::timecodeToseconds($periodAsTimecode)) <= 0) {
             throw new \InvalidArgumentException(sprintf('Invalid period for module "%s"', self::getName()));
         }
+
+        $start = $this->optionsResolver->resolveOption($options['start'] ?? 0, $resolverContext);
+        $startAsTimecode = FFMpegHelper::optionAsTimecode($start);
+        if (null === $startAsTimecode || ($start = FFMpegHelper::timecodeToseconds($startAsTimecode)) < 0) {
+            throw new \InvalidArgumentException('Invalid start');
+        }
+
         $clipDuration = $this->optionsResolver->resolveOption($options['duration'] ?? 0, $resolverContext);
-        if ($clipDuration <= 0 || $clipDuration >= $period) {
-            throw new \InvalidArgumentException(sprintf('Invalid duration for module "%s"', self::getName()));
+        $clipDurationAsTimecode = FFMpegHelper::optionAsTimecode($clipDuration);
+        if (null === $clipDurationAsTimecode || ($clipDuration = FFMpegHelper::timecodeToseconds($clipDurationAsTimecode)) <= 0 || $clipDuration >= $period) {
+            throw new \InvalidArgumentException('Invalid duration, should be >0 and <period');
         }
 
-        $context->log(sprintf('  period: %d, duration: %d', $period, $clipDuration));
+        $context->log(sprintf('  start=%s (%.02f), period=%s (%.02f), duration=%s (%.02f)', $startAsTimecode, $start, $periodAsTimecode, $period, $clipDurationAsTimecode, $clipDuration));
+
+        $inputDuration = $video->getFFProbe()->format($inputFile->getPath())->get('duration');
 
-        /** @var VideoInterface $FFMpegOutputFormat */
-        $FFMpegOutputFormat = $outputFormat->getFFMpegFormat();
-        if ($videoCodec = $this->optionsResolver->resolveOption($options['video_codec'] ?? null, $resolverContext)) {
-            if (!in_array($videoCodec, $FFMpegOutputFormat->getAvailableVideoCodecs())) {
-                throw new \InvalidArgumentException(sprintf('Invalid video codec %s for format %s', $videoCodec, $format));
+        if (FamilyEnum::Video === $outputFormat->getFamily()) {
+            /** @var VideoInterface $FFMpegOutputFormat */
+            $FFMpegOutputFormat = $outputFormat->getFFMpegFormat();
+            if ($videoCodec = $this->optionsResolver->resolveOption($options['video_codec'] ?? null, $resolverContext)) {
+                if (!in_array($videoCodec, $FFMpegOutputFormat->getAvailableVideoCodecs())) {
+                    throw new \InvalidArgumentException(sprintf('Invalid video codec %s for format %s', $videoCodec, $format));
+                }
+                $FFMpegOutputFormat->setVideoCodec($videoCodec);
             }
-            $FFMpegOutputFormat->setVideoCodec($videoCodec);
-        }
-        if ($audioCodec = $this->optionsResolver->resolveOption($options['audio_codec'] ?? null, $resolverContext)) {
-            if (!in_array($audioCodec, $FFMpegOutputFormat->getAvailableAudioCodecs())) {
-                throw new \InvalidArgumentException(sprintf('Invalid audio codec %s for format %s', $audioCodec, $format));
+            if ($audioCodec = $this->optionsResolver->resolveOption($options['audio_codec'] ?? null, $resolverContext)) {
+                if (!in_array($audioCodec, $FFMpegOutputFormat->getAvailableAudioCodecs())) {
+                    throw new \InvalidArgumentException(sprintf('Invalid audio codec %s for format %s', $audioCodec, $format));
+                }
+                $FFMpegOutputFormat->setAudioCodec($audioCodec);
             }
-            $FFMpegOutputFormat->setAudioCodec($audioCodec);
-        }
 
-        $clipsExtension = $outputFormat->getAllowedExtensions()[0];
-
-        $clipsFiles = [];
-        try {
-            $inputDuration = $video->getFFProbe()->format($inputFile->getPath())->get('duration');
-            $nClips = ceil($inputDuration / $period);
-
-            $context->log(sprintf('  Duration duration: %s, extracting %d clips of %d seconds', $inputDuration, $nClips, $clipDuration));
-            $clipDuration = TimeCode::fromSeconds($clipDuration);
-            $removeAudioFilter = new FFMpeg\Filters\Audio\SimpleFilter(['-an']);
-            for ($i = 0; $i < $nClips; ++$i) {
-                $start = $i * $period;
-                $clip = $video->clip(TimeCode::fromSeconds($start), $clipDuration);
-                $clip->addFilter($removeAudioFilter);
-                $clipPath = $context->createTmpFilePath($clipsExtension);
-                $clip->save($FFMpegOutputFormat, $clipPath);
-                unset($clip);
-                $clipsFiles[] = realpath($clipPath);
+            $clipsExtension = $commonArgs->getExtension();
+
+            try {
+                $clipsFiles = [];
+                $gap = $period - $clipDuration;
+                $usableInputDuration = ($inputDuration - $start) + $gap;
+                $nClips = floor($usableInputDuration / $period);
+
+                $context->log(sprintf('  Video duration=%.02f, extracting %d clips of %.02f seconds from %s', $inputDuration, $nClips, $clipDuration, $startAsTimecode));
+                $removeAudioFilter = new FFMpeg\Filters\Audio\SimpleFilter(['-an']);
+                for ($i = 0; $i < $nClips; ++$i) {
+                    $startAsTimecode = TimeCode::fromSeconds($start);
+                    $context->log(sprintf('  - Extracting clip %d/%d, start=%s (%.02f)', $i + 1, $nClips, $startAsTimecode, $start));
+                    $clip = $video->clip($startAsTimecode, $clipDurationAsTimecode);
+                    $clip->addFilter($removeAudioFilter);
+                    $clipPath = $context->createTmpFilePath($clipsExtension);
+                    $clip->save($FFMpegOutputFormat, $clipPath);
+                    unset($clip);
+                    $clipsFiles[] = realpath($clipPath);
+                    $start += $period;
+                }
+                unset($removeAudioFilter, $video);
+
+                $outVideo = $commonArgs->getFFMpeg()->open($clipsFiles[0]);
+
+                $outputPath = $context->createTmpFilePath($commonArgs->getExtension());
+
+                $outVideo
+                    ->concat($clipsFiles)
+                    ->saveFromSameCodecs($outputPath, true);
+
+                unset($outVideo);
+            } finally {
+                foreach ($clipsFiles as $clipFile) {
+                    @unlink($clipFile);
+                }
             }
-            unset($removeAudioFilter, $video);
+        } elseif (FamilyEnum::Animation === $outputFormat->getFamily()) {
+            $clipsExtension = $commonArgs->getExtension();
+            try {
+                $clipsFiles = [];
+                $usableInputDuration = ($inputDuration - $start);
+                $nClips = floor($usableInputDuration / $period);
+
+                $context->log(sprintf('  Video duration=%.02f, extracting %d frames from %s', $inputDuration, $nClips, $startAsTimecode));
+
+                for ($i = 0; $i < $nClips; ++$i) {
+                    $startAsTimecode = TimeCode::fromSeconds($start);
+                    $context->log(sprintf('  - Extracting frame %d/%d, start=%s (%.02f)', $i + 1, $nClips, $startAsTimecode, $start));
+
+                    $frame = $video->frame($startAsTimecode);
+                    $clipPath = $context->createTmpFilePath($clipsExtension);
+                    $frame->save($clipPath);
+                    unset($clip);
+                    $clipsFiles[] = realpath($clipPath);
 
-            $outVideo = $commonArgs->getFFMpeg()->open($clipsFiles[0]);
+                    $start += $period;
+                }
+                unset($video);
 
-            $outputPath = $context->createTmpFilePath($commonArgs->getExtension());
+                $image = $this->imagine->open(array_shift($clipsFiles));
+                foreach ($clipsFiles as $file) {
+                    $image->layers()->add($this->imagine->open($file));
+                }
 
-            $outVideo
-                ->concat($clipsFiles)
-                ->saveFromSameCodecs($outputPath, true);
+                $outputPath = $context->createTmpFilePath($commonArgs->getExtension());
+                $delay = (int) ($clipDuration * 1000);
+                $image->save($outputPath, [
+                    'animated' => true,
+                    'animated.delay' => $delay,
+                    'animated.loops' => 0,
+                ]);
 
-            unset($outVideo);
-        } finally {
-            foreach ($clipsFiles as $clipFile) {
-                @unlink($clipFile);
+            } finally {
+                foreach ($clipsFiles as $clipFile) {
+                    @unlink($clipFile);
+                }
             }
         }
 
diff --git a/lib/php/rendition-factory/src/Transformer/Video/VideoToAnimationTransformerModule.php b/lib/php/rendition-factory/src/Transformer/Video/VideoToAnimationTransformerModule.php
index 1eefdc96b..b15a82af2 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/VideoToAnimationTransformerModule.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/VideoToAnimationTransformerModule.php
@@ -2,22 +2,125 @@
 
 namespace Alchemy\RenditionFactory\Transformer\Video;
 
+use Alchemy\RenditionFactory\Config\ModuleOptionsResolver;
 use Alchemy\RenditionFactory\Context\TransformationContextInterface;
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use Alchemy\RenditionFactory\DTO\InputFileInterface;
 use Alchemy\RenditionFactory\DTO\OutputFile;
 use Alchemy\RenditionFactory\DTO\OutputFileInterface;
+use Alchemy\RenditionFactory\Transformer\Documentation;
+use Alchemy\RenditionFactory\Transformer\TransformerConfigHelper;
 use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
+use Alchemy\RenditionFactory\Transformer\Video\Format\AnimatedGifFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\AnimatedPngFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\AnimatedWebpFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface;
+use Alchemy\RenditionFactory\Transformer\Video\Format\OutputFormatsDocumentation;
 use FFMpeg;
-use FFMpeg\Coordinate\TimeCode;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
+use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
+use Symfony\Component\DependencyInjection\ServiceLocator;
 
-final readonly class VideoToAnimationTransformerModule extends AbstractVideoTransformer implements TransformerModuleInterface
+final readonly class VideoToAnimationTransformerModule implements TransformerModuleInterface
 {
+    public function __construct(#[AutowireLocator(FormatInterface::TAG, defaultIndexMethod: 'getFormat')] private ServiceLocator $formats,
+        private ModuleOptionsResolver $optionsResolver,
+        private OutputFormatsDocumentation $outputFormatsDocumentation,
+    ) {
+    }
+
     public static function getName(): string
     {
         return 'video_to_animation';
     }
 
+    private static function getSupportedOutputFormats(): array
+    {
+        return [
+            AnimatedGifFormat::getFormat(),
+            AnimatedPngFormat::getFormat(),
+            AnimatedWebpFormat::getFormat(),
+        ];
+    }
+
+    public function getDocumentation(): Documentation
+    {
+        $treeBuilder = TransformerConfigHelper::createBaseTree(self::getName());
+        $this->buildConfiguration($treeBuilder->getRootNode()->children());
+
+        return new Documentation(
+            $treeBuilder,
+            <<<HEADER
+            Converts a video to an animated GIF / PNG.
+            HEADER,
+            $this->outputFormatsDocumentation->listFormats(self::getSupportedOutputFormats()),
+        );
+    }
+
+    public function buildConfiguration(NodeBuilder $builder): void
+    {
+        // @formatter:off
+        $builder
+            ->arrayNode('options')
+                ->children()
+                    ->scalarNode('start')
+                        ->defaultValue(0)
+                        ->info('Start time in seconds or timecode')
+                        ->example('2.5 ; "00:00:02.50" ; "{{ attr.start }}"')
+                    ->end()
+                    ->scalarNode('duration')
+                        ->defaultValue(null)
+                        ->info('Duration in seconds or timecode')
+                        ->example('30 ; "00:00:30.00" ; "{{ input.duration/2 }}"')
+                    ->end()
+                    ->scalarNode('fps')
+                        ->defaultValue(1)
+                        ->info('Frames per second')
+                    ->end()
+                    ->scalarNode('width')
+                        ->defaultValue(null)
+                        ->info('Width in pixels')
+                    ->end()
+                    ->scalarNode('height')
+                        ->defaultValue(null)
+                        ->info('Height in pixels')
+                    ->end()
+                    ->enumNode('mode')
+                        ->values([
+                            FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_INSET,
+                            // todo: implement other modes
+                            // FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_FIT,
+                            // FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_SCALE_WIDTH,
+                            // FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_SCALE_HEIGHT,
+                        ])
+                        ->defaultValue(FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_INSET)
+                        ->info('Resize mode')
+                    ->end()
+                    ->scalarNode('format')
+                        ->isRequired()
+                        ->info('output format')
+                        ->example('animated-png')
+                    ->end()
+                    ->scalarNode('extension')
+                        ->defaultValue('default extension from format')
+                        ->info('extension of the output file')
+                        ->example('apng')
+                    ->end()
+                    ->scalarNode('passes')
+                        ->defaultValue(2)
+                        ->info('Change the number of ffmpeg passes')
+                    ->end()
+                        ->scalarNode('timeout')
+                        ->info('Change the default timeout used by ffmpeg (defaults to symphony process timeout)')
+                    ->end()
+                    ->scalarNode('threads')
+                        ->info('Change the default number of threads used by ffmpeg')
+                    ->end()
+                ->end()
+            ->end();
+        // @formatter:on
+    }
+
     public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFileInterface
     {
         $context->log("Applying '".self::getName()."' module");
@@ -26,42 +129,29 @@ public function transform(InputFileInterface $inputFile, array $options, Transfo
             throw new \InvalidArgumentException('Invalid input file family, should be video');
         }
 
-        $commonArgs = new ModuleCommonArgs($this->formats, $options, $context, $this->optionsResolver);
+        $commonArgs = new ModuleCommonArgs($this->formats, self::getSupportedOutputFormats(), $options, $context, $this->optionsResolver);
         $outputFormat = $commonArgs->getOutputFormat();
 
         /** @var FFMpeg\Media\Video $video */
         $video = $commonArgs->getFFMpeg()->open($inputFile->getPath());
 
-        $resolverContext = [
-            'metadata' => $context->getTemplatingContext(),
-            'input' => $video->getStreams()->videos()->first()->all(),
-        ];
+        $resolverContext = $context->getTemplatingContext();
+        $resolverContext['input'] = $video->getStreams()->videos()->first()->all();
 
         $start = $this->optionsResolver->resolveOption($options['start'] ?? 0, $resolverContext);
-        $startAsTimecode = false;
-        if (is_numeric($start) && (float) $start >= 0) {
-            $startAsTimecode = TimeCode::fromSeconds($start);
-        } elseif (is_string($start)) {
-            $startAsTimecode = TimeCode::fromString($start);
-        }
-        if (false === $startAsTimecode) {
+        $startAsTimecode = FFMpegHelper::optionAsTimecode($start);
+        if (null === $startAsTimecode) {
             throw new \InvalidArgumentException('Invalid start.');
         }
-        $start = $startAsTimecode->toSeconds();
-
+        $start = FFMpegHelper::timecodeToseconds($startAsTimecode);
 
         $duration = $this->optionsResolver->resolveOption($options['duration'] ?? null, $resolverContext);
-        $durationAsTimecode = false;
-        if (is_numeric($duration) && (float) $duration >= 0) {
-            $durationAsTimecode = TimeCode::fromSeconds($duration);
-        } elseif (is_string($duration)) {
-            $durationAsTimecode = TimeCode::fromString($duration);
-        }
-        if (null !== $duration ) {
-            if (false === $durationAsTimecode) {
+        if (null !== $duration) {
+            $durationAsTimecode = FFMpegHelper::optionAsTimecode($duration);
+            if (null === $durationAsTimecode) {
                 throw new \InvalidArgumentException('Invalid duration for filter "clip"');
             }
-            $duration = $durationAsTimecode->toSeconds();
+            $duration = FFMpegHelper::timecodeToseconds($durationAsTimecode);
         }
 
         if (($fps = (int) $this->optionsResolver->resolveOption($options['fps'] ?? 1, $resolverContext)) <= 0) {
diff --git a/lib/php/rendition-factory/src/Transformer/Video/VideoToFrameTransformerModule.php b/lib/php/rendition-factory/src/Transformer/Video/VideoToFrameTransformerModule.php
index a8dedc215..bf965e8fd 100644
--- a/lib/php/rendition-factory/src/Transformer/Video/VideoToFrameTransformerModule.php
+++ b/lib/php/rendition-factory/src/Transformer/Video/VideoToFrameTransformerModule.php
@@ -2,22 +2,92 @@
 
 namespace Alchemy\RenditionFactory\Transformer\Video;
 
+use Alchemy\RenditionFactory\Config\ModuleOptionsResolver;
 use Alchemy\RenditionFactory\Context\TransformationContextInterface;
 use Alchemy\RenditionFactory\DTO\FamilyEnum;
 use Alchemy\RenditionFactory\DTO\InputFileInterface;
 use Alchemy\RenditionFactory\DTO\OutputFile;
 use Alchemy\RenditionFactory\DTO\OutputFileInterface;
+use Alchemy\RenditionFactory\Transformer\Documentation;
+use Alchemy\RenditionFactory\Transformer\TransformerConfigHelper;
 use Alchemy\RenditionFactory\Transformer\TransformerModuleInterface;
-use FFMpeg;
+use Alchemy\RenditionFactory\Transformer\Video\Format\FormatInterface;
+use Alchemy\RenditionFactory\Transformer\Video\Format\JpegFormat;
+use Alchemy\RenditionFactory\Transformer\Video\Format\OutputFormatsDocumentation;
 use FFMpeg\Media\Video;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
+use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
+use Symfony\Component\DependencyInjection\ServiceLocator;
 
-final readonly class VideoToFrameTransformerModule extends AbstractVideoTransformer implements TransformerModuleInterface
+final readonly class VideoToFrameTransformerModule implements TransformerModuleInterface
 {
+    public function __construct(#[AutowireLocator(FormatInterface::TAG, defaultIndexMethod: 'getFormat')] private ServiceLocator $formats,
+        private ModuleOptionsResolver $optionsResolver,
+        private OutputFormatsDocumentation $outputFormatsDocumentation,
+    ) {
+    }
+
     public static function getName(): string
     {
         return 'video_to_frame';
     }
 
+    private static function getSupportedOutputFormats(): array
+    {
+        return [JpegFormat::getFormat()];
+    }
+
+    public function getDocumentation(): Documentation
+    {
+        $treeBuilder = TransformerConfigHelper::createBaseTree(self::getName());
+        $this->buildConfiguration($treeBuilder->getRootNode()->children());
+
+        return new Documentation(
+            $treeBuilder,
+            <<<HEADER
+            Extract one frame from the video.
+            HEADER,
+            $this->outputFormatsDocumentation->listFormats(self::getSupportedOutputFormats()),
+        );
+    }
+
+    public function buildConfiguration(NodeBuilder $builder): void
+    {
+        // @formatter:off
+        $builder
+            ->arrayNode('options')
+                ->children()
+                    ->scalarNode('start')
+                        ->defaultValue(0)
+                        ->info('Offset of frame in seconds or timecode')
+                        ->example('2.5 ; "00:00:02.50" ; "{{ attr.start }}"')
+                    ->end()
+                    ->scalarNode('format')
+                        ->isRequired()
+                        ->info('output format')
+                        ->example('image-jpeg')
+                    ->end()
+                    ->scalarNode('extension')
+                        ->defaultValue('default extension from format')
+                        ->info('extension of the output file')
+                        ->example('jpg')
+                    ->end()
+                    ->scalarNode('passes')
+                        ->defaultValue(2)
+                        ->info('Change the number of ffmpeg passes')
+                    ->end()
+                    ->scalarNode('timeout')
+                        ->info('Change the default timeout used by ffmpeg (defaults to symphony process timeout)')
+                        ->end()
+                    ->scalarNode('threads')
+                        ->info('Change the default number of threads used by ffmpeg')
+                    ->end()
+                ->end()
+            ->end()
+        ;
+        // @formatter:on
+    }
+
     public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFileInterface
     {
         $context->log("Applying '".self::getName()."' module");
@@ -26,22 +96,24 @@ public function transform(InputFileInterface $inputFile, array $options, Transfo
             throw new \InvalidArgumentException('Invalid input file family, should be video');
         }
 
-        $commonArgs = new ModuleCommonArgs($this->formats, $options, $context, $this->optionsResolver);
+        $commonArgs = new ModuleCommonArgs($this->formats, self::getSupportedOutputFormats(), $options, $context, $this->optionsResolver);
         $outputFormat = $commonArgs->getOutputFormat();
 
         /** @var Video $video */
         $video = $commonArgs->getFFMpeg()->open($inputFile->getPath());
 
-        $resolverContext = [
-            'metadata' => $context->getTemplatingContext(),
-            'input' => $video->getStreams()->videos()->first()->all(),
-        ];
-
-        $from = FFMpeg\Coordinate\TimeCode::fromSeconds($this->optionsResolver->resolveOption($options['from_seconds'] ?? 0, $resolverContext));
+        $resolverContext = $context->getTemplatingContext();
+        $resolverContext['input'] = $video->getStreams()->videos()->first()->all();
 
-        $context->log(sprintf('  from=%s', $from));
+        $start = $this->optionsResolver->resolveOption($options['start'] ?? 0, $resolverContext);
+        $startAsTimecode = FFMpegHelper::optionAsTimecode($start);
+        if (null === $startAsTimecode) {
+            throw new \InvalidArgumentException('Invalid start.');
+        }
+        $start = FFMpegHelper::timecodeToseconds($startAsTimecode);
+        $context->log(sprintf('  start=%s (%.02f)', $startAsTimecode, $start));
 
-        $frame = $video->frame($from);
+        $frame = $video->frame($startAsTimecode);
         $outputPath = $context->createTmpFilePath($commonArgs->getExtension());
 
         $frame->save($outputPath);
diff --git a/lib/php/rendition-factory/src/Transformer/VoidTransformerModule.php b/lib/php/rendition-factory/src/Transformer/VoidTransformerModule.php
index 1a79150e4..3173a71c5 100644
--- a/lib/php/rendition-factory/src/Transformer/VoidTransformerModule.php
+++ b/lib/php/rendition-factory/src/Transformer/VoidTransformerModule.php
@@ -4,16 +4,34 @@
 
 use Alchemy\RenditionFactory\Context\TransformationContextInterface;
 use Alchemy\RenditionFactory\DTO\InputFileInterface;
-use Alchemy\RenditionFactory\DTO\OutputFile;
+use Alchemy\RenditionFactory\DTO\OutputFileInterface;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
 
 class VoidTransformerModule implements TransformerModuleInterface
 {
     public static function getName(): string
     {
-        return 'Void';
+        return 'void';
     }
 
-    public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFile
+    public function getDocumentation(): Documentation
+    {
+        $treeBuilder = TransformerConfigHelper::createBaseTree(self::getName());
+        $this->buildConfiguration($treeBuilder->getRootNode()->children());
+
+        return new Documentation(
+            $treeBuilder,
+            <<<HEADER
+            A module that does nothing (testing purpose)
+            HEADER
+        );
+    }
+
+    public function buildConfiguration(NodeBuilder $builder): void
+    {
+    }
+
+    public function transform(InputFileInterface $inputFile, array $options, TransformationContextInterface $context): OutputFileInterface
     {
         return $inputFile->createOutputFile();
     }