### Added

- Added support for multiple video encoding formats
- Added the ability to transcode audio files
- Transcoder caches can be cleared via the ClearCaches utility

Author: khalwat

CHANGELOG.md

@@ -10,6 +10,9 @@
 - The `ffmpeg` progress for video transcoding is now written out to a `.progress` file
 - Added a `progress` controller to return video transcoding progress
 - Moved all of the default settings out to the `config.php` file
+- Added support for multiple video encoding formats
+- Added the ability to transcode audio files
+- Transcoder caches can be cleared via the ClearCaches utility
 
 ### Fixed
 - Fixed some issues with the lockfile naming

README.md

@@ -24,7 +24,7 @@ If you have managed hosting, contact your sysadmin to get `ffmpeg` installed.
 
 ## Transcoder Overview
 
-The Transcoder video allows you to take any locally stored video, and transcode it into any size, bitrate, framerate, and save it out as a web-ready `.mp4` file.
+The Transcoder video allows you to take any locally stored video, and transcode it into any size, bitrate, framerate, and save it out as a web-ready `.mp4` video file.
 
 It also allows you to get a thumbnail of the video in any size and at any timecode.
 
@@ -89,6 +89,10 @@ The only configuration for Transcoder is in the `config.php` file, which is a mu
             // Can be "none", "crop", or "letterbox"
             "aspectRatio" => "letterbox",
             "letterboxColor" => "",
+            // File format settings
+            "fileSuffix" => ".mp4",
+            "videoFormat" => "mp4",
+            "videoCodec" => "libx264",
         ],
 
         // Default options for video thumbnails
@@ -137,6 +141,9 @@ In the array you pass in, the default values are used if the key/value pair does
         "frameRate" => 15,
         "aspectRatio" => "letterbox",
         "sharpen" => true,
+        "fileSuffix" => ".mp4",
+        "videoFormat" => "mp4",
+        "videoCodec" => "libx264",
     }
 
 These default values come from the `config.php` file.
@@ -168,6 +175,8 @@ You can control the color of the letterboxed area (it's `black` by default) via
 
 The `sharpen` option determines whether an unsharp mask filter should be applied to the scaled video.
 
+The file format settings `fileSuffix`, `videoFormat`, and `videoCodec` are all preset to what you'll need to generate `.mp4` videos. Change these only if you know what you're doing.
+
 ### Getting Transcoding Progress
 
 Transcoding of videos can take quite a bit of time, so Transcoder provides you with a way to get the status of any currently running transcoding operation via `craft.transcoder.getVideoProgressUrl()`. For example:

src/Transcoder.php

@@ -14,10 +14,8 @@
 
 use Craft;
 use craft\base\Plugin;
-use craft\services\Plugins;
-use craft\events\PluginEvent;
-use craft\web\UrlManager;
-use craft\events\RegisterUrlRulesEvent;
+use craft\events\RegisterCacheOptionsEvent;
+use craft\utilities\ClearCaches;
 use yii\base\Event;
 
 /**
@@ -46,6 +44,19 @@ public function init()
         parent::init();
         self::$plugin = $this;
 
+        // Add the Transcoder path to the list of things the Clear Caches tool can delete.
+        Event::on(
+            ClearCaches::className(),
+            ClearCaches::EVENT_REGISTER_CACHE_OPTIONS,
+            function (RegisterCacheOptionsEvent $event) {
+                $event->options[] = [
+                    'key' => 'transcoder',
+                    'label' => Craft::t('transcoder', 'Transcoder caches'),
+                    'action' => Craft::$app->config->get("transcoderPath", "transcoder")
+                ];
+            }
+        );
+
         Craft::info('Transcoder ' . Craft::t('transcoder', 'plugin loaded'), __METHOD__);
     }
 

src/config.php

@@ -34,17 +34,64 @@
     // The options to use for ffprobe
     "ffprobeOptions" => "-v quiet -print_format json -show_format -show_streams",
 
-    // The path where the transcoded videos are stored
+    // The path where the transcoded videos are stored; must have a trailing /
     "transcoderPath" => $_SERVER['DOCUMENT_ROOT'] . "/transcoder/",
 
-    // The URL where the transcoded videos are stored
+    // The URL where the transcoded videos are stored; must have a trailing /
     "transcoderUrl" => "/transcoder/",
 
+    // Use a md5 hash for the filenames instead of parameterized naming
+    "useHashedNames" => false,
+
+    // Preset video encoders
+    "videoEncoders" => [
+        "mp4" => [
+            "fileSuffix" => ".mp4",
+            "videoCodec" => "libx264",
+            "videoCodecOptions" => "-vprofile high -preset slow -crf 22",
+            "audioCodec" => "libfdk_aac",
+            "audioCodecOptions" => "-async 1000",
+        ],
+        "webm" => [
+            "fileSuffix" => ".webm",
+            "videoCodec" => "libvpx",
+            "videoCodecOptions" => "-quality good -cpu-used 0",
+            "audioCodec" => "libvorbis",
+            "audioCodecOptions" => "-async 1000",
+        ],
+    ],
+
+    // Preset audio encoders
+    "audioEncoders" => [
+        "mp3" => [
+            "fileSuffix" => ".mp3",
+            "audioCodec" => "libmp3lame",
+            "audioCodecOptions" => "",
+        ],
+        "m4a" => [
+            "fileSuffix" => ".m4a",
+            "audioCodec" => "libfdk_aac",
+            "audioCodecOptions" => "",
+
+        ],
+        "ogg" => [
+            "fileSuffix" => ".ogg",
+            "audioCodec" => "libvorbis",
+            "audioCodecOptions" => "",
+        ],
+    ],
+
     // Default options for encoded videos
     "defaultVideoOptions" => [
-        "fileSuffix" => ".mp4",
-        "bitRate" => "800k",
-        "frameRate" => 15,
+        // Video settings
+        "videoFormat" => "mp4",
+        "videoBitRate" => "800k",
+        "videoFrameRate" => 15,
+        // Audio settings
+        "audioBitRate" => "",
+        "audioSampleRate" => "",
+        "audioChannels" => "",
+        // Spatial settings
         "width" => "",
         "height" => "",
         "sharpen" => true,
@@ -65,4 +112,12 @@
         "letterboxColor" => "",
     ],
 
+    // Default options for encoded videos
+    "defaultAudioOptions" => [
+        "audioFormat" => "mp3",
+        "audioBitRate" => "128k",
+        "audioSampleRate" => "44100",
+        "audioChannels" => "2",
+    ],
+
 ];