Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hubblec4/mpvMatroska
mpvMatroska is a Lua script that turns mpv into a Matroska player.
https://github.com/hubblec4/mpvMatroska
matroska mpv-script
Last synced: 3 months ago
JSON representation
mpvMatroska is a Lua script that turns mpv into a Matroska player.
- Host: GitHub
- URL: https://github.com/hubblec4/mpvMatroska
- Owner: hubblec4
- Created: 2023-08-28T17:01:08.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-14T00:40:38.000Z (11 months ago)
- Last Synced: 2024-06-30T14:48:10.556Z (5 months ago)
- Topics: matroska, mpv-script
- Language: Lua
- Homepage:
- Size: 80.1 KB
- Stars: 11
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.txt
Awesome Lists containing this project
- awesome-mpv - mpvMatroska - mpvMatroska turns mpv into a Matroska player. (Other)
README
# mpvMatroska
mpvMatroska is a Lua script for mpv which almost turns mpv into a full Matroska player.
The project is under construction and not much is working yet and a lot will change over time.
Nevertheless, there are already some working Matroska features.
## mpvMatroska development
To test the Matroska features I use my [Matroska-Playback](https://github.com/hubblec4/Matroska-Playback) repo.
## Installation
mpvMatroska uses some other Lua modules.
- [LuaEBML](https://github.com/hubblec4/LuaEBML)
- [LuaMatroska](https://github.com/hubblec4/LuaMatroska)
- [LuaMatroskaParser](https://github.com/hubblec4/LuaMatroskaParser)
But to keep everything simple, mpvMatroska uses the `mpv folder system` for scripts that consist of several modules.
All you have to do is copy the mpvMatroska folder into the mpv-scripts folder.
The current version of mpvMatroska can be downloaded in the `Releases`.
### uosc
mpvMatroska uses the GUI from [uosc](https://github.com/tomasklaen/uosc) to display lists and buttons.
mpvMatroska still works without uosc, but then you don't have any selection lists.
## working Matroska features
- Hard-Linking
- Nested chapters
- Ordered chapters
- Nested-Ordered chapters
- Linking chapters (with chapter duration)
- Linked-Edition chapters
- Multiple chapter names
- Multiple edition names
- Video rotation (with `ProjectionPoseRoll` element)
- MatroskaScript menu
## mpvMatroska features
- Automatic switching of edition and chapter names when the audio or subtitle track is changed
- Improved title display: the current edition name is appended to the file name or the file Title(if present)
- Correct edition list: the standard short-cut "E" is processed internally using its own switching method
- Video rotation: with the Matroska Tags (not official in the Matroska specifications)
- Matroska Content-Grouping: not yet officially included in the Matroska specifications
### Matroska Content-Grouping
This Matroska feature is about grouping the content in a Matroska file in a meaningful way.
The content is all track types as well as the editions/chapters.
This is the basic basis of Haali TRACKSETEX.
The Matroska Attachments could be used as additional content, for example to specifically load a font for a subtitle.
The hotkey `g` is available to switch through existing content groups.
Furthermore, a freely selectable hotkey can be set up in the mpv `input.conf` using the `script-message-to` system.
To switch the content groups with the "k" key, the following line is used.
```text
k script-message-to mpvMatroska cycle-contentgroups
```
If uosc is installed you can open the selection menu with the hotkey `ALT+g`.
You can also assign your own hotkey to open the selection menu.
```text
G script-message-to mpvMatroska open-contentgroups
```
You can also install your own button in the control menu in uosc.
To do this you have to adapt the line `controls=` in `uosc.conf`.
I use the following code for this.
```text
command:hub:script-binding mpvMatroska/open-contentgroups?Content-Groups
```
### Matroska Editions
Currently mpv doesn't handle multiple editions correctly and even creates an incorrect list when linking chapters come into play.
Therefore, the mpv internal method should not be used to switch editions.
You can also assign a separate hotkey to switch between editions.
```text
your-key script-message-to mpvMatroska cycle-editions
```
A separate editions button can (and should) be created in the uosc control menu.
To do this you have to adapt the line `controls=` in `uosc.conf`.
The predefined standard entry must be replaced.
```text
// original entry:
editions
// to be replaced with:
command:bookmarks:script-binding mpvMatroska/open-editions?Editions
```