Python API

method libtmux latest

Window.show_hooks

Return a dict of hooks for the target.

Source and package

Qualified name: libtmux.Window.show_hooks
Module: libtmux
Declared in: Window
Package: libtmux
Source: src/libtmux/hooks.py
Other languages: Perl Erlang PowerShell Julia Elixir Haskell Common Lisp RubyLuaTypeScript Rust GoJavaC# C++ Swift Kotlin Scala OCamlfunction F# Clojure

show_hooks ( self, global_: bool | None = False, scope: OptionScope | _DefaultOptionScope | None = DEFAULT_OPTION_SCOPE, ) → HookDict method [source] ¶

Examples#

>>> session.set_hook('session-renamed[0]', 'display-message "test"')
Session($...)

>>> hooks = session.show_hooks()
>>> isinstance(hooks, dict)
True

>>> 'session-renamed[0]' in hooks
True

>>> session.unset_hook('session-renamed')
Session($...)

Parameters

global_ (bool | None) # – Pass -g flag for global hooks, default False.
scope (OptionScope | _DefaultOptionScope | None) # – Hook scope (Server/Session/Window/Pane), defaults to object's scope.

Returns

HookDict Dictionary mapping hook names to their values.

The tmux commands behind show_hooks.

The C declarations in tmux that implement these commands.

Events that run tmux commands, with the scope each hook belongs to and where tmux fires it.

Read a window's hooks

Equivalents of Read a window's hooks in other languages
Language	Equivalent
Ruby	`LibTmux::Window#hooks`
Lua	`libtmux.Window:list_hooks`
Haskell	No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
TypeScript	`window.Window.showHooks`
Rust	no whole-table read; `Window.hook` reads one
Go	`tmux.Window.Hooks`
Java	`io.github.libtmux.Window.hooks`
C#	`LibTmux.Window.Hooks`
C++	no equivalent on `Window`
Swift	`Server.hooks(_:)`
OCaml	`Libtmux_unix.Client.capture_hooks` Pass the corresponding explicit Options scope; captured tables preserve their source and inheritance policy.
Perl	No dedicated equivalent in the selected Perl surface. Explicit Server::cmd remains available for native tmux commands.

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