Add mov and webm probe validation

Add MOV and WebM container support to probing and strict validation.
Detect both formats by header signatures, return video stream metadata,
and map MIME/media types for extension fallback.

Include facade tests with minimal MOV/WebM fixtures for probe and strict
validation coverage, plus a guard test for unsupported mov->webm
video-to-video conversion routing.

Update README and Maven metadata to document the new format support and
refresh project/logo URLs, and bump the project version to 1.0.2

Author: TamKungZ

CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.2] - 2026-03-02
+
+### Added
+- Added MOV parser/probe support via [`MovParser`](src/main/java/me/tamkungz/codecmedia/internal/video/mov/MovParser.java).
+- Added WebM parser/probe support via [`WebmParser`](src/main/java/me/tamkungz/codecmedia/internal/video/webm/WebmParser.java).
+- Added MOV/WebM codec wrappers ([`MovCodec`](src/main/java/me/tamkungz/codecmedia/internal/video/mov/MovCodec.java), [`WebmCodec`](src/main/java/me/tamkungz/codecmedia/internal/video/webm/WebmCodec.java)) and probe info records.
+- Added facade tests for MOV/WebM probe and strict validation in [`CodecMediaFacadeTest`](src/test/java/me/tamkungz/codecmedia/CodecMediaFacadeTest.java).
+
+### Changed
+- Extended probing and strict validation routing in [`StubCodecMediaEngine`](src/main/java/me/tamkungz/codecmedia/internal/StubCodecMediaEngine.java) to cover MOV and WebM.
+- Updated project metadata URLs and branding references in [`pom.xml`](pom.xml) and [`README.md`](README.md).
+
+### Fixed
+- Fixed EBML element decoding in [`WebmParser`](src/main/java/me/tamkungz/codecmedia/internal/video/webm/WebmParser.java) so multi-byte element IDs (including `DefaultDuration`) are parsed with correct ID/size boundaries.
+- Fixed MOV frame-rate extraction in [`MovParser`](src/main/java/me/tamkungz/codecmedia/internal/video/mov/MovParser.java) to use `mdhd` track timescale when interpreting `stts` sample delta.
+
+## [1.0.1] - 2026-03-02
+
+### Added
+- Initial public release with probing, validation, metadata sidecar persistence, extraction workflow, playback simulation, and conversion routing.

README.md

@@ -5,7 +5,7 @@
 CodecMedia is a Java library for media probing, validation, metadata sidecar persistence, audio extraction, playback workflow simulation, and conversion routing.
 
 <p align="center">
-  <img src="https://www.tamkungz.me/assets-image/CodecMedia_Full_Logo.png" width="70%" alt="CodecMedia Logo">
+  <img src="https://codecmedia.tamkungz.me/CodecMedia_Full_Logo.png" width="70%" alt="CodecMedia Logo">
 </p>
 
 ## Features
@@ -21,8 +21,10 @@ CodecMedia is a Java library for media probing, validation, metadata sidecar per
   - BMP
   - TIFF
   - HEIC/HEIF/AVIF (basic BMFF parsing)
+  - MOV (QuickTime container parsing)
   - MP4 (basic ISO BMFF parsing)
-- Validation with size limits and strict parser checks for MP3/OGG/WAV/PNG/JPEG/WebP/BMP/TIFF/HEIC/HEIF/AVIF/MP4
+  - WebM (EBML container parsing)
+- Validation with size limits and strict parser checks for MP3/OGG/WAV/PNG/JPEG/WebP/BMP/TIFF/HEIC/HEIF/AVIF/MOV/MP4/WebM
 - Metadata read/write with sidecar persistence (`.codecmedia.properties`)
 - In-Java extraction and conversion file operations
 - Image-to-image conversion in Java for: `png`, `jpg`/`jpeg`, `webp`, `bmp`, `tif`/`tiff`, `heic`/`heif`
@@ -94,4 +96,4 @@ This project is licensed under the Apache License 2.0.
 
 ---
 
-*by TamKungZ_*
+*by TamKungZ_*

