Fabrice Quenneville
80ef63eccd
- Breaking change: Renamed the project from 'MediaCurator' to 'mediacurator' to standardize naming conventions (all lowercase). - Updated all references across documentation and source files: - README.md - Various .rst documentation files (installation, manual, use cases, errors, warnings) - Python source files in 'mediacurator/library' and main 'mediacurator.py' - setup.py - Incremented version from 0.0.13 to 1.0.1 to reflect breaking changes. - Added release notes for 1.0.1 in docsource/source/releasenotes/1.0.1-changelog.rst
105 lines
2.8 KiB
ReStructuredText
105 lines
2.8 KiB
ReStructuredText
=========
|
|
Use cases
|
|
=========
|
|
|
|
The main reasons to use mediacurator would be the following:
|
|
|
|
* :ref:`list_cmd` on a video library such as:
|
|
- How many videos of the lot are in HD vs standard or substandard definitions
|
|
- What videos are in older codecs
|
|
- Are there videos in the library with encoding or corruption errors
|
|
* :ref:`purge` selected videos in a media library
|
|
* :ref:`fferror` on selected videos in a media library
|
|
* :ref:`convert` videos from an old codec to `High Efficiency Video Coding <https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding>`_
|
|
|
|
.. _list_cmd:
|
|
|
|
Print information
|
|
-----------------
|
|
|
|
List all videos with old codec in formated format
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator list -filters:old -dirs:/mnt/media/
|
|
|
|
List all videos with substandard definitions with a formated output
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator list -filters:subsd -print:formated -dirs:/mnt/media/
|
|
|
|
|
|
.. _purge:
|
|
|
|
Purge
|
|
-----
|
|
|
|
Please see :doc:`warnings`
|
|
|
|
List and delete all videos using the `Windows Media Video <https://en.wikipedia.org/wiki/Windows_Media_Video>`_ codecs
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator list -del -filters:wmv -dirs:/mnt/media/
|
|
|
|
List and delete all videos using an `Audio Video Interleave <https://en.wikipedia.org/wiki/Audio_Video_Interleave>`_
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator list -del -in:avi -dirs:/mnt/media/
|
|
|
|
List and delete any videos with encoding errors
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator list -del -filters:fferror -dirs:/mnt/media/
|
|
|
|
|
|
|
|
.. _fferror:
|
|
|
|
Batch repair encoding errors
|
|
----------------------------
|
|
|
|
List all videos with encoding errors
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator list -filters:fferror -dirs:/mnt/media/
|
|
|
|
List and delete any videos with encoding errors
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator list -del -filters:fferror -dirs:/mnt/media/
|
|
|
|
Convert all videos with encoding errors to `High Efficiency Video Coding <https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding>`_ and the delete the originals
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator convert -del -filters:fferror -dirs:"/mnt/media/Movies/"
|
|
|
|
|
|
.. _convert:
|
|
|
|
Batch re-encode
|
|
---------------
|
|
|
|
Convert all videos with old codecs to `High Efficiency Video Coding <https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding>`_ to save space and delete the originals
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator convert -del -filters:old -dirs:"/mnt/media/Movies/"
|
|
|
|
Convert all videos with the codec mpeg4 to an mkv container using the av1 video codec
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator convert -filters:mpeg4 -out:av1,mkv -dirs:"/mnt/media/Movies/"
|
|
|
|
Convert any video with avi or mpg extensions, print formated text including ffmpeg's output and then delete the originals
|
|
|
|
.. code-block:: bash
|
|
|
|
mediacurator convert -del -in:avi,mpg -print:formated,verbose -dirs:/mnt/media/ |