Kith

A fully customizable desktop calendar widget for Linux. Written in C++ with Qt Widgets.

---

Installation

Note

Before installing the widget, please choose one of the available installation methods, which are listed below:

• Quick automated installation
• Build manually

Dependencies

• build-essential
• cmake
• qt6-base-dev
• qt6-base-dev-tools
• ninja-build (Optional)

Quick Install Script

# Interactive installation
./install.sh

# Non-interactive installation
./install.sh -y

Build from Source

git clone https://github.com/JacobEscoto/kith.git
cd kith

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build

# Optional: Install system-wide to /usr/local/bin
sudo cmake --install build

NOTE: If you don't have ninja installed, remove -G Ninja.

Run Kith

# Run it manually using the build-generated binary
./build/kith

# If already installed, run:
kith &

Customization

Kith is fully customizable using QSS. Edit ~/.config/kith/style.qss and launch again to see the changes.

Available selectors

Selector	Description
#container	General panel background and rounded borders
#monthYearLabel	"Year Month" top label
#divider	Divisory line between panels
#bottomPanel	Day cells container
QLabel[header="true"]	Headers of Mo, Tu, We, Th, Fr, Sa, Su
QLabel#dayCell	Date cells (1-28/29/30/31)
QLabel#dayCell[today="true"]	Current day cell (accent color)

License

Distributed under the MIT License.