Aspect Ratio Detector: Seitenverhältnis erkennen, jetzt auch mit Tiny Media Manager

NAME
    Aspect Ratio Detector v0.3.0 by All-Ex




LINK


    https://heimkinoverein.de/forum/8-htpc-a-mediaplayer/17504-aspect-ratio-detector-seitenverhaeltnis-erkennen




SYNOPSIS


    This tool uses ffmpeg to autodetect the aspect ratio of videos based on actual pixels by analyzing frames. Black 
    bars that are encoded in the video can be detected. Video file names can be tagged (renamed) according to the 
    actual aspect ratio.

    Without parameters the Windows GUI version starts. By using command line parameters results can also be returned 
    as JSON or CSV. This information could be used by other tools to set the lens shift of a projector or move 
    screen maskings depending on the aspect ratio of the video.




SYNTAX


    AspectRatio-Detector.exe [[-Pathffmpeg] <string>] [[-PathVideo] <string[]>] [[-PathRecurse] <int>]
    [[-SampleDuration] <int>] [[-SampleNumber] <int>] [[-SampleMaxGap] <int>] [[-IgnoreBeginning] <int>]
    [[-IgnoreEnd] <int>] [[-AspectRatios] <string>] [[-SkipTaggedVideo] <int>] [[-RenameExtensions] <string>] 
    [[-DryRun] <int>] [[-Output] <string>] [-CMDmode] [-Help]


    Command line options can also be configured in the GUI.




