https://github.com/zeroxoneafour/polonium

Autotile manager for Plasma 6
https://github.com/zeroxoneafour/polonium

kde kwin kwin-script tiling tiling-scripts tiling-window-manager typescript

Last synced: about 2 months ago
JSON representation

Autotile manager for Plasma 6

• Host: GitHub
• URL: https://github.com/zeroxoneafour/polonium
• Owner: zeroxoneafour
• License: mit
• Created: 2023-05-19T19:39:58.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2024-08-18T06:24:17.000Z (over 1 year ago)
• Last Synced: 2025-08-05T08:18:59.769Z (8 months ago)
• Topics: kde, kwin, kwin-script, tiling, tiling-scripts, tiling-window-manager, typescript
• Language: TypeScript
• Homepage: https://zeroxoneafour.github.io/polonium/
• Size: 1.43 MB
• Stars: 1,032
• Watchers: 12
• Forks: 19
• Open Issues: 46
• Metadata Files:
  • Readme: readme.md
  • Changelog: changelog.md
  • Contributing: contributing.md
  • Funding: .github/FUNDING.yml
  • License: license.txt

Awesome Lists containing this project

• awesome-kde - kwin-polonium - a tiling window manager for Plasma 6 (Uncategorized / Uncategorized)

README

          


# polonium

An autotile manager for Plasma 6.

An (unofficial) spiritual successor to [Bismuth](https://github.com/Bismuth-Forge/bismuth) built on KWin 6.

The descendant of [autotile](https://github.com/zeroxoneafour/kwin-autotile).

![hot icon](https://raw.githubusercontent.com/zeroxoneafour/polonium/master/docs/logo.svg)

[![KDE Store](https://img.shields.io/badge/KDE%20Store-Install-blue?style=for-the-badge&logo=KDE&logoColor=white&labelColor=blue)](https://store.kde.org/p/2140417)

[![GitHub](https://img.shields.io/badge/GitHub-Source%20Code-grey?style=for-the-badge&logo=GitHub&logoColor=white&labelColor=grey)](https://github.com/zeroxoneafour/polonium)

[![wayland: supported](https://img.shields.io/badge/Wayland-Ready-blue?logo=kde)](https://community.kde.org/KWin/Wayland)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)



## features

-   Works in Wayland Plasma 6.0.4 and up

-   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, activity, and screen

-   [DBus integration](https://github.com/zeroxoneafour/dbus-saver) to save layouts and configurations after logging out

## X11

X11 has been briefly tested but 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

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`

## license

Majority of this project is [MIT licensed](https://github.com/zeroxoneafour/polonium/blob/master/license.txt), please bum my code if you can use to make something better. Make sure to give credit though!

## name

Came from a comment on my old script, you can find the script and comment [here](https://store.kde.org/p/2003956)