Skip to content

Commit

Permalink
Set version 0.0.40
Browse files Browse the repository at this point in the history
  • Loading branch information
hdsdi3g committed Jun 15, 2024
1 parent b705767 commit e9939cf
Show file tree
Hide file tree
Showing 5 changed files with 36 additions and 32 deletions.
16 changes: 8 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)\
Expand Down Expand Up @@ -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.

Expand All @@ -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`.
Expand All @@ -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

Expand All @@ -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`

<h2 id="examples">🛫 Examples</h2>

Expand Down
6 changes: 3 additions & 3 deletions THIRD-PARTY.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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)
32 changes: 18 additions & 14 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,8 @@
-->
<!DOCTYPE html>
<html lang="en"><head><title>Mediadeepa project documentation page</title><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta data-http-equiv="Content-Type" content="text/html; charset=UTF-8"><link media="all" rel="stylesheet" href="style.css"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="https://mexm.media/a-propos/apple-touch-icon.png"><link rel="manifest" href="https://mexm.media/a-propos/site.webmanifest"><link rel="mask-icon" href="https://mexm.media/a-propos/safari-pinned-tab.svg"><meta name="msapplication-TileColor" content="#000000"><meta name="theme-color" content="#ffffff"><link rel="icon" type="image/png" sizes="16x16" href="https://mexm.media/a-propos/favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="https://mexm.media/a-propos/favicon-32x32.png"></head><body><header><section id="aboutmediadeepa"><a class="anchor" href="#top"><h1>About Mediadeepa</h1></a><p>Audio/video medias and streams deep analyzer in Java with FFmpeg as back-end: extract/process technical information from audio/videos files/streams.</p>
<p><strong>This application is currently in alpha version, and should not be ready for production</strong></p>
<p><em>This document contain the full documentation for Mediadeepa version 0.0.39.</em></p>
<p><strong>This application is currently in alpha version, and should not be ready yet for production</strong></p>
<p><em>This document contain the full documentation for Mediadeepa version 0.0.40.</em></p>
<p><img src="https://mexm.media/project-logo.png" alt="&quot;Mediadeepa project logo&quot;" /></p>
<p>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.</p>
<blockquote>
Expand Down Expand Up @@ -63,7 +63,7 @@ <h2>Known limitations for Mediadeepa</h2>
<li>It only support the first video, and the first founded audio stream of a file.</li>
<li>Audio mono and stereo only.</li>
<li>Some process take (long) time to do, like SITI and container analyzing, caused by poor FFmpeg/FFprobe performances with <strong>these</strong> filters.</li>
<li>Loudness EBU R-128 measure works correctly with FFmpeg v7+, due to internal bugs/limitations with the previous versions.</li>
<li>Loudness EBU R-128,and <em>audio stats</em> measures works correctly with FFmpeg v7+, due to internal bugs/limitations with the previous versions.</li>
</ul>
<p>An internal warning will by displayed if you try to works with a Zip archive created by a different Mediadeepa version.</p>
<h2>Current available export formats</h2>
Expand Down Expand Up @@ -92,26 +92,26 @@ <h3>Get Linux application packages</h3>
<p>Download the last application release, as a Linux RPM or DEB package, or as an executable JAR (autonomous <em>fat</em> JAR file), downloaded directly from <a href="https://github.com/mediaexmachina/mediadeepa/releases">GitHub releases page</a>, and build at each releases.</p>
<p>Install/update with</p>
<pre><code class="language-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
</code></pre>
<p>Remove with <code>sudo dpkg -r mediadeepa</code> or <code>rpm -e mediadeepa</code>.</p>
<p>After, on Linux, run <code>mediadeepa [parameters]</code>, and <code>man mediadeepa</code> for the internal doc man page.</p>
<h3>Run simple JAR file</h3>
<p>On Windows/macOS, just run <code>java -jar mediadeepa-0.0.39.jar [options]</code>.</p>
<p>And simply run the application with <code>java -jar mediadeepa-0.0.39.jar</code>.</p>
<p>On Windows/macOS, just run <code>java -jar mediadeepa-0.0.40.jar [options]</code>.</p>
<p>And simply run the application with <code>java -jar mediadeepa-0.0.40.jar</code>.</p>
<p>Mediadeepa contain embedded help, displayed with the <code>-h</code> parameter.</p>
<p>You can set the command line parameters with <code>java -jar mediadeepa-0.0.39.jar [parameters]</code>.</p>
<p>You can set the command line parameters with <code>java -jar mediadeepa-0.0.40.jar [parameters]</code>.</p>
<h3>Make a Java executable JAR file</h3>
<p>You can build yourself a JAR, with Git and Maven.</p>
<p>Run on Linux/WSL/macOS, after setup Git and Maven:</p>
<pre><code class="language-bash">git clone https://github.com/mediaexmachina/mediadeepa.git
cd mediadeepa
mvn install -DskipTests
</code></pre>
<p>Build jar will be founded on <code>target</code> directory as <code>mediadeepa-0.0.39.jar</code></p></section><section id="examples"><a class="anchor" href="#top"><h1>Examples</h1></a><h2>Process to export</h2>
<p>Build jar will be founded on <code>target</code> directory as <code>mediadeepa-0.0.40.jar</code></p></section><section id="examples"><a class="anchor" href="#top"><h1>Examples</h1></a><h2>Process to export</h2>
<p>Export to the current directory the analysis report for the file <code>videofile.mov</code>:</p>
<pre><code>mediadeepa -i videofile.mov -f report -e .
</code></pre>
Expand Down Expand Up @@ -364,13 +364,15 @@ <h3>Data graphical representation (graphic)</h3>
<ul>
<li><code>audio-bitrate</code></li>
<li><code>audio-dcoffset</code></li>
<li><code>audio-dynamic-range</code></li>
<li><code>audio-entropy</code></li>
<li><code>audio-flatness</code></li>
<li><code>audio-loudness</code></li>
<li><code>audio-loundness-truepeak</code></li>
<li><code>audio-noise-floor</code></li>
<li><code>audio-peak-level</code></li>
<li><code>audio-phase</code></li>
<li><code>audio-rms-level</code></li>
<li><code>events</code></li>
<li><code>video-bitrate</code></li>
<li><code>video-block</code></li>
Expand Down Expand Up @@ -418,6 +420,7 @@ <h3>Available options</h3>
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
Expand All @@ -433,6 +436,7 @@ <h3>Available options</h3>
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
Expand Down Expand Up @@ -522,29 +526,29 @@ <h2>Road-map</h2>
<p>Some changes have been planned, like:</p>
<ul>
<li>Analyzing all audio streams, better MXF audio tracks and audio track management.</li>
<li>Better reports, (as PDF?) with embedded graphics.</li>
<li>Manage variable frame rate statistics (actually done, but need to be deeply checked to ensure the measure method is correct).</li>
<li>Work on live streams, instead of just regular files.</li>
<li>FFmpeg and FFprobe parallel executions.</li>
<li>Content checking with automatic technical validation</li>
</ul>
<p>And <a href="https://github.com/mediaexmachina/mediadeepa/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement">many others</a>, I hope !</p>
<h2>Auto-generated documentation</h2>
<h3>Bash-completion</h3>
<p>The application provide a dynamic bash-completion script generated by:</p>
<pre><code class="language-bash">java -jar target/mediadeepa-0.0.39.jar --autocomplete
<pre><code class="language-bash">java -jar target/mediadeepa-0.0.40.jar --autocomplete
</code></pre>
<h3>Man page</h3>
<p>An auto-generated <strong>man</strong> page can be produced by an internal option:</p>
<pre><code class="language-bash">java -Dexportdocumentation.manpage=&quot;/full/path/to/file.man&quot; -jar target/mediadeepa-0.0.39.jar
<pre><code class="language-bash">java -Dexportdocumentation.manpage=&quot;/full/path/to/file.man&quot; -jar target/mediadeepa-0.0.40.jar
</code></pre>
<h3>README page</h3>
<p>Auto-generated by Mediadeepa, like the man page, and can be produced by the internal option:</p>
<pre><code class="language-bash">java -Dexportdocumentation.readme=&quot;README.md&quot; -jar target/mediadeepa-0.0.39.jar
<pre><code class="language-bash">java -Dexportdocumentation.readme=&quot;README.md&quot; -jar target/mediadeepa-0.0.40.jar
</code></pre>
<p>All source text for documentation is either auto-generated by the internal application options and static markdown files in the <code>src/main/resources/doc/en</code> directory.</p>
<h3>Project web page</h3>
<p>Auto-generated by Mediadeepa, like the man and README pages, and can be produced by the internal option:</p>
<pre><code class="language-bash">java -Dexportdocumentation.website=&quot;docs/index.html&quot; -jar target/mediadeepa-0.0.39.jar
<pre><code class="language-bash">java -Dexportdocumentation.website=&quot;docs/index.html&quot; -jar target/mediadeepa-0.0.40.jar
</code></pre>
<p>Same method to generate this file, like README/man files does.</p></section><section id="acknowledgments"><a class="anchor" href="#top"><h1>Acknowledgments</h1></a><p>Mediadeepa would never have been possible without the help of these magnificent and amazing OSS projects:</p>
<ul>
Expand Down
12 changes: 6 additions & 6 deletions docs/mediadeepa-1.man
Original file line number Diff line number Diff line change
Expand Up @@ -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 '
Expand All @@ -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


Expand Down Expand Up @@ -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\&.
Expand Down Expand Up @@ -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
2 changes: 1 addition & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<groupId>media.mexm</groupId>
<artifactId>mediadeepa</artifactId>
<packaging>jar</packaging>
<version>0.0.40-SNAPSHOT</version>
<version>0.0.40</version>

<name>MediaDeepA</name>
<url>https://gh.mexm.media/mediadeepa</url>
Expand Down

0 comments on commit e9939cf

Please sign in to comment.