mpv-player / mpv-player/mpv

Subtitles: Add support for `directory_mode=recursive`

Open
#12,464 13 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

meta:feature-request
Dominant language
C
Stars
37k
Forks
3.5k
Avg merge
1d 10h
Merged PRs (30d)
22

Description

Current behavior:
sub-auto=fuzzy does not search for more than one directory.

Expected Behavior:
sub-auto=fuzzy will search for more than one directory.

The same way directory_mode=recursive was added to autoload.lua,
I would love to have the option to add subtitle files from recursive directories.

Yes, there's already a solution to what I ask for, called fuzzydir.lua, but it's slow and not builtin mpv.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read autoload.lua to understand how directory_mode=recursive is handled, then compare the existing fuzzydir.lua approach for subtitle discovery. Locate the built-in sub-auto=fuzzy entry point and determine how recursive directories should be supported without relying on fuzzydir.lua; done means fuzzy subtitle lookup searches nested directories while preserving current behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
c, lua
Domain
audio-video-rtc, cli
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.