From e9939cf7f7a548a0592831ddf3b438ed80c0630b Mon Sep 17 00:00:00 2001 From: hdsdi3g Date: Sat, 15 Jun 2024 18:39:32 +0200 Subject: [PATCH] Set version 0.0.40 --- README.md | 16 ++++++++-------- THIRD-PARTY.txt | 6 +++--- docs/index.html | 32 ++++++++++++++++++-------------- docs/mediadeepa-1.man | 12 ++++++------ pom.xml | 2 +- 5 files changed, 36 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 3ae70c1..748fd14 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ Audio/video medias and streams deep analyzer in Java with FFmpeg as back-end: extract/process technical information from audio/videos files/streams. -**This application is currently in alpha version, and should not be ready for production** +**This application is currently in alpha version, and should not be ready yet for production** > [🚩 About](#about)\ > [🏪 Features](#features)\ @@ -66,7 +66,7 @@ You can process multiple files in one run, as well as load a text file as file l - It only support the first video, and the first founded audio stream of a file. - Audio mono and stereo only. - Some process take (long) time to do, like SITI and container analyzing, caused by poor FFmpeg/FFprobe performances with **these** filters. - - Loudness EBU R-128 measure works correctly with FFmpeg v7+, due to internal bugs/limitations with the previous versions. + - Loudness EBU R-128,and _audio stats_ measures works correctly with FFmpeg v7+, due to internal bugs/limitations with the previous versions. An internal warning will by displayed if you try to works with a Zip archive created by a different Mediadeepa version. @@ -87,10 +87,10 @@ Install/update with ```bash # DEB file on Debian/Ubuntu Linux distribs -sudo dpkg -i mediadeepa-0.0.39.deb +sudo dpkg -i mediadeepa-0.0.40.deb # RPM file on RHEL/CentOS Linux distribs -sudo rpm -U mediadeepa-0.0.39.rpm +sudo rpm -U mediadeepa-0.0.40.rpm ``` Remove with `sudo dpkg -r mediadeepa` or `rpm -e mediadeepa`. @@ -99,13 +99,13 @@ After, on Linux, run `mediadeepa [parameters]`, and `man mediadeepa` for the int ### Run simple JAR file -On Windows/macOS, just run `java -jar mediadeepa-0.0.39.jar [options]`. +On Windows/macOS, just run `java -jar mediadeepa-0.0.40.jar [options]`. -And simply run the application with `java -jar mediadeepa-0.0.39.jar`. +And simply run the application with `java -jar mediadeepa-0.0.40.jar`. Mediadeepa contain embedded help, displayed with the `-h` parameter. -You can set the command line parameters with `java -jar mediadeepa-0.0.39.jar [parameters]`. +You can set the command line parameters with `java -jar mediadeepa-0.0.40.jar [parameters]`. ### Make a Java executable JAR file @@ -119,7 +119,7 @@ cd mediadeepa mvn install -DskipTests ``` -Build jar will be founded on `target` directory as `mediadeepa-0.0.39.jar` +Build jar will be founded on `target` directory as `mediadeepa-0.0.40.jar`

🛫 Examples

diff --git a/THIRD-PARTY.txt b/THIRD-PARTY.txt index 08d95e2..ab337ef 100644 --- a/THIRD-PARTY.txt +++ b/THIRD-PARTY.txt @@ -109,9 +109,9 @@ Lists of 115 third-party dependencies. (The Apache Software License, Version 2.0) SQLite JDBC (org.xerial:sqlite-jdbc:3.43.2.0 - https://github.com/xerial/sqlite-jdbc) (The Apache Software License, Version 2.0) org.xmlunit:xmlunit-core (org.xmlunit:xmlunit-core:2.9.1 - https://www.xmlunit.org/) (Apache License, Version 2.0) SnakeYAML (org.yaml:snakeyaml:2.2 - https://bitbucket.org/snakeyaml/snakeyaml) - (GNU Lesser General Public License, Version 3) fflauncher (tv.hd3g:fflauncher:16.2.1 - https://github.com/hdsdi3g/medialib) - (Apache License 2.0) ffprobejaxb (tv.hd3g:ffprobejaxb:16.2.1 - https://github.com/hdsdi3g/medialib) - (GNU Lesser General Public License, Version 3) processlauncher (tv.hd3g:processlauncher:16.2.1 - https://github.com/hdsdi3g/medialib) + (GNU Lesser General Public License, Version 3) fflauncher (tv.hd3g:fflauncher:16.3.0 - https://github.com/hdsdi3g/medialib) + (Apache License 2.0) ffprobejaxb (tv.hd3g:ffprobejaxb:16.3.0 - https://github.com/hdsdi3g/medialib) + (GNU Lesser General Public License, Version 3) processlauncher (tv.hd3g:processlauncher:16.3.0 - https://github.com/hdsdi3g/medialib) (GNU Lesser General Public License, Version 3) CodePolicyValidation (tv.hd3g.commons:codepolicyvalidation:3.1.1 - https://github.com/hdsdi3g/codepolicyvalidation) (GNU Lesser General Public License, Version 3) Project's environment version (tv.hd3g.commons:env-version:20.0.0 - https://github.com/hdsdi3g/prodlib) (GNU Lesser General Public License, Version 3) Commons Interfaces (tv.hd3g.commons:interfaces:20.0.0 - https://github.com/hdsdi3g/prodlib) diff --git a/docs/index.html b/docs/index.html index b02c342..622365e 100644 --- a/docs/index.html +++ b/docs/index.html @@ -21,8 +21,8 @@ --> Mediadeepa project documentation page

About Mediadeepa

Audio/video medias and streams deep analyzer in Java with FFmpeg as back-end: extract/process technical information from audio/videos files/streams.

-

This application is currently in alpha version, and should not be ready for production

-

This document contain the full documentation for Mediadeepa version 0.0.39.

+

This application is currently in alpha version, and should not be ready yet for production

+

This document contain the full documentation for Mediadeepa version 0.0.40.

"Mediadeepa project logo"

This application will run FFmpeg on a source video/audio file to apply some filters, and generate analysis raw data (mostly high verbosely text/XML streams). They are parsed and reduced/converted/drawn/summarized them to some output formats by Mediadeepa.

@@ -63,7 +63,7 @@

Known limitations for Mediadeepa

  • It only support the first video, and the first founded audio stream of a file.
  • Audio mono and stereo only.
  • Some process take (long) time to do, like SITI and container analyzing, caused by poor FFmpeg/FFprobe performances with these filters.
    • -
  • Loudness EBU R-128 measure works correctly with FFmpeg v7+, due to internal bugs/limitations with the previous versions.
    • +
  • Loudness EBU R-128,and audio stats measures works correctly with FFmpeg v7+, due to internal bugs/limitations with the previous versions.

    • An internal warning will by displayed if you try to works with a Zip archive created by a different Mediadeepa version.

    Current available export formats

    @@ -92,18 +92,18 @@

    Get Linux application packages

    Download the last application release, as a Linux RPM or DEB package, or as an executable JAR (autonomous fat JAR file), downloaded directly from GitHub releases page, and build at each releases.

    Install/update with

    # DEB file on Debian/Ubuntu Linux distribs
-sudo dpkg -i mediadeepa-0.0.39.deb
+sudo dpkg -i mediadeepa-0.0.40.deb
 
 # RPM file on RHEL/CentOS Linux distribs
-sudo rpm -U mediadeepa-0.0.39.rpm
+sudo rpm -U mediadeepa-0.0.40.rpm

    Remove with sudo dpkg -r mediadeepa or rpm -e mediadeepa.

    After, on Linux, run mediadeepa [parameters], and man mediadeepa for the internal doc man page.

    Run simple JAR file

    -

    On Windows/macOS, just run java -jar mediadeepa-0.0.39.jar [options].

    -

    And simply run the application with java -jar mediadeepa-0.0.39.jar.

    +

    On Windows/macOS, just run java -jar mediadeepa-0.0.40.jar [options].

    +

    And simply run the application with java -jar mediadeepa-0.0.40.jar.

    Mediadeepa contain embedded help, displayed with the -h parameter.

    -

    You can set the command line parameters with java -jar mediadeepa-0.0.39.jar [parameters].

    +

    You can set the command line parameters with java -jar mediadeepa-0.0.40.jar [parameters].

    Make a Java executable JAR file

    You can build yourself a JAR, with Git and Maven.

    Run on Linux/WSL/macOS, after setup Git and Maven:

    @@ -111,7 +111,7 @@

    Make a Java executable JAR file

    cd mediadeepa mvn install -DskipTests -

    Build jar will be founded on target directory as mediadeepa-0.0.39.jar

    Examples

    Process to export

    +

    Build jar will be founded on target directory as mediadeepa-0.0.40.jar

    Examples

    Process to export

    Export to the current directory the analysis report for the file videofile.mov:

    mediadeepa -i videofile.mov -f report -e .
    @@ -364,6 +364,7 @@

    Data graphical representation (graphic)

    • audio-bitrate
    • audio-dcoffset
      • +
    • audio-dynamic-range
    • audio-entropy
    • audio-flatness
    • audio-loudness
      • @@ -371,6 +372,7 @@

      Data graphical representation (graphic)

    • audio-noise-floor
    • audio-peak-level
    • audio-phase
      • +
    • audio-rms-level
    • events
    • video-bitrate
    • video-block
      • @@ -418,6 +420,7 @@

      Available options

      mediadeepa.graphic-config.blur-graphic-filename=video-blur # String mediadeepa.graphic-config.crop-graphic-filename=video-crop # String mediadeepa.graphic-config.dc-offset-graphic-filename=audio-dcoffset # String +mediadeepa.graphic-config.dynamic-range-graphic-filename=audio-dynamic-range # String mediadeepa.graphic-config.entropy-graphic-filename=audio-entropy # String mediadeepa.graphic-config.events-graphic-filename=events # String mediadeepa.graphic-config.flatness-graphic-filename=audio-flatness # String @@ -433,6 +436,7 @@

      Available options

      mediadeepa.graphic-config.lufs-t-p-k-graphic-filename=audio-loundness-truepeak # String mediadeepa.graphic-config.noise-floor-graphic-filename=audio-noise-floor # String mediadeepa.graphic-config.peak-level-graphic-filename=audio-peak-level # String +mediadeepa.graphic-config.rms-level-graphic-filename=audio-rms-level # String mediadeepa.graphic-config.siti-graphic-filename=video-siti # String mediadeepa.graphic-config.v-bitrate-graphic-filename=video-bitrate # String mediadeepa.graphic-config.v-frame-duration-graphic-filename=video-frame-duration # String @@ -522,29 +526,29 @@

      Road-map

      Some changes have been planned, like:

      • Analyzing all audio streams, better MXF audio tracks and audio track management.
        • -
      • Better reports, (as PDF?) with embedded graphics.
      • Manage variable frame rate statistics (actually done, but need to be deeply checked to ensure the measure method is correct).
      • Work on live streams, instead of just regular files.
      • FFmpeg and FFprobe parallel executions.
        • +
      • Content checking with automatic technical validation

      And many others, I hope !

      Auto-generated documentation

      Bash-completion

      The application provide a dynamic bash-completion script generated by:

      -
      java -jar target/mediadeepa-0.0.39.jar --autocomplete
+
      java -jar target/mediadeepa-0.0.40.jar --autocomplete
 
      
 
      Man page
      
 
      An auto-generated man page can be produced by an internal option:
      
-
      java -Dexportdocumentation.manpage="/full/path/to/file.man" -jar target/mediadeepa-0.0.39.jar
+
      java -Dexportdocumentation.manpage="/full/path/to/file.man" -jar target/mediadeepa-0.0.40.jar
 
      
 
      README page
      
 
      Auto-generated by Mediadeepa, like the man page, and can be produced by the internal option:
      
-
      java -Dexportdocumentation.readme="README.md" -jar target/mediadeepa-0.0.39.jar
+
      java -Dexportdocumentation.readme="README.md" -jar target/mediadeepa-0.0.40.jar
 
      
 
      All source text for documentation is either auto-generated by the internal application options and static markdown files in the src/main/resources/doc/en directory.
      
 
      Project web page
      
 
      Auto-generated by Mediadeepa, like the man and README pages, and can be produced by the internal option:
      
-
      java -Dexportdocumentation.website="docs/index.html" -jar target/mediadeepa-0.0.39.jar
+
      java -Dexportdocumentation.website="docs/index.html" -jar target/mediadeepa-0.0.40.jar
 
      
 
      Same method to generate this file, like README/man files does.

    Acknowledgments

    Mediadeepa would never have been possible without the help of these magnificent and amazing OSS projects:

      diff --git a/docs/mediadeepa-1.man b/docs/mediadeepa-1.man index 58bf73e..e85f718 100644 --- a/docs/mediadeepa-1.man +++ b/docs/mediadeepa-1.man @@ -2,10 +2,10 @@ .\" Title: mediadeepa .\" Author: Media ex Machina / hdsdi3g .\" Generator: mediadeepa -.\" Date: 05/31/2024 -.\" Source: mediadeepa 0.0.39 +.\" Date: 06/15/2024 +.\" Source: mediadeepa 0.0.40 .\" Language: English -.TH "MEDIADEEPA" "1" "05/31/2024" "mediadeepa 0\&.0\&.39" "" +.TH "MEDIADEEPA" "1" "06/15/2024" "mediadeepa 0\&.0\&.40" "" .\" ----------------------------------------------------------------- .ie \n(.g .ds Aq \(aq .el .ds Aq ' @@ -31,7 +31,7 @@ mediadeepa [\-hov] [\-\-temp DIRECTORY] .SH "DESCRIPTION" Audio/video medias and streams deep analyzer in Java with FFmpeg as back\-end: extract/process technical information from audio/videos files/streams\&. .PP -\fIThis application is currently in alpha version, and should not be ready for production\fR +\fIThis application is currently in alpha version, and should not be ready yet for production\fR .PP @@ -104,7 +104,7 @@ Known limitations for Mediadeepa .PP \- Some process take (long) time to do, like SITI and container analyzing, caused by poor FFmpeg/FFprobe performances with \fIthese\fR filters\&. .PP -\- Loudness EBU R\-128 measure works correctly with FFmpeg v7+, due to internal bugs/limitations with the previous versions\&. +\- Loudness EBU R\-128,and audio stats measures works correctly with FFmpeg v7+, due to internal bugs/limitations with the previous versions\&. .PP .RE An internal warning will by displayed if you try to works with a Zip archive created by a different Mediadeepa version\&. @@ -619,7 +619,7 @@ Send bug reports on GitHub project page \fIhttps://github\&.com/mediaexmachina/m If you have any questions, feel free to reach out via any contact method listed on https://mexm\&.media \fIhttps://mexm\&.media\fR\&. .PP -Mediadeepa 0\&.0\&.39 +Mediadeepa 0\&.0\&.40 .PP Copyright (C) 2022\-2024 Media ex Machina, under the GNU General Public License\&. .PP diff --git a/pom.xml b/pom.xml index b484d30..6cdbbd7 100644 --- a/pom.xml +++ b/pom.xml @@ -6,7 +6,7 @@ media.mexm mediadeepa jar - 0.0.40-SNAPSHOT + 0.0.40 MediaDeepA https://gh.mexm.media/mediadeepa