API Reference

See also

See libtmux’s API and Quickstart to see how you can control tmux via python API calls.

• Internals
  • Config reader - tmuxp._internal.config_reader
    • ConfigReader
      • _load()
      • load()
      • _from_file()
      • from_file()
      • _dump()
      • dump()
  • Typings - tmuxp._internal.types
    • PluginConfigSchema
      • plugin_name
      • tmux_min_version
      • tmux_max_version
      • tmux_version_incompatible
      • libtmux_min_version
      • libtmux_max_version
      • libtmux_version_incompatible
      • tmuxp_min_version
      • tmuxp_max_version
      • tmuxp_version_incompatible
• CLI
  • tmuxp convert - tmuxp.cli.convert
    • create_convert_subparser()
    • ConvertUnknownFileType
    • command_convert()
  • tmuxp debug-info - tmuxp.cli.debug_info
    • create_debug_info_subparser()
    • command_debug_info()
  • tmuxp edit - tmuxp.cli.edit
    • create_edit_subparser()
    • command_edit()
  • tmuxp freeze - tmuxp.cli.freeze
    • CLIFreezeNamespace
      • session_name
      • socket_name
      • socket_path
      • workspace_format
      • save_to
      • answer_yes
      • quiet
      • force
    • create_freeze_subparser()
    • command_freeze()
  • tmuxp import - tmuxp.cli.import_config
    • get_tmuxinator_dir()
    • get_teamocil_dir()
    • _resolve_path_no_overwrite()
    • command_import()
    • create_import_subparser()
    • ImportConfigFn
      • _abc_impl
      • _is_protocol
    • import_config()
    • command_import_tmuxinator()
    • command_import_teamocil()
  • tmuxp load - tmuxp.cli.load
    • CLILoadNamespace
      • workspace_files
      • socket_name
      • socket_path
      • tmux_config_file
      • new_session_name
      • answer_yes
      • append
      • colors
      • log_file
    • load_plugins()
    • _reattach()
    • _load_attached()
    • _load_detached()
    • _load_append_windows_to_current_session()
    • _setup_plugins()
    • load_workspace()
    • create_load_subparser()
    • command_load()
  • tmuxp ls - tmuxp.cli.ls
    • create_ls_subparser()
    • command_ls()
  • tmuxp shell - tmuxp.cli.shell
    • CLIShellNamespace
      • session_name
      • socket_name
      • socket_path
      • colors
      • log_file
      • window_name
      • command
      • shell
      • use_pythonrc
      • use_vi_mode
    • create_shell_subparser()
    • command_shell()
  • CLI utilities - tmuxp.cli.utils
    • tmuxp_echo()
    • prompt()
    • prompt_bool()
    • prompt_yes_no()
    • prompt_choices()
    • strip_ansi()
    • _interpret_color()
    • UnknownStyleColor
    • style()
    • unstyle()
  • tmuxp.cli
    • create_parser()
    • CLINamespace
      • log_level
      • subparser_name
      • import_subparser_name
      • version
    • cli()
    • startup()
• Workspace
  • Builder - tmuxp.workspace.builder
    • get_default_columns()
    • get_default_rows()
    • WorkspaceBuilder
      • session_name
      • server
      • _session
      • session
      • session_exists()
      • build()
      • iter_create_windows()
      • iter_create_panes()
      • config_after_window()
      • find_current_attached_session()
      • first_window_pass()
  • Constants - tmuxp.workspace.constants
  • Finders - tmuxp.workspace.finders
    • is_workspace_file()
    • in_dir()
    • in_cwd()
    • get_workspace_dir()
    • find_workspace_file()
    • is_pure_name()
  • Freezer - tmuxp.workspace.freezer
    • inline()
    • freeze()
  • Importers - tmuxp.workspace.importers
    • import_tmuxinator()
    • import_teamocil()
  • Loader - tmuxp.workspace.loader
    • expandshell()
    • expand_cmd()
    • expand()
    • trickle()
  • Validation - tmuxp.workspace.validation
    • SchemaValidationError
    • SessionNameMissingValidationError
    • WindowListMissingValidationError
    • WindowNameMissingValidationError
    • InvalidPluginsValidationError
    • validate_schema()
• Exceptions - tmuxp.exc
  • TmuxpException
  • WorkspaceError
  • SessionNotFound
  • WindowNotFound
  • PaneNotFound
  • EmptyWorkspaceException
  • SessionMissingWorkspaceException
  • ActiveSessionMissingWorkspaceException
  • TmuxpPluginException
  • BeforeLoadScriptNotExists
  • BeforeLoadScriptError
• Logging - tmuxp.log
  • setup_logger()
  • set_style()
  • LogFormatter
    • template()
    • format()
  • debug_log_template()
  • DebugLogFormatter
    • template()
• Plugin - tmuxp.plugin
  • TMUX_MIN_VERSION
  • TMUX_MAX_VERSION
  • LIBTMUX_MIN_VERSION
  • LIBTMUX_MAX_VERSION
  • TMUXP_MIN_VERSION
  • TMUXP_MAX_VERSION
  • Config
    • plugin_name
    • tmux_min_version
    • tmux_max_version
    • tmux_version_incompatible
    • libtmux_min_version
    • libtmux_max_version
    • libtmux_version_incompatible
    • tmuxp_min_version
    • tmuxp_max_version
    • tmuxp_version_incompatible
  • validate_plugin_config()
  • setup_plugin_config()
  • TmuxpPlugin
    • _version_check()
    • _pass_version_check()
    • before_workspace_builder()
    • on_window_create()
    • after_window_finished()
    • before_script()
    • reattach()
• Shell - tmuxp.shell
  • has_ipython()
  • has_ptpython()
  • has_ptipython()
  • has_bpython()
  • detect_best_shell()
  • get_bpython()
  • get_ipython_arguments()
  • get_ipython()
  • get_ptpython()
  • get_ptipython()
  • get_launch_args()
  • get_code()
  • launch()
• Utilities - tmuxp.util
  • run_before_script()
  • oh_my_zsh_auto_title()
  • get_current_pane()
  • get_session()
  • get_window()
  • get_pane()
• Typings - tmuxp.types
  • StrPath