pom.xml

@@ -7,16 +7,16 @@
 
   <groupId>me.tamkungz.codecmedia</groupId>
   <artifactId>codecmedia</artifactId>
-  <version>1.0.1</version>
+  <version>1.0.2</version>
   <packaging>jar</packaging>
 
   <name>CodecMedia</name>
   <description>
     Universal media processing library for Java.
-    Supports probing, metadata reading/writing, container parsing,
-    audio/video extraction and format conversion.
+    CodecMedia is a Java library for media probing, validation, metadata sidecar persistence,
+    audio extraction, playback workflow simulation, and conversion routing. (Image/Video/Audio)
   </description>
-  <url>https://github.com/TamKungZ/codecmedia-java</url>
+  <url>https://codecmedia.tamkungz.me/</url>
 
   <organization>
     <name>TamKungZ_</name>
@@ -78,7 +78,8 @@
 
     <gpg.keyname>7311416EAA9848E4</gpg.keyname>
 
-    <project.logo.url>https://www.tamkungz.me/assets-image/CodecMedia_Logo.png</project.logo.url>
+    <project.logo.url>https://codecmedia.tamkungz.me/CodecMedia_Icon_Logo.png</project.logo.url>
+    <project.full.logo.url>https://codecmedia.tamkungz.me/CodecMedia_Full_Logo.png</project.full.logo.url>
   </properties>
 
   <dependencies>

src/main/java/me/tamkungz/codecmedia/internal/StubCodecMediaEngine.java

@@ -43,6 +43,12 @@
 import me.tamkungz.codecmedia.internal.video.mp4.Mp4Codec;
 import me.tamkungz.codecmedia.internal.video.mp4.Mp4Parser;
 import me.tamkungz.codecmedia.internal.video.mp4.Mp4ProbeInfo;
+import me.tamkungz.codecmedia.internal.video.mov.MovCodec;
+import me.tamkungz.codecmedia.internal.video.mov.MovParser;
+import me.tamkungz.codecmedia.internal.video.mov.MovProbeInfo;
+import me.tamkungz.codecmedia.internal.video.webm.WebmCodec;
+import me.tamkungz.codecmedia.internal.video.webm.WebmParser;
+import me.tamkungz.codecmedia.internal.video.webm.WebmProbeInfo;
 import me.tamkungz.codecmedia.model.ConversionResult;
 import me.tamkungz.codecmedia.model.ExtractionResult;
 import me.tamkungz.codecmedia.model.MediaType;
@@ -287,6 +293,54 @@ public ProbeResult probe(Path input) throws CodecMediaException {
                 return new ProbeResult(input, mimeType, outputExt, MediaType.IMAGE, null, List.of(), Map.of("sizeBytes", String.valueOf(size)));
             }
 
