Fabrice Quenneville
5ba0f84d12
This release introduces a major overhaul of the `mediacurator` command-line interface (CLI) and comprehensive updates to the documentation. The CLI has transitioned from a custom argument parsing system to utilizing Python's `argparse` and `argcomplete` libraries, greatly enhancing usability and flexibility. Due to these significant changes, the version is incremented from **0.0.13** to **1.0.1**. - **Refactored** `tools.py` for standardized command-line argument handling using `argparse` and `argcomplete`. - **Improved** user interaction with structured arguments and built-in help, error handling, and validation. - **Consolidated** video detail printing logic into a reusable method within the `Video` class. - **Enhanced** `MediaLibrary` class with better clarity, functionality, and expanded support for video formats. - **Reorganized** `main.py` to streamline argument handling and improve error feedback. - **Updated** `setup.py` for release preparation, including new classifiers and dependencies. - **Revised** README.md for clarity, including structured command usage and improved descriptions. - **Moved** and improved old documentation, removing outdated content and adding new screenshots. - **Maintained** legacy commands for backward compatibility while enhancing usability with clear examples. - **Removed** non-existent `bcolors` from the public API. - **Upgraded** requirements.txt to include `argcomplete` for command-line completion. - **Updated** docstrings and function documentation for clarity on functionality and parameters.
42 lines
2.1 KiB
ReStructuredText
42 lines
2.1 KiB
ReStructuredText
======
|
||
Errors
|
||
======
|
||
|
||
.. warning::
|
||
|
||
The following documentation is for versions prior to 1.0.1. It may contain features and usage instructions that are incompatible with the current version of mediacurator.
|
||
|
||
FFmpeg can detect quite a few errors in the encoding of your source video's encoding and can also be used to repair these errors.
|
||
|
||
Repairable Encoding Errors
|
||
--------------------------
|
||
|
||
Here are some example errors that mediacurator will print and can possibly repair by re-encoding:
|
||
|
||
* **"Referenced QT chapter track not found"**: Indicates that the video references a chapter that doesn't exist.
|
||
* **"Error, header damaged or not MPEG-4 header"**: The file's header is corrupted or missing.
|
||
* **"Header missing"**: The file lacks the necessary header information for decoding.
|
||
* **"SEI type"**: Issues related to SEI (Supplemental Enhancement Information) data.
|
||
* **"no frame!"**: No video frames available for processing.
|
||
* **"Error while decoding MPEG audio frame."**: Issues decoding the audio stream.
|
||
* **"big_values too big"**: Indicates that certain values in the file are larger than expected.
|
||
* ...
|
||
|
||
FFmpeg Issues
|
||
-------------
|
||
|
||
While using FFmpeg, you may encounter other errors (such as segfaults) depending on your version. Mediacurator will also print information when that occurs and will move on to the next video after cleaning up any failures.
|
||
|
||
If you experience these errors, consider the following steps:
|
||
|
||
* **Update FFmpeg**: Ensure you are using the latest version by downloading it from `ffmpeg.org <https://ffmpeg.org/download.html>`_, as many distributions provide outdated versions in their repositories.
|
||
* **Run with Verbose Option**: Execute mediacurator with the verbose print option, which will display the raw FFmpeg output for better troubleshooting.
|
||
* **Retry**: In my experience, some errors do not necessarily recur...
|
||
|
||
Other Bugs
|
||
----------
|
||
|
||
If you encounter other bugs, issues, or would like to suggest features, feel free to open a bug report on `GitHub <https://github.com/fabquenneville/mediacurator/issues>`_.
|
||
|
||
For further assistance, you can reach out through the GitHub repository or the project’s support channels.
|