---

Important

You might notice that all the code/configs are gone. This is because I'm doing a complete refactor, as well as switching to using Quickshell for the widgets. If you would like to read the old code, check here, or look through the branches.

Warning

This project is very young, and the code may be refactored without notice.

Table of Contents

• Showcase
• Install
• Issues
• Todo
• Credits
• Inspirations

---

Showcase

Photos

GTK Theming and Dashboard	Alternative Bar Location + Styling

Splash screen

Video

(Old)

showcase.mp4

---

Install

Important

This section has been MINIMALLY tested, and is likely to change. Follow AT YOUR OWN RISK!

Download and install dependancies

Debian/Ubuntu:

1. Run this command:

sudo apt install bspwm sxhkd picom rofi lxpolkit qt6-svg-dev qt6-multimedia-dev qt6-5compat-dev git stow qt6-base-dev qt6-declarative-dev qt6-shadertools-dev spirv-tools pkg-config kitty nautilus maim libqt6dbus6 ninja-build cmake libcli11-dev libjemalloc-dev libpipewire-dev pipewire qt6-base-private-dev qt6-declarative-private-dev

2. Go here and follow the instructions to install breakpad.

Fedora:

1. Run this command:

sudo dnf install bspwm sxhkd picom rofi lxpolkit qt6-qtsvg-devel qt6-qtimageformats qt6-qtmultimedia-devel qt6-qt5compat-devel git stow qt6-qtbase-devel qt6-qtdeclarative-devel qt6-qtshadertools-devel spirv-tools pkg-config kitty nautilus libxcb xprop maim dbus-qt3 ninja cmake glibc-minimal-langpack info patch cli11-devel breakpad-devel jemalloc-devel qt6-qtbase-private-devel pipewire-libs pipewire

Arch:

Don't care.

Build quickshell-git

1. Run these commands:

cd ~
git clone https://github.com/quickshell-mirror/quickshell quickshell-git
cd quickshell-git
sudo cmake -GNinja -B build -DCMAKE_BUILD_TYPE=RelWithDebInfo -DWAYLAND=OFF -DSERVICE_PAM=OFF -DHYPRLAND=OFF
sudo cmake --build build
sudo cmake --install build

Install fibreglass

Warning

Continuing from here will overwrite your dotfiles.

Dotfiles affected:

• bspwm
• matugen
• kitty
• picom
• zshrc
• oh-my-posh
• quickshell
• picom
• rofi
• sxhkd

1. Run these commands:

cd ~
git clone https://github.com/dealerofallthecats/fibreglass/
cd fibreglass
stow .
# Install bsp-layout
curl https://raw.githubusercontent.com/phenax/bsp-layout/master/install.sh | bash -;

2. Install these icon packs:

• Bibata Modern Classic (Cursor Pack)
• Crule Dark (Icon Pack)

Install other QOL features included in fibreglass

This step is completely unnessary for all/most users. This is just here to help me when I want to resetup this config.

• Install and configure kanata, a keyboard remapping program

cargo install kanata
sudo cp ~/.cargo/bin/kanata /usr/bin/kanata
sudo mkdir /etc/kanata/
sudo cp ~/fibreglass/.config/kanata/config.kbd /etc/kanata/config.kbd
sudo cp ~/fibreglass/.config/kanata/kanata.service /lib/systemd/system/kanata.service
sudo systemctl daemon-reload
sudo systemctl enable kanata
sudo systemctl start kanata

• Install and configure helix, a nvim-like editor. First, go here and download the tar.xz for your computer Then:

cd ~/Downloads
unxz ./helix-*-linux.tar.xz
tar -xf ./helix-*-linux.tar
cd ./helix-*-linux
sudo cp ./hx /usr/bin/hx
cp -r ./runtime ~/fibreglass/.config/helix/

---

Known Issues

Dashboard appears too high above or below the bar.

Key	Content
Description	This issue seems to be related to x11's positioning of PanelWindows, and changing content.
Timing	I encounter this the most while editing code, or after switch the bar location.
Workaround	Reload quickshell.

Notifications with no text, appname, or time appear with the default notification icon.

Key	Content
Description	This issue is a well known issue with quickshell's notification server. It involves these "ghost" notifications, which are notifications that haven't been properly removed by the notification server.
Timing	This happens mostly while I'm editing code, so it shouldn't effect the user
Workaround	Force quickshell to discard all the notifications by clicking on the dashboard's "Clear" button.

---

Roadmap

Done

• Create basic bar. v0.1
• Make notifications. v0.1
• Create a splash screen v0.1
• Change all icons to material icons. v0.1
• Create basic dashboard. v0.2
• Work on notifications. v0.2
• Add button on bar to open the userboard. v0.2
• Change the fallback icon for notifications without an icon. v0.2
• Add support for getting colours from the wallpaper using matugen. v0.2
• Start converting config into json v0.2
• Make matugen not trigger a reload on colour change v0.2
• Added support for a top bar v0.2
• Improved dashboard animations and design v0.3
• Basic player control added to dashboard v0.3

Still to come

• Create userboard, and tools menu.
• Add wallpapers to repository.
• Refactor/clean up the code in general.
• Make lockscreen.
• Add jgmenu/right click menu support.
• Implement desktop icons.
• Create settings menu.
• Create search menu instead of using rofi.
• Add support for different ui theme (material, ascii, etc)

---

Credits

• Failed, for critiquing my design.
• Kate, for critiquing my design.
• Eve, for being my general helpline and for also critiquing my design.
• Outfoxxed, for helping with this config and creating quickshell.
• End-4, for helping me with notifications and other code.
• Rexiel, for helping me with animations.
• Soramane, for helping with animations / notifications.

Who I stole designs from Inspirations

• Namishh, for widget design and colours.
• Saimoon, for the colourscheme.
• Failed (again), for widget design.
• Rayhan, for widget design and colours.
• Tokyob0t, for widget design.
• Soramane, for widget design and colour schemes.
• End-4, for widget design.

---

Back to top