290 lines
8.7 KiB
Text
290 lines
8.7 KiB
Text
// Plugin aliases - can be used to change the implementation of Zellij
|
|
// changing these requires a restart to take effect
|
|
plugins {
|
|
about location="zellij:about"
|
|
compact-bar location="zellij:compact-bar"
|
|
configuration location="zellij:configuration"
|
|
filepicker location="zellij:strider" {
|
|
cwd "/"
|
|
}
|
|
plugin-manager location="zellij:plugin-manager"
|
|
session-manager location="zellij:session-manager"
|
|
status-bar location="zellij:status-bar"
|
|
strider location="zellij:strider"
|
|
tab-bar location="zellij:tab-bar"
|
|
welcome-screen location="zellij:session-manager" {
|
|
welcome_screen true
|
|
}
|
|
autolock location="https://github.com/fresh2dev/zellij-autolock/releases/download/0.2.2/zellij-autolock.wasm" {
|
|
is_enabled true
|
|
triggers "nvim|vim|jj"
|
|
}
|
|
}
|
|
|
|
// Plugins to load in the background when a new session starts
|
|
// eg. "file:/path/to/my-plugin.wasm"
|
|
// eg. "https://example.com/my-plugin.wasm"
|
|
load_plugins {
|
|
autolock
|
|
}
|
|
web_client {
|
|
font "monospace"
|
|
}
|
|
|
|
// Use a simplified UI without special fonts (arrow glyphs)
|
|
// Options:
|
|
// - true
|
|
// - false (Default)
|
|
//
|
|
simplified_ui false
|
|
|
|
// Choose the theme that is specified in the themes section.
|
|
// Default: default
|
|
//
|
|
theme "catppuccin-mocha"
|
|
|
|
// Choose the base input mode of zellij.
|
|
// Default: normal
|
|
//
|
|
|
|
// Choose the path to the default shell that zellij will use for opening new panes
|
|
// Default: $SHELL
|
|
//
|
|
// default_shell "fish"
|
|
|
|
// Choose the path to override cwd that zellij will use for opening new panes
|
|
//
|
|
// default_cwd "/tmp"
|
|
|
|
// The name of the default layout to load on startup
|
|
// Default: "default"
|
|
//
|
|
// default_layout "compact"
|
|
|
|
// The folder in which Zellij will look for layouts
|
|
// (Requires restart)
|
|
//
|
|
// layout_dir "/tmp"
|
|
|
|
// The folder in which Zellij will look for themes
|
|
// (Requires restart)
|
|
//
|
|
// theme_dir "/tmp"
|
|
|
|
// Toggle enabling the mouse mode.
|
|
// On certain configurations, or terminals this could
|
|
// potentially interfere with copying text.
|
|
// Options:
|
|
// - true (default)
|
|
// - false
|
|
//
|
|
// mouse_mode false
|
|
|
|
// Toggle having pane frames around the panes
|
|
// Options:
|
|
// - true (default, enabled)
|
|
// - false
|
|
//
|
|
// pane_frames false
|
|
|
|
// When attaching to an existing session with other users,
|
|
// should the session be mirrored (true)
|
|
// or should each user have their own cursor (false)
|
|
// (Requires restart)
|
|
// Default: false
|
|
//
|
|
// mirror_session true
|
|
|
|
// Choose what to do when zellij receives SIGTERM, SIGINT, SIGQUIT or SIGHUP
|
|
// eg. when terminal window with an active zellij session is closed
|
|
// (Requires restart)
|
|
// Options:
|
|
// - detach (Default)
|
|
// - quit
|
|
//
|
|
// on_force_close "quit"
|
|
|
|
// Configure the scroll back buffer size
|
|
// This is the number of lines zellij stores for each pane in the scroll back
|
|
// buffer. Excess number of lines are discarded in a FIFO fashion.
|
|
// (Requires restart)
|
|
// Valid values: positive integers
|
|
// Default value: 10000
|
|
//
|
|
// scroll_buffer_size 10000
|
|
|
|
// Provide a command to execute when copying text. The text will be piped to
|
|
// the stdin of the program to perform the copy. This can be used with
|
|
// terminal emulators which do not support the OSC 52 ANSI control sequence
|
|
// that will be used by default if this option is not set.
|
|
// Examples:
|
|
//
|
|
// copy_command "xclip -selection clipboard" // x11
|
|
// copy_command "wl-copy" // wayland
|
|
// copy_command "pbcopy" // osx
|
|
//
|
|
// copy_command "pbcopy"
|
|
|
|
// Choose the destination for copied text
|
|
// Allows using the primary selection buffer (on x11/wayland) instead of the system clipboard.
|
|
// Does not apply when using copy_command.
|
|
// Options:
|
|
// - system (default)
|
|
// - primary
|
|
//
|
|
// copy_clipboard "primary"
|
|
|
|
// Enable automatic copying (and clearing) of selection when releasing mouse
|
|
// Default: true
|
|
//
|
|
// copy_on_select true
|
|
|
|
// Path to the default editor to use to edit pane scrollbuffer
|
|
// Default: $EDITOR or $VISUAL
|
|
// scrollback_editor "/usr/bin/vim"
|
|
|
|
// A fixed name to always give the Zellij session.
|
|
// Consider also setting `attach_to_session true,`
|
|
// otherwise this will error if such a session exists.
|
|
// Default: <RANDOM>
|
|
//
|
|
// session_name "My singleton session"
|
|
|
|
// When `session_name` is provided, attaches to that session
|
|
// if it is already running or creates it otherwise.
|
|
// Default: false
|
|
//
|
|
// attach_to_session true
|
|
|
|
// Toggle between having Zellij lay out panes according to a predefined set of layouts whenever possible
|
|
// Options:
|
|
// - true (default)
|
|
// - false
|
|
//
|
|
// auto_layout false
|
|
|
|
// Whether sessions should be serialized to the cache folder (including their tabs/panes, cwds and running commands) so that they can later be resurrected
|
|
// Options:
|
|
// - true (default)
|
|
// - false
|
|
//
|
|
// session_serialization false
|
|
|
|
// Whether pane viewports are serialized along with the session, default is false
|
|
// Options:
|
|
// - true
|
|
// - false (default)
|
|
//
|
|
// serialize_pane_viewport false
|
|
|
|
// Scrollback lines to serialize along with the pane viewport when serializing sessions, 0
|
|
// defaults to the scrollback size. If this number is higher than the scrollback size, it will
|
|
// also default to the scrollback size. This does nothing if `serialize_pane_viewport` is not true.
|
|
//
|
|
// scrollback_lines_to_serialize 10000
|
|
|
|
// Enable or disable the rendering of styled and colored underlines (undercurl).
|
|
// May need to be disabled for certain unsupported terminals
|
|
// (Requires restart)
|
|
// Default: true
|
|
//
|
|
// styled_underlines false
|
|
|
|
// How often in seconds sessions are serialized
|
|
//
|
|
// serialization_interval 10000
|
|
|
|
// Enable or disable writing of session metadata to disk (if disabled, other sessions might not know
|
|
// metadata info on this session)
|
|
// (Requires restart)
|
|
// Default: false
|
|
//
|
|
// disable_session_metadata false
|
|
|
|
// Enable or disable support for the enhanced Kitty Keyboard Protocol (the host terminal must also support it)
|
|
// (Requires restart)
|
|
// Default: true (if the host terminal supports it)
|
|
//
|
|
// support_kitty_keyboard_protocol false
|
|
// Whether to make sure a local web server is running when a new Zellij session starts.
|
|
// This web server will allow creating new sessions and attaching to existing ones that have
|
|
// opted in to being shared in the browser.
|
|
// When enabled, navigate to http://127.0.0.1:8082
|
|
// (Requires restart)
|
|
//
|
|
// Note: a local web server can still be manually started from within a Zellij session or from the CLI.
|
|
// If this is not desired, one can use a version of Zellij compiled without
|
|
// `web_server_capability`
|
|
//
|
|
// Possible values:
|
|
// - true
|
|
// - false
|
|
// Default: false
|
|
//
|
|
// web_server false
|
|
// Whether to allow sessions started in the terminal to be shared through a local web server, assuming one is
|
|
// running (see the `web_server` option for more details).
|
|
// (Requires restart)
|
|
//
|
|
// Note: This is an administrative separation and not intended as a security measure.
|
|
//
|
|
// Possible values:
|
|
// - "on" (allow web sharing through the local web server if it
|
|
// is online)
|
|
// - "off" (do not allow web sharing unless sessions explicitly opt-in to it)
|
|
// - "disabled" (do not allow web sharing and do not permit sessions started in the terminal to opt-in to it)
|
|
// Default: "off"
|
|
//
|
|
// web_sharing "off"
|
|
// A path to a certificate file to be used when setting up the web client to serve the
|
|
// connection over HTTPs
|
|
//
|
|
// web_server_cert "/path/to/cert.pem"
|
|
// A path to a key file to be used when setting up the web client to serve the
|
|
// connection over HTTPs
|
|
//
|
|
// web_server_key "/path/to/key.pem"
|
|
/// Whether to enforce https connections to the web server when it is bound to localhost
|
|
/// (127.0.0.0/8)
|
|
///
|
|
/// Note: https is ALWAYS enforced when bound to non-local interfaces
|
|
///
|
|
/// Default: false
|
|
//
|
|
// enforce_https_for_localhost false
|
|
|
|
// Whether to stack panes when resizing beyond a certain size
|
|
// Default: true
|
|
//
|
|
// stacked_resize false
|
|
|
|
// Whether to show tips on startup
|
|
// Default: true
|
|
//
|
|
show_startup_tips false
|
|
|
|
// Whether to show release notes on first version run
|
|
// Default: true
|
|
//
|
|
// show_release_notes false
|
|
|
|
// Whether to enable mouse hover effects and pane grouping functionality
|
|
// default is true
|
|
// advanced_mouse_actions false
|
|
|
|
// The ip address the web server should listen on when it starts
|
|
// Default: "127.0.0.1"
|
|
// (Requires restart)
|
|
// web_server_ip "127.0.0.1"
|
|
|
|
// The port the web server should listen on when it starts
|
|
// Default: 8082
|
|
// (Requires restart)
|
|
// web_server_port 8082
|
|
|
|
// A command to run (will be wrapped with sh -c and provided the RESURRECT_COMMAND env variable)
|
|
// after Zellij attempts to discover a command inside a pane when resurrecting sessions, the STDOUT
|
|
// of this command will be used instead of the discovered RESURRECT_COMMAND
|
|
// can be useful for removing wrappers around commands
|
|
// Note: be sure to escape backslashes and similar characters properly
|
|
// post_command_discovery_hook "echo $RESURRECT_COMMAND | sed <your_regex_here>"
|