{
  "id": "ncmpcpp",
  "name": "ncmpcpp",
  "homepage": "https://rybczak.net/ncmpcpp/",
  "description": "An ncurses Music Player Daemon (MPD) client.",
  "executables": [
    "ncmpcpp"
  ],
  "platforms": [
    "macos",
    "linux"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/ncmpcpp/config",
      "[configHome]/ncmpcpp/bindings",
      "~/.ncmpcpp/config",
      "~/.ncmpcpp/bindings"
    ],
    "exclude": [
      "[configHome]/ncmpcpp/lyrics/",
      "~/.ncmpcpp/lyrics/",
      "[configHome]/ncmpcpp/error.log",
      "~/.ncmpcpp/error.log"
    ],
    "secret": [],
    "machine_lines": [
      {
        "file": [
          "[configHome]/ncmpcpp/config",
          "~/.ncmpcpp/config"
        ],
        "match": {
          "prefix": [
            "mpd_music_dir",
            "ncmpcpp_directory",
            "lyrics_directory",
            "mpd_host"
          ]
        },
        "scope": "backup"
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "Start ncmpcpp",
    "description": "Open the MPD client on a server, optionally with a given startup screen or config file.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "man",
        "kind": "manual",
        "url": "https://github.com/ncmpcpp/ncmpcpp/blob/master/doc/ncmpcpp.1",
        "revision": "master (2026-10-27)",
        "evidence": "-h, --host=HOST   Connect to server at host [localhost]\n-p, --port=PORT   Connect to server at port [6600]\n-c, --config=FILE   Specify configuration file(s)\n-b, --bindings=FILE   Specify bindings file(s)\n-s, --screen <name>   Specify the startup screen (<name> may be: help, playlist, browser, search_engine, media_library, playlist_editor, tag_editor, outputs, visualizer, clock)\n-q, --quiet   Suppress logs and excess output"
      }
    ],
    "field": [
      {
        "id": "host",
        "label": "MPD host",
        "type": "string",
        "option": [
          "--host",
          "-h"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "port",
        "label": "MPD port",
        "type": "integer",
        "option": [
          "--port",
          "-p"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "config",
        "label": "Config file",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "input"
        },
        "option": [
          "--config",
          "-c"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "bindings",
        "label": "Bindings file",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "input"
        },
        "option": [
          "--bindings",
          "-b"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "screen",
        "label": "Startup screen",
        "type": "enum",
        "choices": [
          {
            "value": "help",
            "label": "Help"
          },
          {
            "value": "playlist",
            "label": "Playlist"
          },
          {
            "value": "browser",
            "label": "Browser"
          },
          {
            "value": "search_engine",
            "label": "Search engine"
          },
          {
            "value": "media_library",
            "label": "Media library"
          },
          {
            "value": "playlist_editor",
            "label": "Playlist editor"
          },
          {
            "value": "tag_editor",
            "label": "Tag editor"
          },
          {
            "value": "outputs",
            "label": "Outputs"
          },
          {
            "value": "visualizer",
            "label": "Visualizer"
          },
          {
            "value": "clock",
            "label": "Clock"
          }
        ],
        "option": [
          "--screen",
          "-s"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "quiet",
        "label": "Quiet",
        "type": "boolean",
        "option": [
          "--quiet",
          "-q"
        ],
        "sources": [
          "man"
        ]
      }
    ],
    "task": [
      {
        "id": "remote",
        "label": "Connect to a remote MPD",
        "fields": [
          "host",
          "port",
          "screen"
        ],
        "required": [
          "host"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "host",
          "port",
          "screen"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "config",
          "bindings",
          "quiet"
        ]
      }
    ]
  }
}
