You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+30-9Lines changed: 30 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,16 +17,21 @@ This allows you to preview the end of the file before every thumbnail has been g
17
17
18
18
## How do I install it?
19
19
20
-
Grab both the two `.lua`s from the [**releases page**](https://github.com/TheAMM/mpv_thumbnail_script/releases)(or [see below](#development) how to "build" (concatenate) it yourself) and place them both to your mpv's `scripts` directory. (**Note!** Also see Configuration below)
20
+
Grab both the two `.lua`s from the [**releases page**](https://github.com/TheAMM/mpv_thumbnail_script/releases) and place them both to your mpv's `scripts` directory.
See the [Files section](https://mpv.io/manual/master/#files) in mpv's manual for more info.
26
+
(See the [Files section](https://mpv.io/manual/master/#files) in mpv's manual for more info.)
27
27
28
-
The script can also use FFmpeg for faster thumbnail generation, which is highly recommended.
29
-
Just make sure `ffmpeg[.exe]` is in your `PATH`.
28
+
You should also read the [Configuration](#configuration) section.
29
+
30
+
While the script doesn't need external dependencies and can work with mpv alone, it can also use FFmpeg for *slightly* faster thumbnail generation; just make sure `ffmpeg[.exe]` is in your `PATH` and `prefer_mpv` is set to `no` in your configuration.
31
+
32
+
***However,*** FFmpeg does not support "ordered chapters" in MKVs (segment linking, ie. an `.mkv` references another `.mkv`), which can break the thumbnailing process. You have been warned.
33
+
34
+
In general, you should just use multiple worker scripts ([Configuration](#configuration)) instead of taking the FFmpeg-risk.
30
35
31
36
**Note:** You will need a rather new version of mpv due to [the new binds](https://github.com/mpv-player/mpv/commit/957e9a37db6611fe0879bd2097131df5e09afd47#diff-5d10e79e2d65d30d34f98349f4ed08e4) used in the patched `osc.lua`.
32
37
@@ -42,13 +47,22 @@ You may change this duration check in the configuration (`autogenerate_max_durat
42
47
43
48
**Note!** Because this script replaces the built-in OSC, you will have to set `osc=no` in your mpv's [main config file](https://mpv.io/manual/master/#files).
44
49
45
-
Create a file called `mpv_thumbnail_script.conf` inside your mpv's `lua-settings` directory to adjust the script's options.
50
+
51
+
**Multithreading:**
52
+
This script can use multiple concurrent thumbnailing jobs.
53
+
Simply copy the `mpv_thumbnail_script_server.lua` once or twice (`mpv_thumbnail_script_server-1.lua`, `mpv_thumbnail_script_server-2.lua`) and the workers will automatically register themselves with the core.
54
+
This improves thumbnailing speed a bunch, but you will quickly max out your CPU - I recommend only having two or three copies of the script.
55
+
(Why multiple copies of the same file? mpv gives each script their own thread - easy multithreading!)
56
+
57
+
To adjust the script's options, create a file called `mpv_thumbnail_script.conf` inside your mpv's `lua-settings` directory.
0 commit comments