i3/man/i3-input.man

50 lines
1.2 KiB
Groff
Raw Normal View History

2009-11-09 15:28:15 -05:00
i3-input(1)
=========
Michael Stapelberg <michael+i3@stapelberg.de>
2011-09-18 08:57:39 -04:00
v4.1, September 2011
2009-11-09 15:28:15 -05:00
== NAME
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
i3-input is a tool to take commands (or parts of a command) composed by
the user, and send it/them to i3. This is useful, for example, for the
mark/goto command.
2009-11-09 15:28:15 -05:00
2011-09-18 08:57:39 -04:00
The -F option takes a format string. In this string, every occurence of %s is
replaced by the user input.
2009-11-09 15:28:15 -05:00
== EXAMPLE
------------------------------------------------
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
------------------------------------------------
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