2023-05-28 06:13:09 -04:00
|
|
|
ALACRITTY-MSG(1)
|
|
|
|
|
|
|
|
# NAME
|
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
alacritty-msg - Send messages to Alacritty.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# SYNOPSIS
|
|
|
|
|
|
|
|
This command communicates with running Alacritty instances through a socket,
|
|
|
|
making it possible to control Alacritty without directly accessing it.
|
|
|
|
|
|
|
|
# OPTIONS
|
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
*-s, --socket* _<SOCKET>_
|
|
|
|
|
|
|
|
Path for IPC socket communication.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# MESSAGES
|
|
|
|
|
|
|
|
*create-window*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Create a new window in the same Alacritty process.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-08 01:03:24 -05:00
|
|
|
*FLAGS*
|
2023-05-28 06:13:09 -04:00
|
|
|
*--hold*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Remain open after child process exits.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-08 01:03:24 -05:00
|
|
|
*OPTIONS*
|
2023-11-23 12:39:18 -05:00
|
|
|
*--working-directory* _<WORKING_DIRECTORY>_
|
|
|
|
|
|
|
|
Start the shell in the specified working directory.
|
|
|
|
|
|
|
|
*-T, --title* _<TITLE>_
|
|
|
|
|
|
|
|
Defines the window title.
|
|
|
|
|
|
|
|
Default: _Alacritty_
|
|
|
|
|
|
|
|
*--class* _<GENERAL>_ | _<GENERAL>_,_<INSTANCE>_
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Defines window class/app_id on X11/Wayland.
|
2023-11-08 01:03:24 -05:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Default: _Alacritty,Alacritty_
|
2023-11-08 01:03:24 -05:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
*-o, --option* _<OPTION>..._
|
2023-11-08 01:03:24 -05:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Override configuration file options.
|
|
|
|
|
|
|
|
Example: _alacritty msg create-window -o 'cursor.style="Beam"'_
|
|
|
|
|
|
|
|
*-e, --command* _<COMMAND>..._
|
|
|
|
|
|
|
|
Command and args to execute (must be last argument).
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
*config*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Update the Alacritty configuration.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
*ARGS*
|
|
|
|
*<CONFIG_OPTIONS>...*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Configuration file options.
|
|
|
|
|
|
|
|
Example: _alacritty msg config 'cursor.style="Beam"'_
|
2023-11-08 01:03:24 -05:00
|
|
|
|
|
|
|
*FLAGS*
|
|
|
|
*-r, --reset*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Clear all runtime configuration changes.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
*OPTIONS*
|
2023-11-23 12:39:18 -05:00
|
|
|
*-w, --window-id* _<WINDOW_ID>_
|
|
|
|
|
2023-05-28 06:13:09 -04:00
|
|
|
Window ID for the new config.
|
|
|
|
|
|
|
|
Use _-1_ to apply this change to all windows.
|
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Default: _$ALACRITTY_WINDOW_ID_
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# SEE ALSO
|
|
|
|
|
2023-07-01 08:41:09 -04:00
|
|
|
*alacritty*(1), *alacritty*(5), *alacritty-bindings*(5)
|
|
|
|
|
2023-05-28 06:13:09 -04:00
|
|
|
# BUGS
|
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Found a bug? Please report it at _https://github.com/alacritty/alacritty/issues_.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# MAINTAINERS
|
|
|
|
|
|
|
|
- Christian Duerr <contact@christianduerr.com>
|
|
|
|
- Kirill Chibisov <contact@kchibisov.com>
|