Media Analyzer

A Java command-line tool for MediaFilez. Give it a direct media URL to inspect the URL, HTTP response, and file contents.

Build and run

Requires JDK 17 or newer and Apache Maven. Run these commands from the project directory.

On Windows x64:

mvn package "-Djavacpp.platform=windows-x86_64"
java -jar target/media-analyzer-0.1.0-SNAPSHOT.jar "https://i.imgur.com/n3euJ1C.mp4"

Run without an argument to enter a URL at the prompt:

java -jar target/media-analyzer-0.1.0-SNAPSHOT.jar

The build copies runtime libraries to target/lib. Keep that directory beside the JAR when moving the program. JavaCV includes FFmpeg, so you don't need a separate FFmpeg installation.

On other systems, use mvn package to include the platforms supported by JavaCV, or set javacpp.platform to your platform.

Report

The URL section shows the host, protocol, port, path, filename, extension, query parameters, and fragment. The HTTP section reports the status, final URL, redirects, content type, size, request time, and available response headers.

Media information comes from FFmpeg. The report includes the container, duration, bitrate, size, chapter count, and every stream, including additional audio tracks and subtitles.

Video details include resolution, aspect ratios, average and nominal frame rates, frame count, pixel format, bit depth, color information, and rotation. Audio details include sample rate, channel layout, sample format, and reported bit depth. File and stream metadata appear in their own sections.

Missing values print Unknown. Calculated frame counts are marked estimated. Sizes use MiB; bitrates use kb/s.

The filename extension is only a hint. FFmpeg reads the actual content, so URLs without extensions can work too. Use a direct media URL: the program doesn't extract videos from webpages.

The HTTP check starts with HEAD. If the server returns 405 or 501, it retries with a range GET and closes the body without reading it. Query parameters stay intact; fragments are removed before passing the URL to FFmpeg.

Dimensions and aspect ratios describe stored pixels before rotation. Average and nominal frame rates are reported separately. The program reads technical metadata, but doesn't check every frame for corruption. Live streams may omit duration or size. Network timeouts apply to individual operations, not the total analysis time.

Code

• Main.java reads input, runs both analyzers, and prints the media report once.
• UrlAnalyzer.java validates the URL and checks the HTTP response.
• MediaAnalyzer.java opens the media and reads container and stream properties.
• MediaInfo.java stores the file summary, streams, and file metadata.
• MediaStreamInfo.java stores one stream's details and metadata.
• ReportFormatter.java formats report sections, rows, and units.

Start with Main.java to follow the program. Add video properties in addVideoDetails() or audio properties in addAudioDetails(). Change the printed layout in ReportFormatter.

Details use LinkedHashMap to preserve their display order. FFmpeg data is copied into Java values before the grabber closes. try-with-resources releases native resources even when analysis fails.

Tests

mvn test "-Djavacpp.platform=windows-x86_64"

Tests use a local HTTP server and small generated media files. They cover combined output, URL parsing, redirects, HEAD fallback, multiple tracks, audio-only files, rotation, missing values, and failed requests. They don't depend on an external media server.

Fixture generation commands are in src/test/resources/README.md.

License

MIT.