KDE Plasma add-on, that tiles your windows automatically and lets you manage them via keyboard, similarly to i3, Sway or dwm.
Go to file
Philipp Reichmuth ef69afe69f
docs: update README.md to include new Tumbleweed repo
OpenSUSE Tumbleweed now has Bismuth in its KDE:Extra staging repository.
2022-12-22 21:29:38 +01:00
.github ci: fix the build by updating to ubuntu 20.04 2022-08-01 20:53:30 +03:00
.reuse chore: change gikari's email 2022-03-03 19:21:00 +03:00
cmake chore: workspace wrapper template with doctest 2022-02-08 16:40:57 +03:00
contrib docs: add docs directory 2022-03-20 21:52:52 +03:00
docs docs: split vision and roadmap 2022-03-20 21:52:52 +03:00
external/doctest chore: replace husky with pre-commit 2022-02-09 22:29:09 +03:00
img docs: rearrange readmes 2022-01-08 01:01:18 +03:00
LICENSES chore: replace husky with pre-commit 2022-02-09 22:29:09 +03:00
scripts ci: fix the build by updating to ubuntu 20.04 2022-08-01 20:53:30 +03:00
src chore: remove cpp experimental backend from master 2022-09-19 11:40:37 +03:00
tests chore: remove cpp experimental backend from master 2022-09-19 11:40:37 +03:00
.editorconfig chore: remove file specific rules from the .editorconfig 2021-11-08 20:42:32 +03:00
.eslintrc.json ci: 👷 add prettier eslint plugin 2021-09-30 19:21:10 +03:00
.git-blame-ignore-revs chore: replace husky with pre-commit 2022-02-09 22:29:09 +03:00
.gitignore chore: remove vscode stuff 2022-02-09 22:29:09 +03:00
.pre-commit-config.yaml chore: add cmake-format pre-commmit hook 2022-03-20 03:04:36 +03:00
.prettierignore chore: replace husky with pre-commit 2022-02-09 22:29:09 +03:00
CHANGELOG.md chore: release 3.1.4 2022-09-23 20:04:29 +03:00
CMakeLists.txt chore: fix a typo 2022-10-20 12:11:04 +02:00
CONTRIBUTING.md chore: move npm scripts to makefile 2022-03-23 22:05:55 +03:00
LICENSE chore: 📝 add license symlink for GitHub recognition 2021-09-23 23:00:15 +03:00
Makefile chore: always build make targets 2022-07-27 16:54:12 +03:00
package.json chore: release 3.1.4 2022-09-23 20:04:29 +03:00
README.md docs: update README.md to include new Tumbleweed repo 2022-12-22 21:29:38 +01:00
tsconfig.json chore: fix documentation building 2021-12-01 16:38:58 +03:00

🌈 Bismuth 🌈

Making tiling window management easy. On KDE Plasma.

wayland: supported GitHub release (latest SemVer) Matrix Open Collective backers and sponsors

demo

Arrange your windows in different grids to minimize the mouse usage.

🌟 Features 🌟

Automatic window tiling

Save your time by automatically managing windows on your screen.

https://user-images.githubusercontent.com/14205339/148453685-f1bcfa46-4952-4b9d-a6f1-d2d75a0b4992.mp4


Plasma integration

Power-up your workflow using native Plasma features - Virtual Desktops and Activities.

https://user-images.githubusercontent.com/14205339/148562411-c9cca82a-c694-4794-b5e4-8fe716ec3d98.mp4


Multiple Layouts

Use different layouts in different contexts.

https://user-images.githubusercontent.com/14205339/148564378-1def9350-a871-4f75-ba66-7a59ea1d4680.mp4




🏁 Getting Started

Requirements

  • A Linux distribution with KDE Plasma version 5.20 or higher
  • Qt version 5.15 or higher
  • KDE Frameworks version 5.78 or higher

You can check if your system matches these requirements by going to System Settings > About this System.

Installation

⚠️ Distributions' packages are not affiliated with Bismuth developers. If you encounter any issues with the incorrect installation, you should contact the package maintainer first.

Arch Linux

Debian

Ubuntu

Fedora

Solus

OpenSUSE Tumbleweed

Gentoo

From Source

If you know a packaging solution for a distribution, that is not in the list, please open a pull request.

Usage

🎉 To start using Bismuth enable it in System Settings > Window Management > Window Tiling. Additionally, you can decorate your windows in a tiling window manager style (border-only windows) using the window decoration, that comes with Bismuth. To do so, go to System Settings > Appearance > Window Decorations and select the Bismuth decoration.

⌨️ You can view the shortcuts in System Settings > Shortcuts > Window Tiling. If you used Krohnkite before, you can import some of its shortcuts using the bash script.

🔧 If you want, you may also make a couple of manual fixes and tweaks to improve your experience with window tiling. See Tweaks section.

Configuration

You can configure Bismuth in the System Settings > Window Management > Window Tiling.

Bismuth Configuration Module

🤝 Acknowledgments

This project was made possible because of the hard work of other people on Krohnkite KWin Tiling Script.