git.sur5r.net Git - i3/i3/blob - man/i3-input.man

   1 i3-input(1)
   2 =========
   3 Michael Stapelberg <michael+i3@stapelberg.de>
   4 v4.1, September 2011
   5
   6 == NAME
   7
   8 i3-input - interactively take a command for i3 window manager
   9
  10 == SYNOPSIS
  11
  12 i3-input [-s <socket>] [-F <format>] [-l <limit>] [-P <prompt>] [-f <font>] [-v]
  13
  14 == DESCRIPTION
  15
  16 i3-input is a tool to take commands (or parts of a command) composed by
  17 the user, and send it/them to i3. This is useful, for example, for the
  18 mark/goto command.
  19
  20 The -F option takes a format string. In this string, every occurence of %s is
  21 replaced by the user input.
  22
  23 == EXAMPLE
  24
  25 ------------------------------------------------
  26 i3-input -F 'mark %s' -l 1 -P 'Mark: '
  27 ------------------------------------------------
  28
  29 == ENVIRONMENT
  30
  31 === I3SOCK
  32
  33 i3-input handles the different sources of socket paths in the following order:
  34
  35 * I3SOCK environment variable
  36 * I3SOCK gets overwritten by the -s parameter, if specified
  37 * if neither are available, i3-input reads the socket path from the X11
  38   property, which is the recommended way
  39 * if everything fails, i3-input tries +/tmp/i3-ipc.sock+
  40
  41 The socket path is necessary to connect to i3 and actually issue the command.
  42
  43 == SEE ALSO
  44
  45 i3(1)
  46
  47 == AUTHOR
  48
  49 Michael Stapelberg and contributors