{"id":23357315,"url":"https://github.com/amarghosh/mp4viewer","last_synced_at":"2025-07-14T16:33:20.051Z","repository":{"id":10787416,"uuid":"13056577","full_name":"amarghosh/mp4viewer","owner":"amarghosh","description":"MP4 file analyser for converting ISO-bmff atoms into json, or display them on the command line or a GTK based window","archived":false,"fork":false,"pushed_at":"2024-04-15T12:09:29.000Z","size":292,"stargazers_count":54,"open_issues_count":0,"forks_count":20,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2025-06-14T13:51:51.381Z","etag":null,"topics":["14496-12","analyzer","gtk","isobmff","json","mp4-analyzser","mp4-converter","mp4-format","pypi-package","python","video","viewer"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/mp4viewer/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amarghosh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-09-24T06:36:30.000Z","updated_at":"2025-05-28T03:43:19.000Z","dependencies_parsed_at":"2024-04-15T13:35:01.747Z","dependency_job_id":"5d246f38-64d0-4acc-baa2-cdd474ac1fb5","html_url":"https://github.com/amarghosh/mp4viewer","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/amarghosh/mp4viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amarghosh%2Fmp4viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amarghosh%2Fmp4viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amarghosh%2Fmp4viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amarghosh%2Fmp4viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amarghosh","download_url":"https://codeload.github.com/amarghosh/mp4viewer/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amarghosh%2Fmp4viewer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265312364,"owners_count":23745181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["14496-12","analyzer","gtk","isobmff","json","mp4-analyzser","mp4-converter","mp4-format","pypi-package","python","video","viewer"],"created_at":"2024-12-21T10:20:09.664Z","updated_at":"2025-07-14T16:33:20.008Z","avatar_url":"https://github.com/amarghosh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![lint](https://github.com/amarghosh/mp4viewer/actions/workflows/format-and-lint.yml/badge.svg)\n![Code style](https://img.shields.io/badge/code%20style-black-black \"https://github.com/psf/black\")\n![pytest](https://github.com/amarghosh/mp4viewer/actions/workflows/pytest.yml/badge.svg)\n![PyPI - Version](https://img.shields.io/pypi/v/mp4viewer \"https://pypi.org/project/mp4viewer/\")\n\n# MP4Viewer\n\nMP4Viewer is an mp4 metadata analyser (ISO base media file format) written in python.\nYou can use it to analyse the metadata of mp4 files on the shell, a new gtk based window, or save it as a json file.\nThe definitions of structures used in the code can be found in the ~publicly available standard~ (it is not free to download anymore) [ISO/IEC 14496-12 - ISO base media file format](http://standards.iso.org/ittf/PubliclyAvailableStandards/index.html).\n\n## Install using pip\n```bash\npip install --upgrade mp4viewer\n\npython3 -m mp4viewer [-h] [-o {stdout,gui,json}] [-e] [-c {on,off}] file.mp4\n```\n\n## Run directly from code\n```bash\n./parse.sh [-h] [-o {stdout,gui,json}] [-e] [-c {on,off}] file.mp4\n```\n\n## Arguments\n\n```\npositional arguments:\n  input_file            Location of the ISO bmff file (mp4)\n\noptions:\n  -h, --help            show this help message and exit\n  -o {stdout,gui,json}, --output {stdout,gui,json}\n                        Specify the output format. Please note that pygtk is required for `gui`.\n  -c {on,off}, --color {on,off}\n                        Toggle colors in console based output; on by default.\n  -j JSON_PATH, --json JSON_PATH\n                        Path to the json file where the output should be saved. If this is specified, the json output will be generated and written to this file even if the requested output format is not\n                        json. If the output format is json and this argument is not specified, the json object will be written to the current directory using \"$PWD/$(basename input_file).mp4viewer.json\"\n  -e, --expand-arrays   Do not truncate long arrays\n  --debug               Used for internal debugging\n  --latex               Generate latex-in-markdown for github README\n```\n\n## Sample outputs:\n### The default output on the console\n![shell output](https://github.com/amarghosh/mp4viewer/blob/develop/images/console.png?raw=true)\n\n### GTK\n![window with gtk treeview](https://github.com/amarghosh/mp4viewer/blob/develop/images/gtk.png?raw=true)\n\nMP4Viewer uses gtk in graphics mode and requires pygtk3 for viewing results in a window.\nThis usually comes preinstalled with recent versions of ubuntu.\n\nYou can find more similar [MP4 tools in this page](https://github.com/video-dev/community-knowledge-base/blob/master/list-of-iso-bmff-mp4-tools.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famarghosh%2Fmp4viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famarghosh%2Fmp4viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famarghosh%2Fmp4viewer/lists"}