Skip to content

zeroxoneafour/polonium

Repository files navigation

polonium

An autotile manager for Plasma 6.

An (unofficial) spiritual successor to Bismuth built on KWin 6.

The descendant of autotile.

hot icon

KDE Store GitHub

wayland: supported PRs Welcome

features

  • Works in Wayland Plasma 6.4 and up (6.7 recommended)
  • Custom moddable tiling engine backend
  • Edit tile sizes with the integrated KWin GUI
  • Move and tile windows with your mouse and keyboard
  • Set layouts independently of desktop and screen
  • DBus integration to save layouts and configurations after logging out

x11

X11 is not supported. If you encounter an issue running the script on X11, make sure it is reproducible in Wayland before submitting a bug report.

building/installing

Requires npm and kpackagetool6

Commands -

  • Build/Install/Clean - make
  • Build - make build
  • Install/Reinstall - make install
  • Clean build - make clean
  • Clean build and target - make cleanall
  • Build and install DBus service - make dbus

getting logs

To get logs, do the following -

  • Set log level to "Log" in settings
  • Log out and log in again, and immediately reproduce the issue if possible after logging in
  • Run the below command. An explanation is provided if you are wary about running it. It only works if all of the required executables are installed.
  • journalctl --since="$(journalctl -g "Polonium LOG: controller initialized" -n 1 --output=short-iso | cut -d ' ' -f1)" -g "[Pp]olonium" | wl-copy
    1. Gets the timestamp of the first controller message
    2. Gets the journalctl log since that message
    3. Greps for Polonium-related output
    4. Copies the output into your clipboard
  • If you don't have wl-copy, remove that part from the end of the command and run it, and manually copy the output

Depending on the issue, more precise logs may be needed. For these logs, set log level to "Debug" instead.

license

Majority of this project is MIT licensed

name

Came from a comment on my old script, you can find the script and comment here

About

Autotile manager for Plasma 6

Topics

Resources

License

Contributing

Stars

1.1k stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors