opensource/beekeeper-studio
1
0
Fork 0
mirror of https://github.com/beekeeper-studio/beekeeper-studio.git synced 2026-03-13 10:12:54 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #3873 from beekeeper-studio/docs/wayland-color-management

Browse Source 
Add docs for Wayland color management bug workaround
This commit is contained in:
Day Matchullis
2026-02-12 13:07:25 -07:00
committed by GitHub
parent b218047a8c 5dea47a314
commit a92725c859
2 changed files with 26 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/installation/linux.md
View File

@@ -140,3 +140,15 @@ touch ~/.config/bks-flags.conf
echo "--ozone-platform-hint=auto" >> ~/.config/bks-flags.conf
echo "--enable-features=UseOzonePlatform" >> ~/.config/bks-flags.conf
```
### Fixing weird colors on Wayland
If you experience incorrect colors when using Wayland (e.g. oranges appearing yellow, greys looking almost black, overly bright whites, or poor text readability), this is caused by a [Chromium/Electron bug with the Wayland color management protocol](https://github.com/electron/electron/issues/49566).
To fix this, add the following flag to your `~/.config/bks-flags.conf` file:
```bash
echo "--disable-features=WaylandWpColorManagerV1" >> ~/.config/bks-flags.conf
```
Then restart Beekeeper Studio for the change to take effect.

14
docs/support/troubleshooting.md
View File

@@ -157,6 +157,20 @@ CREATE table foo("myColumn" int);
See [this StackOverflow answer](https://stackoverflow.com/a/20880247/18818) or [this section in the PostgreSQL manual](https://www.postgresql.org/docs/current/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS)
## Linux (Wayland)
### Weird colors on Wayland (wrong saturation, contrast, or readability)
If colors look wrong when running Beekeeper Studio on Wayland — for example oranges appearing yellow, greys looking almost black, whites being overly bright, or text being hard to read — this is caused by a [Chromium/Electron bug with the Wayland color management protocol](https://github.com/electron/electron/issues/49566).
To fix this, add the following flag to your `~/.config/bks-flags.conf` file:
```bash
echo "--disable-features=WaylandWpColorManagerV1" >> ~/.config/bks-flags.conf
```
Then restart Beekeeper Studio. See [Linux Installation - Wayland support](../installation/linux.md#wayland-support-including-fractional-scaling) for more details on configuring Wayland flags.
## Linux (Snap)
### The Filepicker shows 'little rectangles' instead of a font