glazier

X windows manipulator.
git clone git://git.zepp.club/glazier.git
Log | Files | Refs | README | LICENSE

glazier.1 (2618B)

      1 .Dd 2020-06-07
      2 .Dt GLAZIER 1
      3 .Os POSIX.1
      4 .Sh NAME
      5 .Nm glazier
      6 .Nd X window manipulator
      7 .Sh SYNOPSIS
      8 .Nm glazier
      9 .Op Fl hv
     10 .Sh DESCRIPTION
     11 .Nm
     12 is a floating window manipulation utility for X11. Its goal is to keep
     13 track of the focused window (using sloppy focus technique) and let the
     14 user move/resize windows with the mouse pointer.
     15 .Bl -tag -width Ds
     16 .It Fl h
     17 Print a help message.
     18 .It Fl v
     19 Increase verbosity. There are two levels of logging:
     20 .Pp
     21 .Bl -enum -compact
     22 .It
     23 Print X events related to window management
     24 .It
     25 Print all received X events
     26 .El
     27 .El
     28 .Sh WINDOW MANIPULATIONS
     29 .Nm
     30 supports different 5 operations on windows, each bound to a mouse
     31 button. To trigger these operations, a modifier key (default: Mod1)
     32 must be held before pressing the appropriate mouse button.
     33 .Pp
     34 .Bl -enum -compact
     35 .It
     36 .Em Move .
     37 The window will be moved to the specified location once left
     38 button is released.
     39 .It
     40 .Em Resize .
     41 The window will be resized to the area between the top-left corner and
     42 the pointer.
     43 .It
     44 .Em Teleport .
     45 The window will be teleported in the area drawn with the middle button held.
     46 .It
     47 .Em Inflate .
     48 Grow the window size in all 4 directions by
     49 .Em move_step
     50 pixels when scrolling up.
     51 .It
     52 .Em Deflate .
     53 Shrink the window size in all 4 directions by
     54 .Em move_step
     55 pixels when scrolling down.
     56 .El
     57 .Pp
     58 .Sy Note :
     59 The numbers correspond to the mouse button being pressed. Only one
     60 operation at a time is supported. The
     61 .Em move_step
     62 factor is specified at compilation time in
     63 .Pa config.h .
     64 .Sh IMPLEMENTATION NOTES
     65 .Ss Extended Window Manager Hints
     66 .Nm
     67 does not comply with the EWMH specification. The specification exist
     68 for applications to instruct a window manager how it should behave. I
     69 believe that the user should be left with the responsibility of managing
     70 applications, and not the other way around.
     71 .Pp
     72 If you need (partial) compliance with these specification, consider using
     73 .Xr ewmh 1 .
     74 .Ss Keyboard
     75 Manipulating windows with the keyboard is both efficient, and
     76 fast. However,
     77 .Nm
     78 cannot do that.
     79 Implementing that within a window manager is often too rigid, and doesn't
     80 provide enough flexibility to the user. For this reason, I think it is
     81 more valuable to use external tools like 
     82 .Xr wmutils 1
     83 for this.
     84 .Ss Configuration files
     85 There is not configuration files in
     86 .Nm .
     87 The software is configured at compilation time, by tweaking the
     88 .Pa config.h
     89 file. Refer to this file for precisions on what can be configured.
     90 .Sh ENVIRONMENT
     91 .Bl -tag -width "DISPLAY"
     92 .It Ev DISPLAY
     93 .Nm
     94 starts on this display.
     95 .El
     96 .Sh SEE ALSO
     97 .Xr ewmh 1 ,
     98 .Xr wmutils 1
     99 .Sh AUTHORS
    100 .An Willy Goiffon Aq Mt dev@z3bra.org