# PyMediaInfo CLI
![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)
[![PyPI version](https://badge.fury.io/py/pymediainfo-cli.svg)](https://badge.fury.io/py/pymediainfo-cli)
![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)
![Test](https://github.com/GuiEpi/pymediainfo-cli/actions/workflows/python-ci.yml/badge.svg)
[![Codecov](https://codecov.io/gh/GuiEpi/pymediainfo-cli/graph/badge.svg?token=9EK12X8FX9)](https://codecov.io/gh/GuiEpi/pymediainfo-cli)
This is a command-line interface (CLI) for the [pymediainfo](https://pypi.org/project/pymediainfo/) library, which provides a way to extract metadata from media files.
## [Requirement](https://pymediainfo.readthedocs.io/en/stable/index.html#requirements)
pymediainfo is a simple wrapper around the MediaInfo library, which you can find at https://mediaarea.net/en/MediaInfo.
> * Without the library, this package cannot parse media files, which severely limits its functionality.
> * Binary wheels containing a bundled library version are provided for Windows and Mac OS X.
> * Packages are available for [several major Linux distributions](https://repology.org/project/python:pymediainfo/versions). They depend on the library most of the time and are the preferred way to use pymediainfo on Linux unless a specific version of the package is required.
## Installation
You can install this CLI using pip:
```bash
pip install pymediainfo-cli
```
## Usage
You can use this CLI by running the pymediainfo command followed by the path to a media file:
```bash
pymediainfo-cli path/to/media/file
```
This will print the metadata for the media file in a human-readable format.
You can also specify various options to control the output:
* `--output-format` or `-f`: Output format (table, json)
* `--general` or `-g`: Include General tracks
* `--video` or `-v`: Include Video tracks
* `--audio` or `-a`: Include Audio tracks
* `--text` or `-t`: Include Text tracks
* `--image` or `-i`: Include Image tracks
* `--other` or `-o`: Include Other tracks
* `--menu` or `-m`: Include Menu tracks
* `--parse-speed` or `-p`: MediaInfo parse speed (0-1)
* `--output-file`: Write output to a file (optional)
For example, you can use the `-f json` to output the metadata in JSON format:
```bash
pymediainfo-cli path/to/media/file -f json
```
More information with:
```bash
pymediainfo-cli --help
```
## Contributing
Contributions are welcome! Please feel free to submit a pull request.
> I use Poetry to mange dependancies see: https://python-poetry.org/
#### Clone the repo
```bash
git clone https://github.com/GuiEpi/pymediainfo-cli.git
```
#### Install dependancies
```bash
poetry install
```
#### Run
```bash
poetry run pymediainfo-cli --help
```
#### Testing
```bash
poetry run pytest tests/test.py
```
## License
This project is licensed under the MIT License.
## Credits
This project was inspired by [pymediainfo](https://pypi.org/project/pymediainfo/).
Raw data
{
"_id": null,
"home_page": "https://github.com/GuiEpi/pymediainfo-cli",
"name": "pymediainfo-cli",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11,<4.0",
"maintainer_email": "",
"keywords": "cli,mediainfo",
"author": "Guillaume Coussot",
"author_email": "guillaume.coussot@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/55/97/1f3d5b60c20fcc64984e347cca9c95884fc584094efe343de789a0131c03/pymediainfo_cli-0.2.1.tar.gz",
"platform": null,
"description": "# PyMediaInfo CLI\n\n![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)\n[![PyPI version](https://badge.fury.io/py/pymediainfo-cli.svg)](https://badge.fury.io/py/pymediainfo-cli)\n![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)\n![Test](https://github.com/GuiEpi/pymediainfo-cli/actions/workflows/python-ci.yml/badge.svg)\n[![Codecov](https://codecov.io/gh/GuiEpi/pymediainfo-cli/graph/badge.svg?token=9EK12X8FX9)](https://codecov.io/gh/GuiEpi/pymediainfo-cli)\n\nThis is a command-line interface (CLI) for the [pymediainfo](https://pypi.org/project/pymediainfo/) library, which provides a way to extract metadata from media files.\n\n## [Requirement](https://pymediainfo.readthedocs.io/en/stable/index.html#requirements)\npymediainfo is a simple wrapper around the MediaInfo library, which you can find at https://mediaarea.net/en/MediaInfo.\n> * Without the library, this package cannot parse media files, which severely limits its functionality.\n> * Binary wheels containing a bundled library version are provided for Windows and Mac OS X.\n> * Packages are available for [several major Linux distributions](https://repology.org/project/python:pymediainfo/versions). They depend on the library most of the time and are the preferred way to use pymediainfo on Linux unless a specific version of the package is required.\n\n## Installation\nYou can install this CLI using pip:\n\n```bash\npip install pymediainfo-cli\n```\n\n## Usage\nYou can use this CLI by running the pymediainfo command followed by the path to a media file:\n```bash\npymediainfo-cli path/to/media/file\n```\nThis will print the metadata for the media file in a human-readable format.\n\nYou can also specify various options to control the output:\n* `--output-format` or `-f`: Output format (table, json)\n* `--general` or `-g`: Include General tracks\n* `--video` or `-v`: Include Video tracks\n* `--audio` or `-a`: Include Audio tracks\n* `--text` or `-t`: Include Text tracks\n* `--image` or `-i`: Include Image tracks\n* `--other` or `-o`: Include Other tracks\n* `--menu` or `-m`: Include Menu tracks\n* `--parse-speed` or `-p`: MediaInfo parse speed (0-1)\n* `--output-file`: Write output to a file (optional)\n\nFor example, you can use the `-f json` to output the metadata in JSON format:\n```bash\npymediainfo-cli path/to/media/file -f json\n```\n\nMore information with:\n```bash\npymediainfo-cli --help\n```\n\n## Contributing\nContributions are welcome! Please feel free to submit a pull request.\n> I use Poetry to mange dependancies see: https://python-poetry.org/\n\n#### Clone the repo\n```bash\ngit clone https://github.com/GuiEpi/pymediainfo-cli.git\n```\n#### Install dependancies \n```bash\npoetry install\n```\n#### Run\n```bash\npoetry run pymediainfo-cli --help\n```\n#### Testing\n```bash\npoetry run pytest tests/test.py\n```\n\n## License\nThis project is licensed under the MIT License.\n\n## Credits\nThis project was inspired by [pymediainfo](https://pypi.org/project/pymediainfo/).",
"bugtrack_url": null,
"license": "MIT",
"summary": "CLI version of the pymediainfo package",
"version": "0.2.1",
"project_urls": {
"Homepage": "https://github.com/GuiEpi/pymediainfo-cli",
"Repository": "https://github.com/GuiEpi/pymediainfo-cli"
},
"split_keywords": [
"cli",
"mediainfo"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "18199ef002d17787b72e42900dd3ce979b5c48bbefd6dc64a38a9bef8c595930",
"md5": "03fad25859a1d8dff068559b467a4043",
"sha256": "a712d5394943da6076c940673966cb9015a9f85c789cda9885f8b7caf228b29f"
},
"downloads": -1,
"filename": "pymediainfo_cli-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "03fad25859a1d8dff068559b467a4043",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11,<4.0",
"size": 5361,
"upload_time": "2023-11-09T19:46:37",
"upload_time_iso_8601": "2023-11-09T19:46:37.771505Z",
"url": "https://files.pythonhosted.org/packages/18/19/9ef002d17787b72e42900dd3ce979b5c48bbefd6dc64a38a9bef8c595930/pymediainfo_cli-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "55971f3d5b60c20fcc64984e347cca9c95884fc584094efe343de789a0131c03",
"md5": "ed396b2779ae189c2d7ef17fb29e17da",
"sha256": "72a716dd08d26c35dc767ed4a4b29dc9cf594c9f16ceb32e4ac7bd0a6e5f43ef"
},
"downloads": -1,
"filename": "pymediainfo_cli-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "ed396b2779ae189c2d7ef17fb29e17da",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11,<4.0",
"size": 4253,
"upload_time": "2023-11-09T19:46:38",
"upload_time_iso_8601": "2023-11-09T19:46:38.796254Z",
"url": "https://files.pythonhosted.org/packages/55/97/1f3d5b60c20fcc64984e347cca9c95884fc584094efe343de789a0131c03/pymediainfo_cli-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-09 19:46:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GuiEpi",
"github_project": "pymediainfo-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pymediainfo-cli"
}