https://github.com/mar04/chapters_for_mpv
mpv script for adding/editing/removing/saving/loading chapters
https://github.com/mar04/chapters_for_mpv
mpv mpv-player mpv-script mpv-scripts
Last synced: about 5 hours ago
JSON representation
mpv script for adding/editing/removing/saving/loading chapters
- Host: GitHub
- URL: https://github.com/mar04/chapters_for_mpv
- Owner: mar04
- License: mit
- Created: 2023-01-23T17:26:23.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-29T10:29:17.000Z (3 months ago)
- Last Synced: 2025-01-29T11:29:30.704Z (3 months ago)
- Topics: mpv, mpv-player, mpv-script, mpv-scripts
- Language: Lua
- Homepage:
- Size: 20.5 KB
- Stars: 54
- Watchers: 1
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- starred - mar04/chapters_for_mpv - mpv script for adding/editing/removing/saving/loading chapters (Lua)
- awesome-mpv - chapters_for_mpv - Add, remove and edit chapters of the currently played media. Chapters you create can be saved into a separate text file and automatically loaded when you open the same media file again. (Playback)
README
# chapters for mpv
It's a script that lets you add, remove and edit chapters of the currently
played media, be it video or audio, local file or a stream. Chapters you create
can be saved into a separate text file and automatically loaded when you open
the same media file again.
This version of the script requires mpv 0.38 or newer.
## Features
* add a new chapter, optionally with a title
* edit existing chapter's title
* remove current chapter
* save chapters as a text file, either in the same directory as the media file
or in a global directory
* save chapters as an xml or txt file
* optionally can hash file paths in an attempt to uniquely identify media files
if chapter files are stored in a central directory
* option to automatically save/load chapter files
* option to use ffmpeg to put the chapters into the media file container as a
metadata, so that other media players, like vlc, can make use of them
* embed chapters in place in mkv container using mkvpropedit
* should work on Unix and Windows (tested on Archlinux and Windows 10)
## Installation
* place **chapters.lua** in your **~/.config/mpv/scripts** directory
* optionally create a config file named **chapters.conf** in **~/.config/mpv/script-opts**, check out example config file
* add keybindings to your **~/.config/mpv/input.conf**, example:
```ini
n script-binding chapters/add_chapter
ctrl+m script-binding chapters/remove_chapter
ctrl+. script-binding chapters/edit_chapter
N script-binding chapters/write_chapters
ctrl+b script-binding chapters/write_xml
B script-binding chapters/write_txt
ctrl+, script-binding chapters/bake_chapters
K script-binding chapters/mkvpropedit
```
## Thanks
* - inspiration for writing this
script. At first I just wanted to add to it the ability to load the saved
chapters file, but then I wrote entirely new script with a lot more features.
Also check out - as I was finishing
my script and thinking how to name it, I found out that someone already wrote
something similar. Duh... at least I got to lear some Lua in the process.
* mpv, ffmpeg and other awesome open source projects