185 lines
5.2 KiB
Groff
185 lines
5.2 KiB
Groff
.TH POLYTREEWM 1 polytreewm\-VERSION
|
|
.SH NAME
|
|
PolytreeWM \- Polytree tiling window manager
|
|
.SH SYNOPSIS
|
|
.B polytreewm
|
|
.RB [ \-v ]
|
|
.SH DESCRIPTION
|
|
PolytreeWM is a tiling window manager for X. It manages windows in monocle,
|
|
floating and tiled layouts. Either layout can be applied dynamically, optimising
|
|
the environment for the application in use and the task performed.
|
|
.P
|
|
In tiled layouts windows are managed in a master and stacking area. The master
|
|
area on the left contains one window by default, and the stacking area on the
|
|
right contains all other windows. The number of master area windows can be
|
|
adjusted from zero to an arbitrary number. In monocle layout all windows are
|
|
maximised to the screen size. In floating layout windows can be resized and
|
|
moved freely. Dialog windows are always managed floating, regardless of the
|
|
layout applied.
|
|
.P
|
|
Windows are grouped by tags. Each window can be tagged with one or multiple
|
|
tags. Selecting certain tags displays all windows with these tags.
|
|
.P
|
|
Each screen contains a small status bar which displays all available tags, the
|
|
layout, the title of the focused window, and the text read from the root window
|
|
name property, if the screen is focused. A floating window is indicated with an
|
|
empty square and a maximised floating window is indicated with a filled square
|
|
before the windows title. The selected tags are indicated with a different
|
|
color. The tags of the focused window are indicated with a filled square in the
|
|
top left corner. The tags which are applied to one or more windows are
|
|
indicated with an empty square in the top left corner.
|
|
.P
|
|
PolytreeWM draws a small border around windows to indicate the focus state.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-v
|
|
prints version information to stderr, then exits.
|
|
.SH USAGE
|
|
.SS Status bar
|
|
.TP
|
|
.B X root window name
|
|
is read and displayed in the status text area. It can be set with the
|
|
.BR xsetroot (1)
|
|
command.
|
|
.TP
|
|
.B Button1
|
|
click on a tag label to display all windows with that tag, click on the layout
|
|
label toggles between tiled and floating layout.
|
|
.TP
|
|
.B Button3
|
|
click on a tag label adds/removes all windows with that tag to/from the view.
|
|
.TP
|
|
.B Mod1\-Button1
|
|
click on a tag label applies that tag to the focused window.
|
|
.TP
|
|
.B Mod1\-Button3
|
|
click on a tag label adds/removes that tag to/from the focused window.
|
|
.SS Keyboard commands
|
|
.TP
|
|
.B Mod1\-/
|
|
Spawn
|
|
.BR rofi(1)
|
|
for launching other programs.
|
|
.TP
|
|
.B Mod1\-Shift\-/
|
|
Start
|
|
.BR ptterm(1).
|
|
.TP
|
|
.B Mod1\-,
|
|
Focus previous screen, if any.
|
|
.TP
|
|
.B Mod1\-.
|
|
Focus next screen, if any.
|
|
.TP
|
|
.B Mod1\-Shift\-,
|
|
Send focused window to previous screen, if any.
|
|
.TP
|
|
.B Mod1\-Shift\-.
|
|
Send focused window to next screen, if any.
|
|
.TP
|
|
.B Mod1\-b
|
|
Toggles bar on and off.
|
|
.TP
|
|
.B Mod1\-m
|
|
Sets monocle layout.
|
|
.TP
|
|
.B Mod1\-f
|
|
Sets floating layout.
|
|
.TP
|
|
.B Mod1\-t
|
|
Sets tiled layout.
|
|
.TP
|
|
.B Mod1\-u
|
|
Sets tiled layout with centered master.
|
|
.TP
|
|
.B Mod1\-space
|
|
Toggles between current and previous layout.
|
|
.TP
|
|
.B Mod1\-j
|
|
Focus next window.
|
|
.TP
|
|
.B Mod1\-k
|
|
Focus previous window.
|
|
.TP
|
|
.B Mod1\-i
|
|
Increase number of windows in master area.
|
|
.TP
|
|
.B Mod1\-d
|
|
Decrease number of windows in master area.
|
|
.TP
|
|
.B Mod1\-Shift\-i
|
|
Reset number of windows in master area to default.
|
|
.TP
|
|
.B Mod1\-Shift\-d
|
|
Set number of windows in master area to 0.
|
|
.TP
|
|
.B Mod1\-l
|
|
Increase master area size.
|
|
.TP
|
|
.B Mod1\-h
|
|
Decrease master area size.
|
|
.TP
|
|
.B Mod1\-Return
|
|
Zooms/cycles focused window to/from master area (tiled layouts only).
|
|
.TP
|
|
.B Mod1\-Shift\-x
|
|
Close focused window.
|
|
.TP
|
|
.B Mod1\-Shift\-space
|
|
Toggle focused window between tiled and floating state.
|
|
.TP
|
|
.B Mod1\-Tab
|
|
Toggles to the previously selected tags.
|
|
.TP
|
|
.B Mod1\-Shift\-[1..n]
|
|
Apply nth tag to focused window.
|
|
.TP
|
|
.B Mod1\-Shift\-0
|
|
Apply all tags to focused window.
|
|
.TP
|
|
.B Mod1\-Control\-Shift\-[1..n]
|
|
Add/remove nth tag to/from focused window.
|
|
.TP
|
|
.B Mod1\-[1..n]
|
|
View all windows with nth tag.
|
|
.TP
|
|
.B Mod1\-0
|
|
View all windows with any tag.
|
|
.TP
|
|
.B Mod1\-Control\-[1..n]
|
|
Add/remove all windows with nth tag to/from the view.
|
|
.TP
|
|
.B Mod1\-Shift\-q
|
|
Quit PolytreeWM.
|
|
.SS Mouse commands
|
|
.TP
|
|
.B Mod1\-Button1
|
|
Move focused window while dragging. Tiled windows will be toggled to the floating state.
|
|
.TP
|
|
.B Mod1\-Button2
|
|
Toggles focused window between floating and tiled state.
|
|
.TP
|
|
.B Mod1\-Button3
|
|
Resize focused window while dragging. Tiled windows will be toggled to the floating state.
|
|
.SH CUSTOMIZATION
|
|
PolytreeWM is customized by creating a custom config.h and (re)compiling the
|
|
source code. This keeps it fast, secure and simple.
|
|
.SH SEE ALSO
|
|
.BR rofi (1),
|
|
.BR ptterm (1)
|
|
.SH ISSUES
|
|
Java applications which use the XToolkit/XAWT backend may draw grey windows
|
|
only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
|
|
JDK 1.6 versions, because it assumes a reparenting window manager. Possible workarounds
|
|
are using JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or setting the
|
|
environment variable
|
|
.BR AWT_TOOLKIT=MToolkit
|
|
(to use the older Motif backend instead) or running
|
|
.B xprop -root -f _NET_WM_NAME 32a -set _NET_WM_NAME LG3D
|
|
or
|
|
.B wmname LG3D
|
|
(to pretend that a non-reparenting window manager is running that the
|
|
XToolkit/XAWT backend can recognize) or when using OpenJDK setting the environment variable
|
|
.BR _JAVA_AWT_WM_NONREPARENTING=1 .
|
|
.SH BUGS
|
|
Send all bug reports with a patch to kotovalexarian@gmail.com.
|