Utilities and scripts
Screenshots: swappy
- Author: Jeremy Attali
- License: MIT
Swappy is a Wayland native snapshot and editor tool, inspired by Snappy on macOS. We use it to make partial screenshots, but it is worth reading the README to find out about other possible applications.
Button bar: nwg-bar
- Authors: Piotr Miller & Contributors
- License: MIT
The nwg-bar command creates a button bar on the basis of a JSON template placed in the ~/.config/nwg-bar
folder. By default the command displays a horizontal bar in the center of the screen. Nwg-shell uses the bar to display the exit menu, but you may find other uses for it, too.
Clipboard manager: nwg-clipman
- Author: Piotr Miller
- License: MIT
Nwg-clipman is a GTK3-based GUI for Senan Kelly’s cliphist. It provides access and management of the clipboard history from an easy to use GTK window.
Icon picker: nwg-icon-picker
- Author: Piotr Miller
- License: MIT
Nwg-icon-picker is a tool to search GTK icons by name. Utilized by nwg-panel settings, may also be used system-wide.
Workflow: autotiling
- Authors: Piotr Miller & Contributors
- License: GPL v3
- Original idea: Ole Martin Handeland
Sway is a great window manager, but changing layouts manually can be tiring for some users (including me). This script uses the i3ipc-python library to automagically switch the layout splith/splitv, depending on the currently focused window dimensions.
Since v0.2.5 nwg-shell does not use the autotiling
package, but its own nwg-autotiling
script, that’s better adjusted to use here.
Important note: turning autotiling on will spoil some default sway behaviour:
- moving windows with key bindings/swaymsg commands will need you to change the window focus first; dragging windows with Alt+mouse pointer should work well, however;
- stacking and tabbed layouts will behave oddly. If you’re attached to them, turn autotiling off, or set the
Depth limit
. Both layouts will work normally back again below the depth limit. - Split width/hight settings (since nwg-shell-config 0.4.8) allow to achive uneven 1st window split. You may use them e.g. on vertical outputs, or, together with
depth limit = 2
, to achive the windows behaviour similar to Master/stack DWL layout (depth_limit = 2
,splith_width = 0.9
). Both settings are experimental, and may cause some not yet known and unexpected behaviour. Use at you own risk, or set to 1.0 to turn them off.
Fake master/stack layout on HDMI-A-1
System info: gopsuinfo
- Authors: Piotr Miller & Contributors
- License: BSD 2-Clause
This CLI command, based on the gopsutil Go module, produces text output to display system usage info in nwg-panel executors.