awesome-client.1.txt

   1 awesome-client(1)
   2 =================
   3
   4 NAME
   5 ----
   6
   7 awesome-client - awesome window manager command line interface
   8
   9 SYNOPSIS
  10 --------
  11
  12 awesome-client
  13
  14 DESCRIPTION
  15 -----------
  16
  17 awesome-client is the command line interface to awesome. It communicates with awesome
  18 via a socket located in the users's HOME directory.
  19
  20 USAGE
  21 -----
  22 To determine which socket is to be used, it reads the DISPLAY environment variable.
  23 awesome-client reads commands from standard input.
  24
  25 When you pipe multiple lines into awesome-client, an empty line will flush already
  26 collected lines into awesome with an according immediate execution.
  27
  28 The command format is:
  29  screen_number command argument
  30
  31 For example, to change a statusbar textbox text on screen 0, you can do the following:
  32
  33     echo 0 widget_tell <statusbar-name> <textbox-name> text Hello, world | awesome-client
  34
  35 To change an iconbox image on screen 1, you can do the following:
  36
  37     echo 0 widget_tell <statusbar-name> <iconbox-name> image /home/user/image.jpg | awesome-client
  38
  39 To view tag number 3 on screen 1:
  40
  41     echo 1 tag_view 3 | awesome-client
  42
  43 To zoom focused window on screen 0:
  44
  45     echo 0 client_zoom | awesome-client
  46
  47
  48 SEE ALSO
  49 --------
  50 awesome(1) awesomerc(5)
  51
  52 AUTHORS
  53 -------
  54 Julien Danjou <julien@danjou.info>
  55
  56 WWW
  57 ---
  58 http://awesome.naquadah.org