Bismuth-Forge / bismuth

KDE Plasma add-on, that tiles your windows automatically and lets you manage them via keyboard, similarly to i3, Sway or dwm.
https://bismuth-forge.github.io/bismuth/
Other
2.4k stars 93 forks source link
desktop kcm kde kde-plasma kwin kwin-script linux plasma tiling tiling-window-manager wayland window window-manager
# 🌈 Bismuth 🌈 #### Making tiling window management easy. On KDE Plasma. [![wayland: supported](https://img.shields.io/badge/Wayland-Ready-blue?style=for-the-badge&logo=kde)](https://community.kde.org/KWin/Wayland) [![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/Bismuth-Forge/bismuth?color=red&logo=github&style=for-the-badge)](https://github.com/Bismuth-Forge/bismuth/releases/latest) [![Matrix](https://img.shields.io/matrix/bi:kde.org?label=Chat&server_fqdn=kde.modular.im&logo=matrix&style=for-the-badge)](https://matrix.to/#/#bi:kde.org) [![Open Collective backers and sponsors](https://img.shields.io/opencollective/all/bismuth?label=Donators&logo=opencollective&style=for-the-badge)](https://opencollective.com/bismuth) ![demo](img/rice.png) 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

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

Installation

:warning: 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.