LichArch README

The project's README from github.com/AhmadHassan-BTed/LichArch. As one markdown file: README.md.

    __    ____ ______ _   _      ___    ____   ____ _   _ 
   / /   /  _// ____/| | | |    /   |  / __ \ / ____/| | | |
  / /    / / / /    / /_/ /    / /| | / /_/ // /    / /_/ / 
 / /___ / / / /___ / __  /    / ___ |/ _, _// /___ / __  /  
/_____//___/\____//_/ /_/    /_/  |_/_/ |_| \____//_/ /_/

LICH ARCH THEME & KDE PLASMA SUITE

A dark, hyper-optimized Arch Linux & KDE Plasma 6 environment by Lich.
100% Decoupled & Dynamic Architecture: Independent installer scripts for custom executable tools, OCR screen capture (Meta+Shift+T), Plasma themes & color schemes, KWin Krohnkite tiling, Konsole terminal profiles, Rofi glassmorphism launcher, application configs, system info tools, and master interactive launcher.

Arch Linux KDE Plasma 6 Wayland InputActions License: MIT

Decoupled Quick Start

Every installer script is standalone and lives in scripts/. You can execute any script directly or launch the master interactive launcher:

git clone https://github.com/AhmadHassan-BTed/LichArch.git
cd LichArch

# Option 1: Master Launcher (Interactive / CLI Flags)
./install.sh

# Option 2: Execute Standalone Module Installers Directly
./scripts/setup-touchpad.sh   # Touchpad & Mouse Gestures Only (Live YAML Parser)
./scripts/setup-bin.sh        # Custom OCR Tool & Keybinding (Meta + Shift + T)
./scripts/setup-colors.sh     # Plasma Color Schemes & Desktop Themes
./scripts/setup-kwin.sh       # KWin Compositor, Tiling & Shortcuts
./scripts/setup-konsole.sh    # Konsole Terminal Profiles
./scripts/setup-rofi.sh       # Rofi Dark Glass Launcher Theme
./scripts/setup-apps.sh       # App Configs (Dolphin, Spectacle, Kate, Darkly)
./scripts/setup-sysinfo.sh    # Fastfetch & Neofetch Configs
./scripts/setup-shell.sh      # Shell Profile (.bashrc)

Decoupled Custom Modules Summary

1. Touchpad & Mouse Gesture Engine (scripts/setup-touchpad.sh)

Config: configs/inputactions/config.yaml & configs/udev/71-touchpad.rules
Native in-compositor Wayland gestures with live Python YAML parsing. Features 3-finger workspace switching, pinch overview/grid, 4-finger track skip and continuous volume control.

2. Custom Wayland OCR Tool & Keybinding (scripts/setup-bin.sh)

Source: configs/bin/ocr-screenshot & configs/applications/net.local.ocr-screenshot.desktop
Global Shortcut: Meta + Shift + T
Installs custom Wayland OCR screenshot tool combining slurp, spectacle, tesseract, and wl-copy. Pressing Meta + Shift + T opens region selection, performs optical character recognition, and copies extracted text directly to the system clipboard with notification feedback.

3. Plasma Color Schemes & Desktop Themes (scripts/setup-colors.sh)

Source: configs/plasma/color-schemes/, desktoptheme/, look-and-feel/
Installs LichDark, MoeDark, Win11OSDark, Pastelred color schemes alongside Ant-Dark, Moe-Dark, Red-pastel, and Win11OS-dark Plasma desktop themes & look-and-feel packages.

4. KWin Window Manager & Tiling (scripts/setup-kwin.sh)

Config: configs/plasma/kwinrc, kwinrulesrc, kglobalshortcutsrc
Configures 6 virtual desktops in a 2x3 grid, Krohnkite tiling engine, Darkly window decorations, 9-level blur, and global desktop hotkeys.

5. Konsole Terminal Profiles (scripts/setup-konsole.sh)

Config: configs/konsole/
Installs Sweet.profile, LichDark.profile, WhiteOnBlack.colorscheme with 92% opacity for wallpaper bleed-through and Hack font integration.

6. Rofi Launcher Dark Glass Theme (scripts/setup-rofi.sh)

Config: configs/rofi/config.rasi
Translucent dark glass style (rgba(38,43,52,85%)), rounded borders (border-radius: 11px), and JetBrainsMono font.

7. Custom Application Settings (scripts/setup-apps.sh)

Config: configs/apps/
Deploys custom settings for Dolphin file manager (dolphinrc), Spectacle screenshot tool (spectaclerc), Kate text editor (katevirc), and Darkly window decorations (darklyrc).

8. System Info Fetch Configs (scripts/setup-sysinfo.sh)

Config: configs/neofetch/config.conf & configs/fastfetch/config.jsonc
Custom CLI hardware system info configurations.

9. Shell Profile (scripts/setup-shell.sh)

Config: configs/shell/.bashrc
Personal shell environment configuration and command aliases.

Detailed Documentation

For technical gesture tuning, volume step size tweaks, and emergency recovery hotkeys, consult the detailed reference:
Touchpad Gestures & Troubleshooting Guide

MIT License - Lich (Ahmad Hassan)

LichArch (AhmadHassan-BTed/LichArch)

linux-desktop
Searching Database…

1.7K ·GitHub
LichArch
What is this?LichArch is a dark theme suite and configuration bundle for KDE Plasma 6 on Arch Linux, bundling custom Plasma themes, a native Wayland touchpad gesture engine, an OCR screenshot tool, KWin tiling setup, Konsole/Rofi theming and more.
Is this a single theme or a full dotfiles/setup suite?It is a dotfiles-style suite of independent, standalone installer scripts, each handling one module (gestures, OCR, themes, KWin, terminal, Rofi, apps, sysinfo, shell), plus a master interactive launcher to run them all.
What's this built for — do I need Arch and KDE Plasma specifically?Yes, it targets Arch Linux running KDE Plasma 6 on Wayland, and relies on tools like slurp, spectacle, tesseract, and wl-copy for the OCR feature, plus Krohnkite for tiling.
Will this work the same on X11 or other distros?Not stated; the gesture engine and OCR tool are explicitly built as native in-compositor Wayland features, so they are unlikely to work the same way on X11 or non-Arch/non-Plasma setups.
What does the touchpad gesture feature actually do?It adds native Wayland 3-finger workspace switching, pinch-to-overview/grid, 4-finger track skip, and continuous volume control via touchpad gestures, configured through a YAML file.
How does the OCR screenshot tool work?Pressing Meta+Shift+T opens a region selection (via slurp and spectacle), runs tesseract OCR on the captured area, and copies the extracted text to the clipboard with a notification.
What themes and desktop layout does it set up?It installs color schemes and look-and-feel packages like LichDark, MoeDark, Win11OSDark, and Pastelred, plus configures KWin with 6 virtual desktops in a 2x3 grid, Krohnkite tiling, Darkly decorations, and 9-level blur.
Does it customize terminal and app looks too?Yes, it ships Konsole profiles (Sweet, LichDark, WhiteOnBlack with 92% opacity), a Rofi glassmorphism launcher theme, and custom configs for Dolphin, Spectacle, and Kate.
What are similar projects?shell, serpantinum, AgentOS, juhradial-mx, fluxcast, omarchy-pods, dots-hyprland, omarchy
Which topics is it in?kde-plasma, touchscreen, dark-theme, shell-script, gnome, desktop-environment, qml, ricing, arch-linux, linux-desktop, wayland, dotfiles
Creator
AhmadHassan-BTed
Size
7.9 MB
Stars
1.7K
Updated
CommitJul 29
Age
2mo
Commits · 90 Days