{"id":15108749,"url":"https://github.com/bismuth-forge/bismuth","last_synced_at":"2025-09-27T08:31:05.182Z","repository":{"id":37017279,"uuid":"400733318","full_name":"Bismuth-Forge/bismuth","owner":"Bismuth-Forge","description":"KDE Plasma add-on, that tiles your windows automatically and lets you manage them via keyboard, similarly to i3, Sway or dwm.","archived":true,"fork":false,"pushed_at":"2024-05-23T03:32:57.000Z","size":11187,"stargazers_count":2402,"open_issues_count":158,"forks_count":93,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-01-10T13:18:47.040Z","etag":null,"topics":["desktop","kcm","kde","kde-plasma","kwin","kwin-script","linux","plasma","tiling","tiling-window-manager","wayland","window","window-manager"],"latest_commit_sha":null,"homepage":"https://bismuth-forge.github.io/bismuth/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bismuth-Forge.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"bismuth"}},"created_at":"2021-08-28T07:42:31.000Z","updated_at":"2025-01-06T01:57:16.000Z","dependencies_parsed_at":"2024-01-02T22:42:33.348Z","dependency_job_id":"0d7deafb-f0c0-4ab1-aa50-8960da7ea765","html_url":"https://github.com/Bismuth-Forge/bismuth","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bismuth-Forge%2Fbismuth","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bismuth-Forge%2Fbismuth/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bismuth-Forge%2Fbismuth/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bismuth-Forge%2Fbismuth/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bismuth-Forge","download_url":"https://codeload.github.com/Bismuth-Forge/bismuth/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234410736,"owners_count":18828280,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["desktop","kcm","kde","kde-plasma","kwin","kwin-script","linux","plasma","tiling","tiling-window-manager","wayland","window","window-manager"],"created_at":"2024-09-25T22:24:27.323Z","updated_at":"2025-09-27T08:31:02.994Z","avatar_url":"https://github.com/Bismuth-Forge.png","language":"TypeScript","readme":"\u003c!--\n  SPDX-FileCopyrightText: 2021-2022 Mikhail Zolotukhin \u003cmail@gikari.com\u003e\n  SPDX-FileCopyrightText: 2018-2019 Eon S. Jeon \u003cesjeon@hyunmu.am\u003e\n  SPDX-License-Identifier: MIT\n--\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n# 🌈 Bismuth 🌈\n\n#### Making tiling window management easy. On KDE Plasma.\n\n[![wayland: supported](https://img.shields.io/badge/Wayland-Ready-blue?style=for-the-badge\u0026logo=kde)](https://community.kde.org/KWin/Wayland)\n[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/Bismuth-Forge/bismuth?color=red\u0026logo=github\u0026style=for-the-badge)](https://github.com/Bismuth-Forge/bismuth/releases/latest)\n[![Matrix](https://img.shields.io/matrix/bi:kde.org?label=Chat\u0026server_fqdn=kde.modular.im\u0026logo=matrix\u0026style=for-the-badge)](https://matrix.to/#/#bi:kde.org)\n[![Open Collective backers and sponsors](https://img.shields.io/opencollective/all/bismuth?label=Donators\u0026logo=opencollective\u0026style=for-the-badge)](https://opencollective.com/bismuth)\n\n![demo](img/rice.png)\n\nArrange your windows in different grids to minimize the mouse usage.\n\n## 🌟 Features 🌟\n\n### Automatic window tiling\n\nSave your time by automatically managing windows on your screen.\n\nhttps://user-images.githubusercontent.com/14205339/148453685-f1bcfa46-4952-4b9d-a6f1-d2d75a0b4992.mp4\n\n\u003cbr\u003e\n\n### Plasma integration\n\nPower-up your workflow using native Plasma features - Virtual Desktops and\nActivities.\n\nhttps://user-images.githubusercontent.com/14205339/148562411-c9cca82a-c694-4794-b5e4-8fe716ec3d98.mp4\n\n\u003cbr\u003e\n\n### Multiple Layouts\n\nUse different layouts in different contexts.\n\nhttps://user-images.githubusercontent.com/14205339/148564378-1def9350-a871-4f75-ba66-7a59ea1d4680.mp4\n\n\u003c/div\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\n## 🏁 Getting Started\n\n### Requirements\n\n- A Linux distribution with KDE Plasma version 5.20 or higher\n- Qt version 5.15 or higher\n- KDE Frameworks version 5.78 or higher\n\nYou can check if your system matches these requirements by going to System\nSettings \u003e About this System.\n\n### Installation\n\n:warning: Distributions' packages are not affiliated with Bismuth developers.\nIf you encounter any issues with the incorrect installation, you should\ncontact the package maintainer first.\n\n#### Arch Linux\n\n- [AUR](https://aur.archlinux.org/packages/kwin-bismuth)\n\n#### Debian\n\n- [Volian Repository](https://volian.org/bismuth/)\n\n#### Ubuntu\n\n- [Official Repo](https://launchpad.net/ubuntu/+source/bismuth):\n\n  ```bash\n  sudo apt install kwin-bismuth\n  ```\n\n- [Volian Repository](https://volian.org/bismuth/)\n\n#### Fedora\n\n- [Official Repo](https://src.fedoraproject.org/rpms/bismuth):\n\n  ```bash\n  sudo dnf install bismuth\n  ```\n  \n#### Solus\n\n- [Official Repo](https://dev.getsol.us/source/bismuth)\n\n  ```bash\n  sudo eopkg install bismuth\n  ```\n\n#### OpenSUSE Tumbleweed\n\n- [KDE Extra Repository](https://build.opensuse.org/package/show/KDE:Extra/bismuth)\n\n#### Gentoo\n\n- [VipreML Overlay](https://github.com/viperML/viperML-overlay/)\n\n#### From Source\n\n- [See Dev Docs](CONTRIBUTING.md)\n\nIf you know a packaging solution for a distribution, that is not in the\nlist, please open a pull request.\n\n### Usage\n\n🎉 To start using Bismuth enable it in System Settings \u003e Window Management \u003e\nWindow Tiling. Additionally, you can decorate your windows in a tiling window\nmanager style (border-only windows) using the window decoration, that comes\nwith Bismuth. To do so, go to System Settings \u003e Appearance \u003e Window Decorations\nand select the Bismuth decoration.\n\n⌨️ You can view the shortcuts in System Settings \u003e Shortcuts \u003e Window Tiling. If\nyou used Krohnkite before, you can import some of its shortcuts using [the bash\nscript](contrib/import_krohnkite.sh).\n\n🔧 If you want, you may also make a couple of manual fixes and tweaks to\nimprove your experience with window tiling. See [Tweaks\nsection](docs/TWEAKS.md).\n\n### Configuration\n\nYou can configure Bismuth in the System Settings \u003e Window Management \u003e Window Tiling.\n\n![Bismuth Configuration Module](img/config.png)\n\n## 🤝 Acknowledgments\n\nThis project was made possible because of the hard work of other people on [Krohnkite\nKWin Tiling Script](https://github.com/esjeon/krohnkite).\n","funding_links":["https://opencollective.com/bismuth"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbismuth-forge%2Fbismuth","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbismuth-forge%2Fbismuth","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbismuth-forge%2Fbismuth/lists"}