{"id":19081655,"url":"https://github.com/facsimiles/mkvtoolnix","last_synced_at":"2025-02-22T06:14:08.513Z","repository":{"id":256272043,"uuid":"854640939","full_name":"facsimiles/mkvtoolnix","owner":"facsimiles","description":"🎥 MKVToolNix: Your go-to toolkit for creating, modifying, and inspecting Matroska (.mkv) files! 🚀 Seamlessly merge, split, and edit video files with ease. Essential for video enthusiasts and professionals alike. Boost your media management efficiency today! [MIRROR][UNOFFICIAL]","archived":false,"fork":false,"pushed_at":"2024-10-19T13:47:44.000Z","size":346016,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-19T14:29:13.141Z","etag":null,"topics":["automation","demuxing","gui","matroska","media-processing","mirror","mirrored-repository","mkv","mkvextract","mkvmerge","muxing","unofficial","unofficial-mirror","video-processing"],"latest_commit_sha":null,"homepage":"https://mkvtoolnix.download","language":"C++","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/facsimiles.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-09T14:26:59.000Z","updated_at":"2024-10-19T13:47:48.000Z","dependencies_parsed_at":"2024-09-10T00:05:49.560Z","dependency_job_id":"58672034-494e-4ec4-94f1-75d770be7b63","html_url":"https://github.com/facsimiles/mkvtoolnix","commit_stats":null,"previous_names":["facsimiles/mkvtoolnix"],"tags_count":240,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmkvtoolnix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmkvtoolnix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmkvtoolnix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facsimiles%2Fmkvtoolnix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/facsimiles","download_url":"https://codeload.github.com/facsimiles/mkvtoolnix/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240131746,"owners_count":19752727,"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":["automation","demuxing","gui","matroska","media-processing","mirror","mirrored-repository","mkv","mkvextract","mkvmerge","muxing","unofficial","unofficial-mirror","video-processing"],"created_at":"2024-11-09T02:38:07.262Z","updated_at":"2025-02-22T06:14:08.492Z","avatar_url":"https://github.com/facsimiles.png","language":"C++","readme":"MKVToolNix 88.0\n=================\n\n# Table of contents\n\n1. [Introduction](#1-introduction)\n2. [Installation](#2-installation)\n    1. [Requirements](#21-requirements)\n        1. [Hard requirements](#211-hard-requirements)\n        2. [Requirements with bundled fallbacks](#212-requirements-with-bundled-fallbacks)\n    2. [Optional components](#22-optional-components)\n    3. [Building libEBML and libMatroska](#23-building-libebml-and-libmatroska)\n    4. [Building MKVToolNix](#24-building-mkvtoolnix)\n        1. [Getting and building a development snapshot](#241-getting-and-building-a-development-snapshot)\n        2. [Configuration and compilation](#242-configuration-and-compilation)\n    5. [Notes for compilation on (Open)Solaris](#25-notes-for-compilation-on-opensolaris)\n    6. [Unit tests](#26-unit-tests)\n3. [Reporting bugs \u0026 getting support](#3-reporting-bugs-getting-support)\n    1. [Reporting bugs](#31-reporting-bugs)\n    2. [Getting support](#32-getting-support)\n4. [Test suite and continuous integration tests](#4-test-suite-and-continuous-integration-tests)\n5. [Code of Conduct](#5-code-of-conduct)\n6. [Included third-party components and their licenses](#6-included-third-party-components-and-their-licenses)\n    1. [avilib](#61-avilib)\n    2. [libEBML](#63-libebml)\n    3. [libMatroska](#64-libmatroska)\n    4. [librmff](#65-librmff)\n    5. [nlohmann's JSON](#66-nlohmanns-json)\n    6. [pugixml](#67-pugixml)\n    7. [utf8-cpp](#68-utf8-cpp)\n    8. [Oxygen icons and sound files](#69-oxygen-icons-and-sound-files)\n    9. [MKVToolNix icons](#610-mkvtoolnix-icons)\n    10. [QtWaitingSpinner](#611-qtwaitingspinner)\n    11. [Fancy tab widget](#612-fancy-tab-widget)\n    12. [fmt](#613-fmt)\n    13. [QgsCollapsibleGroupBox](#613-qgscollapsiblegroupbox)\n\n-----------------\n\n# 1. Introduction\n\nWith these tools one can get information about (via mkvinfo) Matroska\nfiles, extract tracks/data from (via mkvextract) Matroska files and create\n(via mkvmerge) Matroska files from other media files. Matroska is a new\nmultimedia file format aiming to become THE new container format for\nthe future. You can find more information about it and its underlying\ntechnology, the Extensible Binary Meta Language (EBML), at\n\nhttp://www.matroska.org/\n\nThe full documentation for each command is now maintained in its\nman page only. Type `mkvmerge -h` to get you started.\n\nThis code comes under the GPL v2 (see www.gnu.org or the file COPYING).\nModify as needed.\n\nThe icons are based on the work of Alexandr Grigorcea and modified by\nEduard Geier. They're licensed under the terms of the\n[Creative Commons Attribution 3.0 Unported license](http://creativecommons.org/licenses/by/3.0/).\n\nThe newest version can always be found at\nhttps://mkvtoolnix.download/\n\nMoritz Bunkus \u003cmoritz@bunkus.org\u003e\n\n\n# 2. Installation\n\nIf you want to compile the tools yourself, you must first decide\nif you want to use a 'proper' release version or the current\ndevelopment version. As both Matroska and MKVToolNix are under heavy\ndevelopment, there might be features available in the git repository\nthat are not available in the releases. On the other hand the git\nrepository version might not even compile.\n\n## 2.1. Requirements\n\n### 2.1.1. Hard requirements\n\nIn order to compile MKVToolNix, you need a couple of libraries. Most of\nthem should be available pre-compiled for your distribution. The\nprograms and libraries you absolutely need are:\n\n- A C++ compiler that supports several features of the C++11, C++14,\n  C++17 \u0026 C++20 standards: initializer lists, range-based `for` loops,\n  right angle brackets, the `auto` keyword, lambda functions, the\n  `nullptr` keyword, tuples, alias declarations, `std::make_unique()`,\n  digit separators, binary literals, generic lambdas, user-defined\n  literals for `std::string`, `[[maybe_unused]]` attribute, nested\n  namespace definition, structured bindings, `std::optional`,\n  designated initializers, concepts, three-way comparison\n  operators. Others may be needed, too. For GCC this means at least\n  v10; for clang v10 or later.\n\n- [libOgg](http://downloads.xiph.org/releases/ogg/) and\n  [libVorbis](http://downloads.xiph.org/releases/vorbis/) for access to Ogg/OGM\n  files and Vorbis support\n\n- [zlib](http://www.zlib.net/) — a compression library\n\n- [Boost](http://www.boost.org/) — Several of Boost's libraries are\n  used, e.g. `filesystem`, `multi-precision`, `operators`,\n  `system`. At least v1.66.0 is required.\n\n- [libxslt's xsltproc binary](http://xmlsoft.org/libxslt/) and\n  [DocBook XSL stylesheets](https://sourceforge.net/projects/docbook/files/docbook-xsl/)\n  — for creating man pages from XML documents\n\nYou also need the `rake` or `drake` build program. I suggest `rake`\nv10.0.0 or newer (this is included with Ruby 2.1) as it offers\nparallel builds out of the box. If you only have an earlier version of\n`rake`, you can install and use the `drake` gem for the same gain.\n\n### 2.1.2. Requirements with bundled fallbacks\n\nSeveral required libraries might not be available for your\ndistribution. Therefore they're bundled with the MKVToolNix source\ncode. The `configure` script will look for those libraries and use\nexisting versions if present. If not, the bundled versions are used\ninstead.\n\nIt is highly recommended to install the versions provided by your\ndistribution instead of relying on the bundled versions.\n\nThese libraries are:\n\n- [fmt](http://fmtlib.net/) — a small, safe and fast formatting\n  library. Version 8.0.0 or later is required.\n\n- [libEBML v1.4.4](http://dl.matroska.org/downloads/libebml/) or later\n  and [libMatroska v1.7.1](http://dl.matroska.org/downloads/libmatroska/)\n  or later for low-level access to Matroska files. Instructions on how to\n  compile them are a bit further down in this file.\n\n- [librmff](https://www.bunkus.org/videotools/librmff/index.html) — a\n  library for accessing RealMedia files\n\n- [nlohmann's JSON](https://github.com/nlohmann/json) — JSON for\n  Modern C++\n\n- [Qt](http://www.qt.io/) v6.2.0 or newer — a cross-platform library\n  including a UI toolkit. The library is needed for all programs, even\n  if you decide not to build MKVToolNix GUI.\n\n- [pugixml](http://pugixml.org/) — light-weight, simple and fast XML\n  parser for C++ with XPath support\n\n- [utf8-cpp](http://utfcpp.sourceforge.net/) — UTF-8 with C++ in a\n  Portable Way\n\n## 2.2. Optional components\n\nOther libraries are optional and only limit the features that are\nbuilt. These include:\n\n- [cmark](https://github.com/commonmark/cmark) — the CommonMark\n  parsing and rendering library in C is required when building\n  MKVToolNix GUI.\n\n- [libFLAC](http://downloads.xiph.org/releases/flac/) for FLAC\n  support (Free Lossless Audio Codec)\n\n- [po4a](https://po4a.alioth.debian.org/) for building the translated\n  man pages\n\n## 2.3. Building libEBML and libMatroska\n\nThis is optional as MKVToolNix comes with its own set of the\nlibraries. It will use them if no version is found on the system.\n\nStart by either downloading the latest releases of\n[libEBML](http://dl.matroska.org/downloads/libebml/) and\n[libMatroska](http://dl.matroska.org/downloads/libmatroska/) or by\ngetting fresh copies from their git repositories:\n\n    git clone https://github.com/Matroska-Org/libebml.git\n    git clone https://github.com/Matroska-Org/libmatroska.git\n\nFirst build and install libEBML according to the included\ninstructions. Afterwards do the same for libMatroska.\n\n## 2.4. Building MKVToolNix\n\nEither download the current release from\n[the MKVToolNix home page](https://mkvtoolnix.download/)\nand unpack it or get a development snapshot from my Git repository.\n\n### 2.4.1. Getting and building a development snapshot\n\nYou can ignore this subsection if you want to build from a release\ntarball.\n\nAll you need for Git repository access is to download a Git client\nfrom the Git homepage at http://git-scm.com/. There are clients\nfor both Unix/Linux and Windows.\n\nFirst clone my Git repository with this command:\n\n    git clone https://gitlab.com/mbunkus/mkvtoolnix.git\n\nNow change to the MKVToolNix directory with `cd mkvtoolnix` and run\n`./autogen.sh` which will generate the \"configure\" script. You need\nthe GNU \"autoconf\" utility for this step.\n\n### 2.4.2. Configuration and compilation\n\nIf you have run `make install` for both libraries, then `configure`\nshould automatically find the libraries' position. Otherwise you need\nto tell `configure` where the libEBML and libMatroska include and\nlibrary files are:\n\n    ./configure \\\n      --with-extra-includes=/where/i/put/libebml\\;/where/i/put/libmatroska \\\n      --with-extra-libs=/where/i/put/libebml/make/linux\\;/where/i/put/libmatroska/make/linux\n\nNow run `rake` and, as \"root\", `rake install`.\n\n### 2.4.3. If things go wrong\n\nBy default the commands executed by the build system aren't\noutput. You can change that by adding `V=1` as an argument to the\n`rake` command.\n\nIf `rake` executes too many processes at once, then you've stumbled\nacross a known bug in `rake`. In that case you should install the\n`drake` Ruby gem and use the command `drake` instead of\n`rake`. `drake` supports parallelism properly and doesn't try to\nexecute all jobs at once.\n\n## 2.5. Notes for compilation on (Open)Solaris\n\nYou can compile MKVToolNix with Sun's sunstudio compiler, but you need\nadditional options for `configure`:\n\n    ./configure --prefix=/usr \\\n      CXX=\"/opt/sunstudio12.1/bin/CC -library=stlport4\" \\\n      CXXFLAGS=\"-D_POSIX_PTHREAD_SEMANTICS\" \\\n      --with-extra-includes=/where/i/put/libebml\\;/where/i/put/libmatroska \\\n      --with-extra-libs=/where/i/put/libebml/make/linux\\;/where/i/put/libmatroska/make/linux\n\n## 2.6. Unit tests\n\nBuilding and running unit tests is completely optional. If you want to\ndo this, you have to follow these steps:\n\n1. Download the \"googletest\" framework from\n   https://github.com/google/googletest/ (at the time of writing the\n   file to download was \"googletest-release-1.8.0.tar.gz\")\n\n2. Extract the archive somewhere and create a symbolic link to its\n   `googletest-release-1.8.0/googletest` sub-directory\n   inside MKVToolNix' `lib` directory and call it `gtest`, e.g. like this:\n\n   `ln -s /path/to/googletest-release-1.8.0/googletest lib/gtest`\n\n3. Configure MKVToolNix normally.\n\n4. Build the unit test executable and run it with\n\n        rake tests:run_unit\n\n\n# 3. Reporting bugs \u0026 getting support\n\n# 3.1. Reporting bugs\n\nIf you're sure you've found a bug — e.g. if one of my programs crashes\nwith an obscur error message, or if the resulting file is missing part\nof the original data, then by all means submit a bug report.\n\nI use [GitLab's issue system](https://gitlab.com/mbunkus/mkvtoolnix/issues)\nas my bug database. You can submit your bug reports there. Please be as\nverbose as possible — e.g. include the command line, if you use Windows\nor Linux etc.pp.\n\nIf at all possible, please include sample files as well so that I can\nreproduce the issue. If they are larger than 1 MB, please upload\nthem somewhere and post a link in the issue. You can also upload them\nto my FTP server. Details on how to connect can be found in the\n[MKVToolNix FAQ](https://gitlab.com/mbunkus/mkvtoolnix/wikis/FTP-server).\n\n# 3.2. Getting support\n\nThe issue tracker above is not meant for general support which you can\nfind in the following places:\n\n* The [MKVToolNix help forum](https://help.mkvtoolnix.download/) is\n  suitable for all kinds of questions.\n* The MKVToolNix thread on [Doom9's\n  forum](http://forum.doom9.org/showthread.php?t=155732) is more\n  suited for in-depth technical questions.\n* There's also the IRC channel `#matroska` on the [Libera IRC\n  network](https://libera.chat/) where we hang out. The main\n  MKVToolNix author Moritz Bunkus is known as \"mosu\" there.\n\n\n# 4. Test suite and continuous integration tests\n\nMKVToolNix contains a lot of test cases in order to detect regressions\nbefore they're released. Regressions include both compilation issues\nas well as changes from expected program behavior.\n\nAs mentioned in section 2.6., MKVToolNix comes with a set of unit\ntests based on the Google Test library in the `tests/unit`\nsub-directory that you can run yourself. These cover only a small\namount of code, and any effort to extend them would be most welcome.\n\nA second test suite exists that targets the program behavior, e.g. the\noutput generated by mkvmerge when specific options are used with\nspecific input files. These are the test cases in the `tests`\ndirectory itself. Unfortunately the files they run on often contain\ncopyrighted material that I cannot distribute. Therefore you cannot\nrun them yourself.\n\nA third pillar of the testing effort is the\n[continuous integration tests](https://buildbot.mkvtoolnix.download/)\nrun on a Buildbot instance. These are run automatically for each\ncommit made to the git repository. The tests include:\n\n  * building of all the packages for Linux distributions that I\n    normally provide for download myself in both 32-bit and 64-bit\n    variants\n  * building of the Windows installer and portable packages in both\n    32-bit and 64-bit variants\n  * building with both g++ and clang++\n  * building and running the unit tests\n  * building and running the test file test suite\n  * building with all optional features disabled\n\n# 5. Code of Conduct\n\nPlease note that this project is released with a\n[Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project\nyou agree to abide by its terms.\n\n# 6. Included third-party components and their licenses\n\nMKVToolNix includes and uses the following libraries \u0026 artwork:\n\n## 6.1. avilib\n\nReading and writing AVI files. Originally part of the `transcode`\npackage.\n\n  * Copyright: 1999 Rainer Johanni \u003cRainer@Johanni.de\u003e\n  * License: GNU General Public License v2 or later\n  * URL: the `transcode` project doesn't seem to have a home page anymore\n  * Corresponding files: `lib/avilib-0.6.10/*`\n\n## 6.2. libEBML\n\nA C++ library to parse EBML files\n\n  * Copyright: 2002-2021 Steve Lhomme et. al.\n  * License: GNU Lesser General Public License v2.1 or later (see `doc/licenses/LGPL-2.1.txt`)\n  * URL: http://www.matroska.org/\n  * Corresponding files: `lib/libebml/*`\n\n## 6.3. libMatroska\n\nA C++ library to parse Matroska files\n\n  * Copyright: 2002-2020 Steve Lhomme et. al.\n  * License: GNU Lesser General Public License v2.1 or later (see `doc/licenses/LGPL-2.1.txt`)\n  * URL: http://www.matroska.org/\n  * Corresponding files: `lib/libmatroska/*`\n\n## 6.4. librmff\n\nlibrmff is short for 'RealMedia file format access library'. It aims\nat providing the programmer an easy way to read and write RealMedia\nfiles.\n\n  * Copyright: Moritz Bunkus\n  * License: GNU Lesser General Public License v2.1 or later (see `doc/licenses/LGPL-2.1.txt`)\n  * URL: https://www.bunkus.org/videotools/librmff/index.html\n  * Corresponding files: `lib/librmff/*`\n\n## 6.5. nlohmann's JSON\n\nJSON for Modern C++\n\n  * Copyright: 2013-2021 Niels Lohmann\n  * License: MIT (see `doc/licenses/nlohmann-json-MIT.txt`)\n  * URL: https://github.com/nlohmann/json\n  * Corresponding files: `lib/nlohmann-json/*`\n\n## 6.6. pugixml\n\nAn XML processing library\n\n  * Copyright: 2006–2020 by Arseny Kapoulkine \u003carseny.kapoulkine@gmail.com\u003e\n  * License: MIT (see `doc/licenses/pugixml-MIT.txt`)\n  * URL: https://pugixml.org/\n  * Corresponding files: `lib/pugixml/*`\n\n## 6.7. utf8-cpp\n\nUTF-8 with C++ in a Portable Way\n\n  * Copyright: 2006-2021 Nemanja Trifunovic\n  * License: Boost Software License 1.0 (see `doc/licenses/Boost-1.0.txt`)\n  * URL: https://github.com/nemtrif/utfcpp/\n  * Corresponding files: `lib/utf8-cpp/*`\n\n## 6.8. Oxygen icons and sound files\n\nA lot of the icons included in this package originate from the Oxygen\nProject. These include all files in the `share/icons/oxygen`\nsub-directory.\n\nAll of the sound files in the `share/sounds` sub-directory originate\nfrom the Oxygen project.\n\n  * License: GNU Lesser General Public License v3 (see `doc/licenses/LGPL-3.0.txt`)\n  * URL: https://techbase.kde.org/Projects/Oxygen\n  * Corresponding files:\n    * `share/icons/oxygen/*`\n    * `share/sounds/*`\n\n## 6.9. MKVToolNix icons\n\n  * Copyright:\n    * 2011 Alexandr Grigorcea \u003ccahr.gr@gmail.com\u003e\n    * 2012 Eduard Geier \u003cedu.g@online.de\u003e\n    * 2012 Ben Humpert \u003cben@an3k.de\u003e\n  * License: Creative Commons Attribution 3.0 Unported (CC BY 3.0) (see `doc/licenses/CC-BY-3.0.txt`)\n  * Corresponding files: `share/icons/*/mkv*`\n\n## 6.10. QtWaitingSpinner\n\nA highly configurable, custom Qt widget for showing \"waiting\" or\n\"loading\" spinner icons in Qt applications\n\n  * Copyright:\n    * 2012–2014 by Alexander Turkin\n    * 2014 by William Hallatt\n    * 2015 by Jacob Dawid\n  * License: MIT (see `doc/licenses/QtWaitingSpinner-MIT.txt`)\n  * URL: https://github.com/snowwlex/QtWaitingSpinner\n  * Corresponding files: `src/mkvtoolnix-gui/util/waiting_spinning_widget.{h,cpp}`\n\n## 6.11. Fancy tab widget\n\nA beefed-up tab widget class for Qt extracted from the Qt Creator project\n\n  * Copyright: 2011 Nokia Corporation and/or its subsidiary(-ies).\n  * License: GNU General Public License v2 (see `COPYING`)\n  * Corresponding files: `src/mkvtoolnix-gui/util/fancy_tab_widget.{h,cpp}`\n\n## 6.12. fmt\n\nSmall, safe and fast formatting library\n\n  * Copyright: 2012–present by Victor Zverovich\n  * License: BSD (see `doc/licenses/fmt-BSD.txt`)\n  * URL: https://fmt.dev/latest/\n  * Corresponding files: `lib/fmt/*`\n\n## 6.13. QgsCollapsibleGroupBox\n\nA groupbox that collapses/expands when toggled. Extracted from the QGIS project.\n\n  * Copyright: 2012–present by Etienne Tourigny\n  * License: GNU General Public License v2 or later (see `COPYING`)\n  * URL: https://github.com/qgis/QGIS\n  * Corresponding files: `src/mkvtoolnix-gui/util/qgs_collapsible_group_box.{h,cpp}`\n\n## 6.14. Windows theme\n\nThe theme (palette) used on Windows\n\n  * Copyright: 2016 The Qt Company Ltd.\n  * License: GNU General Public License v2 (see `COPYING`)\n  * Corresponding files: `src/mkvtoolnix-gui/app/windows.cpp`\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacsimiles%2Fmkvtoolnix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffacsimiles%2Fmkvtoolnix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacsimiles%2Fmkvtoolnix/lists"}