Workspace ManagerconceptAPI Reference

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

config.Workspace

This type appears in public signatures. It is not a package entry point.

struct config.Workspace

One workspace: a session and the windows it should contain.

Guides#

Pages that discuss Workspace.

In other ports#

Describe a workspace as data

Equivalents of Describe a workspace as data in other languages
Language Equivalent
Python tmuxp uses configuration dictionaries rather than a dedicated workspace value type
Ruby LibTmux::Workspace
Haskell No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
TypeScript config.Workspace
Go workspace.Workspace
Java io.github.libtmux.workspace.Workspace
C# LibTmux.Workspace.WorkspaceFile
C++ libtmux::workspace::Workspace
Swift Workspace
OCaml Libtmux_workspace.Config.t
Perl LibTmux::Workspace::new Validates and copies a libtmux.workspace/v1 JSON-compatible configuration.

No equivalent is recorded in Lua, PowerShell, Julia, Erlang, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.

Fields9#

Workspace fields
NameTypeDescription
session_name String The session name to create.
start_directory Option<PathBuf> A working directory inherited by windows that do not set their own.
environment Vec<(String, String)> Environment variables to set on the session.
options Vec<(String, String)> Session options to apply once the session exists.
global_options Vec<(String, String)> Global options to apply once the session exists.
shell_command_before Vec<ShellCommand> Commands run in every pane before its own, in order.
suppress_history bool Whether to keep pane commands out of the shell's history.
windows Vec<WindowConfig> The windows to create, in order.
unsupported_keys Vec<String> Keys this parser recognized but does not act on.

Other members5#

Common operations4#

  • to_yaml method Render this workspace as tmuxp-style YAML.
  • from_yaml method Parse one workspace from tmuxp-style YAML.
  • from_yaml_strict method Parse as Self::from_yaml() does, refusing a key that is neither this parser's own vocabulary nor tmuxp's, unless it starts with x-.
  • from_file method Read and parse one workspace file, as tmuxp load does.

Other members1#

Esc

Type to search.

Reference previewOpen reference