2009-11-09 15:28:15 -05:00
|
|
|
i3-input(1)
|
|
|
|
|
=========
|
|
|
|
|
Michael Stapelberg <michael+i3@stapelberg.de>
|
2012-04-22 10:34:20 -04:00
|
|
|
v4.1.2, April 2012
|
2009-11-09 15:28:15 -05:00
|
|
|
|
|
|
|
|
== NAME
|
|
|
|
|
|
2010-03-20 20:50:10 -04:00
|
|
|
i3-input - interactively take a command for i3 window manager
|
2009-11-09 15:28:15 -05:00
|
|
|
|
|
|
|
|
== SYNOPSIS
|
|
|
|
|
|
2011-09-18 08:57:39 -04:00
|
|
|
i3-input [-s <socket>] [-F <format>] [-l <limit>] [-P <prompt>] [-f <font>] [-v]
|
2009-11-09 15:28:15 -05:00
|
|
|
|
|
|
|
|
== DESCRIPTION
|
|
|
|
|
|
2010-03-20 20:50:10 -04:00
|
|
|
i3-input is a tool to take commands (or parts of a command) composed by
|
2012-04-23 17:21:51 -04:00
|
|
|
the user, and send it/them to i3. This is useful, for example, for the
|
|
|
|
|
mark/goto command.
|
|
|
|
|
|
|
|
|
|
You can press Escape to close i3-input without sending any commands.
|
2009-11-09 15:28:15 -05:00
|
|
|
|
2012-04-22 10:34:20 -04:00
|
|
|
== OPTIONS
|
2011-09-18 08:57:39 -04:00
|
|
|
|
2012-04-22 10:34:20 -04:00
|
|
|
-s <socket>::
|
2012-04-23 17:21:51 -04:00
|
|
|
Specify the path to the i3 IPC socket (it should not be necessary to use this
|
|
|
|
|
option, i3-input will figure out the path on its own).
|
2009-11-09 15:28:15 -05:00
|
|
|
|
2012-04-22 10:34:20 -04:00
|
|
|
-F <format>::
|
|
|
|
|
Every occurence of "%s" in the <format> string is replaced by the user input,
|
|
|
|
|
and the result is sent to i3 as a command. Default value is "%s".
|
|
|
|
|
|
|
|
|
|
-l <limit>::
|
|
|
|
|
Set the maximum allowed length of the user input to <limit> characters.
|
2012-04-23 17:21:51 -04:00
|
|
|
i3-input will automatically issue the command when the user input reaches that
|
|
|
|
|
length.
|
2012-04-22 10:34:20 -04:00
|
|
|
|
|
|
|
|
-P <prompt>::
|
|
|
|
|
Display the <prompt> string in front of user input text field.
|
|
|
|
|
The prompt string is not included in the user input/command.
|
|
|
|
|
|
|
|
|
|
-f <font>::
|
2012-04-23 17:21:51 -04:00
|
|
|
Use the specified X11 core font (use +xfontsel+ to chose a font).
|
2012-04-22 10:34:20 -04:00
|
|
|
|
|
|
|
|
-v::
|
2012-04-23 17:21:51 -04:00
|
|
|
Show version and exit.
|
2012-04-22 10:34:20 -04:00
|
|
|
|
|
|
|
|
== EXAMPLES
|
|
|
|
|
|
|
|
|
|
Mark a container with a single character:
|
2009-11-09 15:28:15 -05:00
|
|
|
------------------------------------------------
|
2011-09-18 08:57:39 -04:00
|
|
|
i3-input -F 'mark %s' -l 1 -P 'Mark: '
|
2009-11-09 15:28:15 -05:00
|
|
|
------------------------------------------------
|
|
|
|
|
|
2012-04-22 10:34:20 -04:00
|
|
|
Go to the container marked with above example:
|
|
|
|
|
-----------------------------------------------------
|
|
|
|
|
i3-input -F '[con_mark="%s"] focus' -l 1 -P 'Go to: '
|
|
|
|
|
-----------------------------------------------------
|
|
|
|
|
|
2011-01-10 22:39:48 -05:00
|
|
|
== ENVIRONMENT
|
|
|
|
|
|
|
|
|
|
=== I3SOCK
|
|
|
|
|
|
2011-09-18 08:57:39 -04:00
|
|
|
i3-input handles the different sources of socket paths in the following order:
|
|
|
|
|
|
|
|
|
|
* I3SOCK environment variable
|
|
|
|
|
* I3SOCK gets overwritten by the -s parameter, if specified
|
|
|
|
|
* if neither are available, i3-input reads the socket path from the X11
|
|
|
|
|
property, which is the recommended way
|
|
|
|
|
* if everything fails, i3-input tries +/tmp/i3-ipc.sock+
|
|
|
|
|
|
|
|
|
|
The socket path is necessary to connect to i3 and actually issue the command.
|
2011-01-10 22:39:48 -05:00
|
|
|
|
2009-11-09 15:28:15 -05:00
|
|
|
== SEE ALSO
|
|
|
|
|
|
|
|
|
|
i3(1)
|
|
|
|
|
|
|
|
|
|
== AUTHOR
|
|
|
|
|
|
|
|
|
|
Michael Stapelberg and contributors
|
