tmuxp convert

Edit this page on GitHub

tmuxp 1.74.0 · Source

This page documents the available Python tmuxp reference. Proposed native extensions are labeled separately.

Convert a workspace document between YAML and JSON while retaining its mapping keys. Conversion does not prove that a native builder supports every retained field.

Change the file formatLink to section

Given the workspace.yaml from the installation walkthrough, convert it to workspace.json:

$ tmuxp convert \
    --yes \
    workspace.yaml

The destination has the same stem and opposite extension. In the reference, --yes permits replacement of an existing destination without an additional existence check. The original input remains. YAML comments and textual formatting do not round-trip through JSON.

Conversion uses the complete document mapping. A serializer for a reduced native workspace struct can silently discard extension keys and is insufficient for this command. The proposed native machine mode returns a document without writing a guessed destination; its extra save and overwrite controls are described in output.

Arguments and flagsLink to section

All commands accept -h / --help. Root options precede the command; see the CLI overview. The output reference distinguishes current Python flags from proposed all-command JSON and NDJSON.

Parser and implementation source.

tmuxp reference source.