{
  "id": "csound",
  "name": "Csound",
  "homepage": "https://csound.com",
  "description": "Sound and music computing system",
  "executables": [
    "csound"
  ],
  "dotfiles": {
    "paths": [
      "~/.csoundrc"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Render a CSD file",
    "description": "Render a Csound project (CSD, or orchestra plus score) to a sound file or the audio device. MIDI, realtime buffer, sample-format and display options are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "manual",
        "kind": "manual",
        "url": "https://csound.com/docs/manual/CommandFlags.html",
        "revision": "2026-10-27",
        "evidence": "csound  [flags]  [orchname]  [scorename]\ncsound  [flags]  [csdfilename]\n-o FILE, --output=FILE\nThe name devaudio or dac (you can use -odac or -o dac) will request writing sound to the host audio output device.\n-i FILE, --input=FILE\n-n, --nosound\n-d, --nodisplays\n-v, --verbose\n-r NUM, --sample-rate=NUM\n-k NUM, --control-rate=NUM\n-m NUM, --messagelevel=NUM\n-W, --wave, --format=wave\n-A, --aiff, --format=aiff\n"
      }
    ],
    "field": [
      {
        "id": "files",
        "label": "CSD file, or orchestra and score",
        "type": "path",
        "position": 0,
        "multiple": true,
        "min": 1,
        "path": {
          "kind": "file",
          "role": "input",
          "must_exist": true
        },
        "sources": [
          "manual"
        ]
      },
      {
        "id": "output",
        "label": "Output sound file or dac",
        "description": "A sound file name, or dac for the audio device.",
        "type": "string",
        "option": [
          "--output",
          "-o"
        ],
        "suggestions": [
          {
            "value": "dac",
            "label": "Audio device (dac)"
          }
        ],
        "effect": "overwrite",
        "sources": [
          "manual"
        ]
      },
      {
        "id": "wave",
        "label": "Write WAV file",
        "type": "boolean",
        "option": [
          "--wave",
          "-W"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "aiff",
        "label": "Write AIFF file",
        "type": "boolean",
        "option": [
          "--aiff",
          "-A"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "nosound",
        "label": "No sound output",
        "description": "Run the score without writing any audio.",
        "type": "boolean",
        "option": [
          "--nosound",
          "-n"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "nodisplays",
        "label": "Suppress displays",
        "type": "boolean",
        "option": [
          "--nodisplays",
          "-d"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "verbose",
        "label": "Verbose",
        "type": "boolean",
        "option": [
          "--verbose",
          "-v"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "sample_rate",
        "label": "Sample rate",
        "type": "integer",
        "option": [
          "--sample-rate",
          "-r"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "control_rate",
        "label": "Control rate",
        "type": "integer",
        "option": [
          "--control-rate",
          "-k"
        ],
        "sources": [
          "manual"
        ]
      },
      {
        "id": "input",
        "label": "Input sound file",
        "type": "path",
        "option": [
          "--input",
          "-i"
        ],
        "path": {
          "kind": "file",
          "role": "input",
          "must_exist": true
        },
        "sources": [
          "manual"
        ]
      }
    ],
    "task": [
      {
        "id": "render-wav",
        "label": "Render to WAV",
        "fields": [
          "files",
          "output",
          "wave",
          "nodisplays"
        ],
        "required": [
          "files",
          "output"
        ],
        "set": {
          "wave": [
            true
          ],
          "nodisplays": [
            true
          ]
        }
      },
      {
        "id": "play",
        "label": "Play on audio device",
        "fields": [
          "files",
          "output",
          "nodisplays"
        ],
        "required": [
          "files"
        ],
        "set": {
          "output": [
            "dac"
          ]
        },
        "lock": [
          "output"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "files",
          "output",
          "wave",
          "aiff",
          "nosound"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "nodisplays",
          "verbose",
          "sample_rate",
          "control_rate",
          "input"
        ]
      }
    ]
  }
}