Skip to content
This repository has been archived by the owner on Jun 16, 2024. It is now read-only.

Commit

Permalink
docs: briefly describe the new window decoration feature
Browse files Browse the repository at this point in the history
  • Loading branch information
gikari committed Mar 20, 2022
1 parent 517281e commit b333cda
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 46 deletions.
5 changes: 4 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,10 @@ list, please open a pull request.
### Usage

🎉 To start using Bismuth enable it in System Settings > Window Management >
Window Tiling.
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
Expand Down
48 changes: 3 additions & 45 deletions contrib/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,53 +20,11 @@ the full potential of the script.

Note: `Separate Screen Focus` appears only when multiple monitors are present.

## Removing Title Bars

Breeze window decoration can be configured to completely remove title bars from
all windows:

1. `System Setting` > `Application Style` > `Window Decorations`
2. Click `Configure Breeze` inside the decoration preview.
3. `Window-Specific Overrides` tab > `Add` button
4. Enter the followings, and press `Ok`:
- `Regular expression to match`: `.*`
- Tick `Hide window title bar`

## Changing Border Colors

Changing the border color makes it easier to identify current window. This is
convenient if title bars are removed.

1. Open `~/.config/kdeglobals` with your favorite editor
2. Scroll down and find `[WM]` section
3. Append the followings to the section:

- `frame=61,174,233`: set the border color of active window to _RGB(61,174,233)_
- `inactiveFrame=239,240,241`: set the border color of inactive window to _RGB(239,240,241)_

Here's a nice 2-liner that'll do it for you:

kwriteconfig5 --file ~/.config/kdeglobals --group WM --key frame 61,174,233
kwriteconfig5 --file ~/.config/kdeglobals --group WM --key inactiveFrame 239,240,241

4. Create a new color scheme in `System Settings` > `Appearance` > `Colors`.
5. Open the color scheme file in
`~/.local/share/color-schemes/<color-sheme-name>.colorscheme` and remove
all the `[XXX:Header]` groups, then save the file and exit.
6. Select the edited color scheme in `System Settings`
7. You must **restart** your session to see changes. (i.e. re-login, reboot)

Note: the RGB values presented here are for the default Breeze theme

Note: You might also need to set the border size larger than the theme's
default: `System Settings` > `Application Style` > `Window Decorations`: Uncheck
`Use theme's default window border size` and adjust the size (right from the
checkbox).

## Setting Minimum Geometry Size

Some applications like discord and KDE settings don't tile nicely as they have a minimum size requirement.
This causes the applications to overlap with other applications. To mitigate this we can set minimum size for all windows to be 0.
Some applications like discord and KDE settings don't tile nicely as they have
a minimum size requirement. This causes the applications to overlap with other
applications. To mitigate this we can set minimum size for all windows to be 0.

1. `System Setting` > `Window Management` > `Window Rules`
2. Click on `+ Add New...`
Expand Down

0 comments on commit b333cda

Please sign in to comment.