knowit 0.1

Know better your media files

KnowIt
==========
Know better your media files.

.. image:: https://img.shields.io/pypi/v/knowit.svg
:target: https://pypi.python.org/pypi/knowit
:alt: Latest Version

.. image:: https://travis-ci.org/ratoaq2/knowit.svg?branch=master
:target: https://travis-ci.org/ratoaq2/knowit
:alt: Travis CI build status

.. image:: https://img.shields.io/github/license/ratoaq2/knowit.svg
:target: https://github.com/ratoaq2/knowit/blob/master/LICENSE
:alt: License


:Project page: https://github.com/ratoaq2/knowit


Usage
-----
CLI
^^^
Extract information from a video file::

$ knowit FooBar.mkv
For: FooBar.mkv
{
"duration": "2:06:09.001000",
"video": [
{
"number": 1,
"language": "English",
"duration": "2:06:09.012000",
"width": 1920,
"height": 796,
"scan_type": "Progressive",
"aspect_ratio": 2.412,
"pixel_aspect_ratio": 1.0,
"resolution": "1080p",
"frame_rate": 23.976,
"bit_depth": 8,
"codec": "h264",
"profile": "High@L4.1",
"encoder": "x264",
"media_type": "video/H264",
"default": true
}
],
"audio": [
{
"number": 2,
"name": "DTS MA 5.1 16bit",
"language": "English",
"duration": "2:06:09.001000",
"codec": "DTS-HD",
"channels_count": 6,
"channels": "5.1",
"bit_rate": [
null,
1509000
],
"bit_rate_mode": [
"Variable",
"Constant"
],
"sample_rate": 48000,
"compression": [
"Lossless",
"Lossy"
],
"default": true
},
{
"number": 3,
"name": "DD5.1 448Kbps",
"language": "Chinese",
"duration": "2:06:09.001000",
"size": 448014053,
"codec": "AC3",
"channels_count": 6,
"channels": "5.1",
"bit_rate": 448000,
"bit_rate_mode": "Constant",
"sample_rate": 48000,
"compression": "Lossy"
}
],
"subtitle": [
{
"number": 4,
"language": "English",
"format": "SubRip",
"encoding": "utf-8",
"default": true
}
]
}

Installation
------------
KnowIt can be installed as a regular python module by running::

$ [sudo] pip install knowit

For a better isolation with your system you should use a dedicated virtualenv or install for your user only using
the ``--user`` flag.


External dependencies
-------------------------
This product uses `MediaInfo <http://mediaarea.net/MediaInfo>`_ library, Copyright (c) 2002-2016 `MediaArea.net SARL<mailto:[e-mail]>`_

Binaries for Windows and MacOS are included. Linux distributions need to manually install MediaInfo.

KnowIt supports MKV regardless if MediaInfo is installed.

MediaInfo increases the number of supported formats and the number of extracted information.