DESCRIPTION


    Download ffmpeg at ffmpeg.org (release build 4.1.3 or later, 64 bit and static linking recommended) and extract.


    Without any command line parameters the program starts with a Windows GUI (a second window will show warnings/
    errors that might be generated by ffmpeg).


    Note the path of the ffmpeg/bin directory and enter it in the settings. Video files in the provided folder(s) 
    are analyzed. Videos in folders with a .nomedia file are skipped 
    (kodi.wiki/view/Updating_or_removing_videos#Exclude_Folder). 

    The metadata of the video stream is used to read the "Sample Aspect Ratio" of the video (SAR, DVDs differ from
    Blu-rays) and the pixel size of the stream. From this, the aspect ratio of the encoded stream (including black 
    bars) is determined => ARencoded.


    Then each video is analyzed in several spots (samples). All frames in each sample are examined and the pixel 
    size and the aspect ratio of the frame with the largest (non-black) image area is determined => ARcalculated 
    (the SAR from above is taken into account). The minimum number of samples, the maximum gap between samples, and
    the duration of each sample are definded in the settings or by command line. More samples and longer samples
    will increase detection accuracy but analysis will take longer.  


    The most common value of the sampled ARcalculated values will be used => ARdetected.


    To reduce the number or aspect ratios that are nearly identical, ARdetected is then rounded to the nearest aspect 
    ratio from the list specified in the settings => ARrounded.


    The Standard deviation (ARsd) of the sampled ARdetected values is calculated. Small values mean that the detection
    is good. 0 means that all samples in a video have the same aspect ratio. Large values can exist in videos that 
    were filmed in different formats or that have large black areas in some frames.


    If dry run is disabled, a tag will be added to the end of the filename. The format of the tag is "_ARxxx" 
    where xxx is ARrounded without a decimal point (e.g. ARrounded: 1.85 => Tag: _AR185). Files that belogn to the
    video (e.g. .nfo) can also be renamed. 

    Results are displayed in human readable lists or returned as JSON or CSV for further processing.




COMMAND LINE PARAMETERS


    These command line parameters can be used:


    -CMDmode          Use command line mode. Command line mode is also activated if one or more parameters are 
                      provided.
    -Pathffmpeg       Absolute path to the ffmpeg\bin directory (download at ffmpeg.org)
    -PathVideo        Absolute path to video folder(s) or file(s), multiple paths or files are separated by ,
    -PathRecurse      1 = include subfolders, 0 = do not include subfolders
    -SampleDuration   Duration of each sample in seconds
    -SampleNumber     Minimum number of samples per video
    -SampleMaxGap     Maximum time between samples in seconds
    -IgnoreBeginning  Percentage to ignore at beginning of video (intro logos, difficult to detect)
    -IgnoreEnd        Percentage to ignore end of video (credits, difficult to detect)
    -AspectRatios     List of aspect ratios that will be used to round the detected aspect ratio to (whitespace 
                      separated list)
    -SkipTaggedVideo  1 = Skip video files with existing _ARxxx tag. 0 = Analyze video files with existing _ARxxx tags 
                      (update tags)
    -RenameExtensions List of file name extensions that belong to the video file and will be renamed together with the
                      video file (whitespace separated list, e.g. ".nfo .mkv.measurements _mkv_Details.txt"). If empty 
                      only the video file will be renamed.
    -DryRun           1 = Dry run, do not rename any files. 0 = rename video files and files belonging to videos
    -Output           JSON = Return results in JSON format. CSV = Return results in CSV format. If the -Output 
                      parameter is used the tool runs in quiet mode and will not display anything until all videos are 
                      analyzed. Files will be renamed depending on the -DryRun parameter. Omit the -Output parameter 
                      to use verbose mode and display human readable summary and statistics.
    -Help             Show help


    Without any parameter the tool starts in GUI mode. If any parameter is omitted the corresponding setting of the 
    last GUI start is used.




EXAMPLES


    Windows GUI Mode:


        AspectRatio-Detector.exe




    Command line mode. Use all parameters from last GUI start. Return JSON after all videos are analyzed:


        AspectRatio-Detector.exe -Output JSON




    Command line mode. Use video paths from command line and all other parameters from last GUI start. Run in verbose
    mode. Output human readable lists:


        AspectRatio-Detector.exe -PathVideo "C:\Videos","D:\My Cat\So sweet.mkv"




    Use all parameters from command line. Do not rename files. Run in quiet mode. Write results in JSON format into 
    file output.json and errors in output.err:


        AspectRatio-Detector.exe -Pathffmpeg "C:\ffmpeg\bin" -PathVideo "C:\Videos","D:\My Cat\So sweet.mkv" 
        -PathRecurse 1 -SampleDuration 2 -SampleNumber 6 -SampleMaxGap 900 -IgnoreBeginning 2 -IgnoreEnd 8 
        -AspectRatios "1.34 1.67 1.78 1.85 2.00 2.22 2.35 2.39 2.40 2.76" -SkipTaggedVideo 1 -RenameExtensions 
        ".nfo .mkv.measurements _mkv_Details.txt" -DryRun 1 -Output JSON > output.json 2> output.err




HISTORY

    v0.1.0 2019/06/19 

        Initial release




    v0.2.0 2019/06/26

        NEW: Introduced command line mode
        NEW: Results returned in JSON (for easy further processing even without changing the file name) or as CSV 
             (for Excel evaluations ) format
        NEW: New Option "Include subfolders" in the GUI and via command line (activated by default) to skip videos 
             in subdirectories 
        NEW: Help function




    v0.2.1 2019/06/27


        FIX: Fixed error when changing ffmpeg path




    v0.3.0 2019/06/29


        NEW: A list of file extensions belonging to the video file can be specified. These files are renamed 
             together with the video file (e.g. .nfo .mkv.measurements _mkv_Details.txt)         
        NEW: Videos in folders that contain a .nomedia file are skipped 
             (kodi.wiki/view/Updating_or_removing_videos#Exclude_Folder)




LICENSE


    Copyright 2019 All-Ex


    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated 
    documentation files (the "Software"), to deal in the Software without restriction, including without limitation 
    the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, 
    and to permit persons to whom the Software is furnished to do so, subject to the following conditions:


    The above copyright notice and this permission notice shall be included in all copies or substantial portions 
    of the Software.


    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
    TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
    THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
    CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    DEALINGS IN THE SOFTWARE.