i3-input(1)

1I3-INPUT(1)                        i3 Manual                       I3-INPUT(1)
2
3
4

NAME

6       i3-input - interactively take a command for i3 window manager
7

SYNOPSIS

9       i3-input [-s <socket>] [-F <format>] [-l <limit>] [-P <prompt>] [-f
10       <font>] [-v]
11

DESCRIPTION

13       i3-input is a tool to take commands (or parts of a command) composed by
14       the user, and send it/them to i3. This is useful, for example, for the
15       mark/goto command.
16
17       You can press Escape to close i3-input without sending any commands.
18

OPTIONS

20       -s <socket>
21           Specify the path to the i3 IPC socket (it should not be necessary
22           to use this option, i3-input will figure out the path on its own).
23
24       -F <format>
25           Every occurrence of "%s" in the <format> string is replaced by the
26           user input, and the result is sent to i3 as a command. Default
27           value is "%s".
28
29       -l <limit>
30           Set the maximum allowed length of the user input to <limit>
31           characters. i3-input will automatically issue the command when the
32           user input reaches that length.
33
34       -P <prompt>
35           Display the <prompt> string in front of user input text field. The
36           prompt string is not included in the user input/command.
37
38       -f <font>
39           Use the specified X11 core font (use xfontsel to choose a font).
40
41       -v
42           Show version and exit.
43

EXAMPLES

45       Mark a container with a single character:
46
47           i3-input -F 'mark %s' -l 1 -P 'Mark: '
48
49       Go to the container marked with above example:
50
51           i3-input -F '[con_mark="%s"] focus' -l 1 -P 'Go to: '
52

ENVIRONMENT

54   I3SOCK
55       i3-input handles the different sources of socket paths in the following
56       order:
57
58       •   I3SOCK environment variable
59
60       •   I3SOCK gets overwritten by the -s parameter, if specified
61
62       •   if neither are available, i3-input reads the socket path from the
63           X11 property, which is the recommended way
64
65       •   if everything fails, i3-input tries /tmp/i3-ipc.sock
66
67       The socket path is necessary to connect to i3 and actually issue the
68       command.
69

AUTHOR

74       Michael Stapelberg and contributors
75
76
77
78i3 4.23                           10/29/2023                       I3-INPUT(1)