<p align="center"> <img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&height=100&section=header" width="100%" /> </p> <h1 align="center"> 🌑 NekoDots </h1> <p align="center"> A Professional, Minimalist BSPWM Environment for Arch Linux </p> <p align="center"> <img src="https://img.shields.io/badge/License-GPLv3-000000?style=for-the-badge" /> <img src="https://img.shields.io/badge/WM-bspwm-000000?style=for-the-badge" /> <img src="https://img.shields.io/badge/Distro-Arch-000000?style=for-the-badge" /> <img src="https://img.shields.io/github/stars/NekoScripty/NekoDots?style=for-the-badge&logo=github&color=30363D&logoColor=white" /> </p>

📸 Visual Showcase

<td width="50%"> <video src="https://github.com/user-attachments/assets/46ce2bea-5d97-4f56-9183-4fa97740c244" autoplay loop muted playsinline style="width: 100%; border-radius: 8px;"> </video> </td> <div align="center"> <table border="0" cellspacing="5" cellpadding="5"> <tr> <td width="50%"><img src="Assets/1.png" alt="Clean Desktop" style="border-radius: 8px;"></td> <td width="50%"><img src="Assets/2.png" alt="Power Menu" style="border-radius: 8px;"></td> </tr> <tr> <td width="50%"><img src="Assets/3.png" alt="Rofi Launcher" style="border-radius: 8px;"></td> <td width="50%"><img src="Assets/4.png" alt="Code Environment" style="border-radius: 8px;"></td> </tr> </table> </div> <p align="center"> <strong>🌑 Obsidian Theme</strong> is my personal "Formal Black" setup designed for deep work.<br> It’s built on Arch and bspwm, focusing on a clean aesthetic without sacrificing speed.<br> Instead of the usual static X11 feel, I’ve used custom scripts and animations to make the desktop feel fluid and modern.<br> classic stability and modern Wayland-tier aesthetics. </p>

🎨 Design Philosophy

Unlike static setups, Obsidian treats the desktop as a living workspace. Every shadow, transition, and border is calculated to provide a high-density, professional experience.

Palette: Deep Obsidian (#000000) paired with Crisp Slate (#B0B3B8).
Compositor: Custom picom build featuring dual_kawase blurring and slide-in workspace transitions.
Typography: JetBrainsMono Nerd Font for surgical technical clarity.

⚙️ The Script API

This rice is driven by a suite of custom automation tools located in .config/bspwm/:

screen.sh: A robust, CLI-guided display management tool with strict validation for resolution, refresh rates, and rotation.
wall.sh: A GUI-based wallpaper engine that generates a 4x4 visual grid using Rofi for instant theme switching.
log.sh: A borderless, minimalist power menu using high-fidelity .png iconography.

⌨️ Essential Workflow

Keybindings are handled by sxhkd. The logic is grouped by "System", "Media", and "Navigation".

🔋 Modular Infrastructure

The configuration is split to support both high-end desktops and portable machines:

Desktop: (config.ini): Optimized for static network setups and multi-monitor layouts.

[!NOTE] Laptop Setup: To enable the battery module, remove config.ini and delete the word LAP from the {configLAP.ini}.

Laptop: (configLAP.ini): Features dynamic battery ramps ( to ) and backlight control modules.
Compositor: Glx-backend optimized for NVIDIA/Intel to ensure tear-free animations.

📥 Installation

1. Dependencies

Ensure you have the core toolkit installed:

git clone https://github.com/NekoScripty/NekoDots.git
&& cd NekoDots

⚙️ Then Auto Installation Script

sudo chmod +x DFPKGS.sh &&
bash DFPKGS.sh

<div align="center"> <img src="Assets/chi.png" alt="Chibi" width="200"><br> <i>~/ Stay Comfy, Stay Code /~</i> </div> <p align="center"> <img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&height=100&section=footer" width="100%" /> </p>

NekoDots

Install / Use

README