{
  "id": "mpv",
  "name": "mpv",
  "homepage": "https://mpv.io",
  "description": "a free, open source, and cross-platform media player",
  "icon": "SimpleIcons:mpv",
  "executables": [
    "mpv"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/mpv/",
      "~/.mpv/"
    ],
    "exclude": [
      "[configHome]/mpv/watch_later/",
      "~/.mpv/watch_later/",
      "%LOCALAPPDATA%/mpv/watch_later/",
      "%LOCALAPPDATA%/mpv/cache/"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Play media",
    "description": "Play one or more files or URLs with common startup options. Video output, filters, shaders and scripting options are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "manual",
        "kind": "manual",
        "url": "https://mpv.io/manual/stable/",
        "revision": "master 2026-10",
        "evidence": "--start=<relative time>\n--speed=<0.01-100>\n--volume=<value>\n--mute=<yes|no>  Set startup audio mute status (default: no). e.g. --mute=yes\n--pause\n--loop-file=<N|inf|no>, --loop=<N|inf|no>\n--loop-playlist=<N|inf|force|no>, --loop-playlist\n--shuffle=<yes|no>\n--sub-file=<filename>\n--audio-file=<file>\n--really-quiet\n--no-config\n--fs\n--ontop\n--title=<string>\n--geometry=<[W[xH]][+-x+-y][/WS]>, --geometry=<x:y>\n"
      }
    ],
    "field": [
      {
        "id": "files",
        "label": "Files or URLs",
        "type": "string",
        "position": 0,
        "multiple": true,
        "sources": [
          "manual"
        ]
      },
      {
        "id": "start",
        "label": "Start at",
        "description": "Time as [[hh:]mm:]ss[.ms]; a leading - counts from the end.",
        "type": "string",
        "option": [
          "--start"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "speed",
        "label": "Speed",
        "type": "number",
        "option": [
          "--speed"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "volume",
        "label": "Startup volume",
        "type": "number",
        "option": [
          "--volume"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "mute",
        "label": "Start muted",
        "type": "boolean",
        "option": [
          "--mute=yes"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "pause",
        "label": "Start paused",
        "type": "boolean",
        "option": [
          "--pause"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "loop_file",
        "label": "Loop file",
        "description": "A count, inf, or no.",
        "type": "string",
        "option": [
          "--loop-file"
        ],
        "suggestions": [
          {
            "value": "inf",
            "label": "Forever"
          },
          {
            "value": "no",
            "label": "No"
          }
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "fullscreen",
        "label": "Fullscreen",
        "type": "boolean",
        "option": [
          "--fs"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "sub_file",
        "label": "Subtitle file",
        "type": "path",
        "option": [
          "--sub-file"
        ],
        "path": {
          "kind": "file",
          "role": "input"
        },
        "sources": [
          "manual"
        ]
      },
      {
        "id": "audio_file",
        "label": "External audio file",
        "type": "path",
        "option": [
          "--audio-file"
        ],
        "path": {
          "kind": "file",
          "role": "input"
        },
        "sources": [
          "manual"
        ]
      },
      {
        "id": "no_config",
        "label": "Ignore config files",
        "type": "boolean",
        "option": [
          "--no-config"
        ],
        "sources": [
          "manual"
        ]
      }
    ],
    "task": [
      {
        "id": "play",
        "label": "Play",
        "fields": [
          "files",
          "start",
          "speed",
          "volume",
          "fullscreen",
          "sub_file"
        ],
        "required": [
          "files"
        ]
      },
      {
        "id": "loop",
        "label": "Loop a file",
        "set": {
          "loop_file": [
            "inf"
          ]
        },
        "fields": [
          "files",
          "loop_file",
          "volume",
          "pause"
        ],
        "required": [
          "files"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "files",
          "start",
          "speed",
          "volume",
          "mute",
          "pause",
          "loop_file",
          "fullscreen"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "sub_file",
          "audio_file",
          "no_config"
        ]
      }
    ]
  }
}