FreeBSD Manual Pages
DWL(1) General Commands Manual DWL(1) NAME dwl -- dwm for Wayland SYNOPSIS dwl [-v] [-d] [-s startup command] DESCRIPTION dwl is a Wayland compositor based on wlroots. It is intended to fill the same space in the Wayland world that dwm does for X11. When given the -v option, dwl writes its name and version to standard error and exits unsuccessfully. When given the -d option, dwl enables full wlroots logging, including debug information. When given the -s option, dwl starts a shell process running command when starting. When stopping, it sends SIGTERM to the child process group and waits for it to exit. Users are encouraged to customize dwl by editing the sources, in particular config.h. The default key bindings are as follows: Mod-[1-9] Show only all windows with a tag. Mod-Ctrl-[1-9] Show all windows with a tag. Mod-Shift-[1-9] Move window to a single tag. Mod-Ctrl-Shift-[1-9] Toggle tag for window. Mod-p Spawn wmenu-run(1). Mod-Shift-Return Spawn foot(1). Mod-[jk] Move focus down/up the stack. Mod-[id] Increase/decrease number of windows in master area. Mod-[hl] Decrease/increase master area. Mod-Return Move window on top of stack or switch top of stack with second window. Mod-Tab Show only all windows with previous tag. Mod-Shift-c Close window. Mod-t Switch to tabbed layout. Mod-f Switch to floating layout. Mod-m Switch to monocle layout. Mod-Space Switch to previous layout. Mod-Shift-Space Toggle floating state of window. Mod-e Toggle fullscreen state of window. Mod-0 Show all windows. Mod-Shift-0 Set all tags for window. Mod-, Move focus to previous monitor. Mod-. Move focus to next monitor. Mod-Shift-, Move window to previous monitor. Mod-Shift-. Move window to next monitor. Mod-Shift-q Quit dwl. These might differ depending on your keyboard layout. Mouse commands Mod-Button1 Move focused window while dragging. Tiled win- dows will be toggled to the floating state. Mod-Button2 Toggle focused window between floating and tiled state. Mod-Button3 Resize focused window while dragging. Tiled windows will be toggled to the floating state. STATUS INFORMATION dwl writes its status information to standard output. If the -s option is given, the status information is written to the standard input of the child process instead. Said information has the following format: <monitor> <component> <data> <monitor> is the name given to the output. <component> is one of (in order) title, appid, fullscreen, floating, selmon, tags, layout. <data> changes depending on <component>. title The title of the focused window on <monitor> or nothing if there is no focused window. appid The app_id of the focused window on <monitor> or nothing if there is no focused window. fullscreen Prints 1 if the focused window on <monitor> is in fullscreen state, otherwise prints 0. If there is no focused window it prints nothing. floating Prints 1 if the focused window on <monitor> is in floating state, otherwise prints 0. If there is no focused window it prints nothing. selmon Prints 1 if <monitor> is the selected monitor, otherwise prints 0. tags Prints four bitmasks in the following order: * Occupied tags of <monitor>. * Selected tags of <monitor>. * Tags of the focused window on <monitor>. * Tags where a window on <monitor> requested ac- tivation or has urgency hints. The bitmasks are 32-bit unsigned decimal integers. layout Prints the symbol of the current layout. Examples When there is a selected window: HDMI-A-1 title ~/source/repos/dwl > man -l dwl.1 HDMI-A-1 appid footclient HDMI-A-1 fullscreen 0 HDMI-A-1 floating 0 HDMI-A-1 selmon 1 HDMI-A-1 tags 271 4 4 0 HDMI-A-1 layout [T] When there is no selected window: HDMI-A-1 title HDMI-A-1 appid HDMI-A-1 fullscreen HDMI-A-1 floating HDMI-A-1 selmon 1 HDMI-A-1 tags 271 512 0 0 HDMI-A-1 layout [T] ENVIRONMENT These environment variables are used by dwl: XDG_RUNTIME_DIR A directory where temporary user files, such as the Way- land socket, are stored. XDG_CONFIG_DIR A directory containing configuration of various programs and libraries, including libxkbcommon. DISPLAY, WAYLAND_DISPLAY, WAYLAND_SOCKET Tell how to connect to an underlying X11 or Wayland server. WLR_* Various variables specific to wlroots. XKB_*, XLOCALEDIR, XCOMPOSEFILE Various variables specific to libxkbcommon. XCURSOR_PATH List of directories to search for XCursor themes in. HOME A directory where there are always dear files there for you. Waiting for you to clean them up. These are set by dwl: WAYLAND_DISPLAY Tell how to connect to dwl. DISPLAY If using Xwayland, tell how to connect to the Xwayland server. EXAMPLES Start dwl with s6 in the background: dwl -s 's6-svscan <&-' SEE ALSO dwm(1), foot(1), wmenu(1), xkeyboard-config(7) BUGS All of them. FreeBSD ports 15.quarterly January 8, 2021 DWL(1)
NAME | SYNOPSIS | DESCRIPTION | STATUS INFORMATION | ENVIRONMENT | EXAMPLES | SEE ALSO | BUGS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dwl&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>