Change default format to .mkv and fixate version

See also #266

Author: AB-xdev

CHANGELOG.md

@@ -1,3 +1,11 @@
+# 2.0.0
+_Major version bump due to default video container format change_
+* Pinned recorder container to `selenium/video:ffmpeg-8.0-20260202` because the currently latest version of the container is not shutting down properly
+* Changed default video container format to `mkv`
+  * This format allows to play the videos even when they are incomplete
+* Update default Selenium version to `4.41.0`
+* Updated dependencies
+
 # 1.5.3
 * Improve error message when browser name can't be matched
 * Updated dependencies

README.md

@@ -9,7 +9,7 @@ A re-implementation of [Testcontainer Selenium/WebDriver](https://java.testconta
     * No VNC Server started in the browser container (unless explicitly stated) → Saves memory
   * Uses [Selenium's implementation](https://github.com/SeleniumHQ/docker-selenium/tree/trunk/Video) and isn't [based](https://github.com/testcontainers/vnc-recorder) on [some python code from 2010](https://pypi.org/project/vnc2flv/#history)
     * Way more customization options for e.g. ``framerate``, ``codec``, ``preset`` ...
-    * Uses ``mp4`` as default recording format (wider support in comparison to ``flv``)
+    * Uses ``mkv`` as default recording format (wider support in comparison to ``flv``)
     * [Renders while saving the video](https://github.com/SeleniumHQ/docker-selenium/blob/4c572afd1173b5bd49fa2def3b54ea552fccee85/Video/video.sh#L126) (not when finished which takes additional time)
   * Stops the recorder before saving the file so that there is no way that [it runs forever](https://github.com/testcontainers/testcontainers-java/discussions/6229).
 * Automatically tries to select a alternative Selenium version for the docker image if it [doesn't exist](https://github.com/SeleniumHQ/docker-selenium/issues/1979).
@@ -25,6 +25,13 @@ Usage is very similar to [Testcontainers default implementation](https://java.te
 Make sure to remove the original Testcontainer Webdrivers dependency to avert any mix ups while using the library.
 For more information take a look at [our demo](./testcontainers-selenium-demo/src/main/java/software/xdev/Application.java).
 
+### Why are videos recorded as `.mkv` and how can I open them?
+
+In version 2 `.mp4` was replaced with `.mkv` as the default video container format.<br/>
+This was done because `.mp4` requires finalization as otherwise the file/container will be consider corrupt. `.mkv` has no such problems.
+
+[Most video players](https://en.wikipedia.org/wiki/Matroska#Support) (including browsers) can play `.mkv` files out of the box.
+
 ## Installation
 [Installation guide for the latest release](https://github.com/xdev-software/testcontainers-selenium/releases/latest#Installation)
 

pom.xml

@@ -6,7 +6,7 @@
 
 	<groupId>software.xdev</groupId>
 	<artifactId>testcontainers-selenium-root</artifactId>
-	<version>1.5.4-SNAPSHOT</version>
+	<version>2.0.0-SNAPSHOT</version>
 	<packaging>pom</packaging>
 
 	<organization>

testcontainers-selenium-demo/pom.xml

@@ -7,11 +7,11 @@
 	<parent>
 		<groupId>software.xdev</groupId>
 		<artifactId>testcontainers-selenium-root</artifactId>
-		<version>1.5.4-SNAPSHOT</version>
+		<version>2.0.0-SNAPSHOT</version>
 	</parent>
 
 	<artifactId>testcontainers-selenium-demo</artifactId>
-	<version>1.5.4-SNAPSHOT</version>
+	<version>2.0.0-SNAPSHOT</version>
 	<packaging>jar</packaging>
 
 	<organization>

testcontainers-selenium/pom.xml

@@ -6,7 +6,7 @@
 
 	<groupId>software.xdev</groupId>
 	<artifactId>testcontainers-selenium</artifactId>
-	<version>1.5.4-SNAPSHOT</version>
+	<version>2.0.0-SNAPSHOT</version>
 	<packaging>jar</packaging>
 
 	<name>testcontainers-selenium</name>

testcontainers-selenium/src/main/java/software/xdev/testcontainers/selenium/containers/browser/SeleniumUtils.java

@@ -38,7 +38,7 @@ public final class SeleniumUtils
 	private static final Logger LOG = LoggerFactory.getLogger(SeleniumUtils.class);
 
 	// as of 2026-01
-	public static final String DEFAULT_SELENIUM_VERSION = "4.40.0";
+	public static final String DEFAULT_SELENIUM_VERSION = "4.41.0";
 	private static String cachedVersion;
 
 	private SeleniumUtils()

testcontainers-selenium/src/main/java/software/xdev/testcontainers/selenium/containers/recorder/SeleniumRecordingContainer.java

@@ -31,7 +31,10 @@
 @SuppressWarnings("java:S2160")
 public class SeleniumRecordingContainer extends RecordingContainer<SeleniumRecordingContainer>
 {
-	public static final DockerImageName DEFAULT_IMAGE = DockerImageName.parse("selenium/video");
+	public static final DockerImageName DEFAULT_IMAGE =
+		// Workaround https://github.com/SeleniumHQ/docker-selenium/issues/3093
+		// As of 2026-03 the latest version of the container is not shutting down properly
+		DockerImageName.parse("selenium/video:ffmpeg-8.0-20260202");
 
 	// https://github.com/SeleniumHQ/docker-selenium/blob/033f77c02dde9d61d1a4d44be7526ef689244606/Video/Dockerfile#L103-L110
 	public static final String ENV_DISPLAY_CONTAINER_NAME = "DISPLAY_CONTAINER_NAME";
@@ -47,7 +50,7 @@ public class SeleniumRecordingContainer extends RecordingContainer<SeleniumRecor
 	protected String displayContainerName;
 	protected String videoFileName;
 	protected boolean resolutionConfigured;
-	protected String fileExtension = "mp4";
+	protected String fileExtension = "mkv";
 
 	public SeleniumRecordingContainer(final BrowserWebDriverContainer<?> target)
 	{

testcontainers-selenium/src/test/java/software/xdev/testcontainers/selenium/SimpleContainerTest.java

@@ -85,7 +85,7 @@ public String getFilesystemFriendlyName()
 			final String recordedFileName = recorded.getFileName().toString();
 
 			Assertions.assertAll(
-				() -> Assertions.assertTrue(recordedFileName.endsWith(".mp4")),
+				() -> Assertions.assertTrue(recordedFileName.endsWith(".mkv")),
 				() -> Assertions.assertTrue(recordedFileName.startsWith("PASSED-")),
 				() -> Assertions.assertTrue(Files.size(recorded) > 0));
 		}