+            if ("mov".equals(extension) || MovParser.isLikelyMov(bytes)) {
+                try {
+                    MovProbeInfo info = MovCodec.decode(bytes, input);
+                    java.util.LinkedHashMap<String, String> tags = new java.util.LinkedHashMap<>();
+                    tags.put("sizeBytes", String.valueOf(size));
+                    if (info.majorBrand() != null && !info.majorBrand().isBlank()) {
+                        tags.put("majorBrand", info.majorBrand());
+                    }
+                    if (info.videoCodec() != null && !info.videoCodec().isBlank()) {
+                        tags.put("videoCodec", info.videoCodec());
+                    }
+                    if (info.audioCodec() != null && !info.audioCodec().isBlank()) {
+                        tags.put("audioCodec", info.audioCodec());
+                    }
+
+                    java.util.ArrayList<StreamInfo> streams = new java.util.ArrayList<>();
+                    if (info.width() != null && info.height() != null && info.width() > 0 && info.height() > 0) {
+                        streams.add(new StreamInfo(0, StreamKind.VIDEO, info.videoCodec() != null ? info.videoCodec() : "unknown", null, null, null, info.width(), info.height(), info.frameRate()));
+                    }
+                    if (info.sampleRate() != null && info.channels() != null && info.sampleRate() > 0 && info.channels() > 0) {
+                        streams.add(new StreamInfo(
+                                streams.size(),
+                                StreamKind.AUDIO,
+                                info.audioCodec() != null ? info.audioCodec() : "unknown",
+                                null,
+                                info.sampleRate(),
+                                info.channels(),
+                                null,
+                                null,
+                                null
+                        ));
+                    }
+
+                    return new ProbeResult(
+                            input,
+                            "video/quicktime",
+                            "mov",
+                            MediaType.VIDEO,
+                            info.durationMillis(),
+                            List.copyOf(streams),
+                            tags
+                    );
+                } catch (CodecMediaException ignored) {
+                    // Fall back to extension-only probe for malformed/partial files.
+                }
+                return new ProbeResult(input, "video/quicktime", "mov", MediaType.VIDEO, null, List.of(), Map.of("sizeBytes", String.valueOf(size)));
+            }
+
             if ("mp4".equals(extension) || "m4a".equals(extension) || Mp4Parser.isLikelyMp4(bytes)) {
                 String outputExt = "m4a".equals(extension) ? "m4a" : "mp4";
                 String mimeType = "m4a".equals(outputExt) ? "audio/mp4" : "video/mp4";
@@ -321,8 +375,55 @@ public ProbeResult probe(Path input) throws CodecMediaException {
                 return new ProbeResult(input, mimeType, outputExt, mediaType, null, List.of(), Map.of("sizeBytes", String.valueOf(size)));
             }
 
+            if ("webm".equals(extension) || WebmParser.isLikelyWebm(bytes)) {
+                try {
+                    WebmProbeInfo info = WebmCodec.decode(bytes, input);
+                    java.util.LinkedHashMap<String, String> tags = new java.util.LinkedHashMap<>();
+                    tags.put("sizeBytes", String.valueOf(size));
+                    if (info.videoCodec() != null && !info.videoCodec().isBlank()) {
+                        tags.put("videoCodec", info.videoCodec());
+                    }
+                    if (info.audioCodec() != null && !info.audioCodec().isBlank()) {
+                        tags.put("audioCodec", info.audioCodec());
+                    }
+
+                    java.util.ArrayList<StreamInfo> streams = new java.util.ArrayList<>();
+                    if (info.width() != null && info.height() != null && info.width() > 0 && info.height() > 0) {
+                        streams.add(new StreamInfo(0, StreamKind.VIDEO, info.videoCodec() != null ? info.videoCodec() : "unknown", null, null, null, info.width(), info.height(), info.frameRate()));
+                    }
+                    if (info.sampleRate() != null && info.channels() != null && info.sampleRate() > 0 && info.channels() > 0) {
+                        streams.add(new StreamInfo(
+                                streams.size(),
+                                StreamKind.AUDIO,
+                                info.audioCodec() != null ? info.audioCodec() : "unknown",
+                                null,
+                                info.sampleRate(),
+                                info.channels(),
+                                null,
+                                null,
+                                null
+                        ));
+                    }
+
+                    return new ProbeResult(
+                            input,
+                            "video/webm",
+                            "webm",
+                            MediaType.VIDEO,
+                            info.durationMillis(),
+                            List.copyOf(streams),
+                            tags
+                    );
+                } catch (CodecMediaException ignored) {
+                    // Fall back to extension-only probe for malformed/partial files.
+                }
+                return new ProbeResult(input, "video/webm", "webm", MediaType.VIDEO, null, List.of(), Map.of("sizeBytes", String.valueOf(size)));
+            }
+
             String mimeType = switch (extension) {
                 case "mp4" -> "video/mp4";
+                case "mov" -> "video/quicktime";
+                case "webm" -> "video/webm";
                 case "m4a" -> "audio/mp4";
                 case "mp3" -> "audio/mpeg";
                 case "ogg" -> "audio/ogg";
@@ -338,7 +439,7 @@ public ProbeResult probe(Path input) throws CodecMediaException {
                 default -> "application/octet-stream";
             };
             MediaType mediaType = switch (extension) {
-                case "mp4" -> MediaType.VIDEO;
+                case "mp4", "mov", "webm" -> MediaType.VIDEO;
                 case "m4a", "mp3", "ogg", "wav" -> MediaType.AUDIO;
                 case "png", "jpg", "jpeg", "webp", "bmp", "tif", "tiff", "heic", "heif", "avif" -> MediaType.IMAGE;
                 default -> MediaType.UNKNOWN;
@@ -559,12 +660,24 @@ public ValidationResult validate(Path input, ValidationOptions options) {
                     } catch (CodecMediaException e) {
                         return new ValidationResult(false, List.of(), List.of("Strict validation failed for jpg/jpeg: " + e.getMessage()));
                     }
+                } else if ("mov".equals(extension)) {
+                    try {
+                        MovParser.parse(bytes);
+                    } catch (CodecMediaException e) {
+                        return new ValidationResult(false, List.of(), List.of("Strict validation failed for mov: " + e.getMessage()));
+                    }
                 } else if ("mp4".equals(extension) || "m4a".equals(extension)) {
                     try {
                         Mp4Parser.parse(bytes);
                     } catch (CodecMediaException e) {
                         return new ValidationResult(false, List.of(), List.of("Strict validation failed for " + extension + ": " + e.getMessage()));
                     }
+                } else if ("webm".equals(extension)) {
+                    try {
+                        WebmParser.parse(bytes);
+                    } catch (CodecMediaException e) {
+                        return new ValidationResult(false, List.of(), List.of("Strict validation failed for webm: " + e.getMessage()));
+                    }
                 } else if ("webp".equals(extension)) {
                     try {
                         WebpParser.parse(bytes);

src/main/java/me/tamkungz/codecmedia/internal/video/mov/MovCodec.java

@@ -0,0 +1,58 @@
+package me.tamkungz.codecmedia.internal.video.mov;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import me.tamkungz.codecmedia.CodecMediaException;
+
+public final class MovCodec {
+
+    private MovCodec() {
+    }
+
+    public static MovProbeInfo decode(Path input) throws CodecMediaException {
+        try {
+            byte[] bytes = Files.readAllBytes(input);
+            return decode(bytes, input);
+        } catch (IOException e) {
+            throw new CodecMediaException("Failed to decode MOV: " + input, e);
+        }
+    }
+
+    public static MovProbeInfo decode(byte[] bytes, Path sourceRef) throws CodecMediaException {
+        MovProbeInfo info = MovParser.parse(bytes);
+        validateDecodedProbe(info, sourceRef);
+        return info;
+    }
+
+    public static void encode(byte[] encodedMovData, Path output) throws CodecMediaException {
+        if (encodedMovData == null || encodedMovData.length == 0) {
+            throw new CodecMediaException("MOV encoded data is empty");
+        }
+        try {
+            Files.write(output, encodedMovData);
+        } catch (IOException e) {
+            throw new CodecMediaException("Failed to encode MOV: " + output, e);
+        }
+    }
+
+    private static void validateDecodedProbe(MovProbeInfo info, Path input) throws CodecMediaException {
+        if (info.majorBrand() == null || info.majorBrand().isBlank()) {
+            throw new CodecMediaException("Decoded MOV has invalid major brand: " + input);
+        }
+        if (info.width() != null && info.width() <= 0) {
+            throw new CodecMediaException("Decoded MOV has invalid width: " + input);
+        }
+        if (info.height() != null && info.height() <= 0) {
+            throw new CodecMediaException("Decoded MOV has invalid height: " + input);
+        }
+        if (info.sampleRate() != null && info.sampleRate() <= 0) {
+            throw new CodecMediaException("Decoded MOV has invalid sample rate: " + input);
+        }
+        if (info.channels() != null && info.channels() <= 0) {
+            throw new CodecMediaException("Decoded MOV has invalid channel count: " + input);
+        }
+    }
+}
+