A minimalist, high-performance workstation configuration featuring Hyprland, Waybar, Zsh, Kitty, and automated provisioning.
- Overview
- Repository Structure
- Modules & Configuration
- Installation & Setup
- Keybindings Reference
- Author & Connect
- License
This repository maintains a streamlined, production-grade Arch Linux development setup. It focuses on clean typography, keyboard-driven navigation, low latency, and deterministic system provisioning.
- Automated Workstation Setup: End-to-end bootstrapping script (
autosetup.sh) for Arch Linux, Ubuntu, and Debian. - Integrated Hotspot Manager: Standalone Rofi UI and NetworkManager automation with hardened WPA2-AES security, Protected Management Frames (802.11w), client tracking, and Waybar integration.
- Productive Shell Architecture: Optimized Zsh setup with autosuggestions, syntax highlighting, customized dircolors, and minimal git status prompt.
- Modern CLI Stack: Curated configuration for
bat,fzf,zoxide,fastfetch, and AI-assisted terminal workflows.
dotfiles/
├── autosetup.sh # Cross-distro automated installation script
├── chat.py # Interactive CLI ChatGPT assistant with streaming
├── configs/
│ ├── fastfetch/ # Fastfetch system info configurations (full & compact)
│ ├── kitty/ # GPU-accelerated Kitty terminal config & color themes
│ └── zsh/ # Base Zsh configuration files
├── hotspot/ # Complete Wi-Fi Hotspot management suite
│ ├── hotspot.py # Core NetworkManager, firewall & SQLite backend
│ ├── hotspot.rasi # Matte translucent Rofi popup theme
│ ├── install.py # Auto-installer for Hyprland/Waybar integration
│ └── README.md # Hotspot module documentation
├── mirrorlist # Curated, high-speed Arch Linux pacman mirrorlist
├── zsh/
│ └── .zshrc # Production Zsh configuration with custom prompt & hooks
├── LICENSE # MIT License
└── README.md # Repository documentation
An interactive hotspot controller designed for Waybar and Hyprland desktops:
- Hardened Wireless Security: Uses WPA2-AES (CCMP) with PMF (802.11w) and a fixed 2.4 GHz channel to prevent iOS "Weak Security" warnings and ensure instant discovery across Apple and Android devices.
- Keyboard-Driven Menu (
Super + F): Clean Rofi interface to start, stop, view credentials, and monitor connected devices. - Waybar Integration: Live status icon with single-click toggle and menu actions.
- Session & Device Auditing: SQLite database logging client connections, live bandwidth usage, and firewall-level device blocking.
- Security-First: Passwords remain managed by NetworkManager and are never stored in version control.
Engineered for instant shell load times and fluid command execution:
- Minimal Latency: Pure Zsh configuration without sluggish framework overhead.
- Dircolors Tuning: Eliminates jarring background highlight boxes on world-writable directories.
- Dynamic Git Status: Real-time git branch indicator showing staged, modified, and untracked file states.
- Smart Completion & History: Case-insensitive autocompletions and substring history search using arrow keys.
- Developer Aliases: Standardized shortcuts for Git workflows, package management (
update), and file viewing (bat).
- GPU Acceleration: High-frame-rate rendering, smooth cursor trail, and truecolor support.
- Visual Polish: 90% background opacity, clean padding, and
FantasqueSansM Nerd Font Monotypography. - Fastfetch Layouts: Modular configurations offering both full hardware diagnostics and compact shell banners.
An idempotent shell script that provisions a complete development workstation:
- Multi-Distro Engine: Autodetects Arch Linux, Ubuntu, and Debian.
- Toolchain Installation: Installs Rust/Cargo, base development toolchains, and AUR helpers (
paru,yay). - Development Tooling: Provisions
neovim,zsh,bat,fzf,zoxide,fastfetch, and modern CLI utilities. - Desktop Environments: Installs VS Code, Brave, Google Chrome, Spotify, and required Nerd Fonts.
A lightweight Python CLI client for OpenAI models:
- Interactive, context-aware command line chat.
- Reads API key directly from the
OPENAI_KEYenvironment variable.
git clone https://github.com/ravindran-dev/dotfiles.git ~/dotfiles
cd ~/dotfileschmod +x autosetup.sh
./autosetup.shcd ~/dotfiles/hotspot
sudo pacman -S --needed networkmanager dnsmasq rofi python libnotify
python3 install.py
hyprctl reload
pkill -SIGUSR2 -x waybar# Backup existing configuration
[ -f ~/.zshrc ] && mv ~/.zshrc ~/.zshrc.bak
# Deploy dotfiles configuration
cp ~/dotfiles/zsh/.zshrc ~/.zshrc
source ~/.zshrc| Shortcut | Context | Action |
|---|---|---|
Super + F |
Hyprland | Open Hotspot Settings Menu / Close Dialog |
Right Click |
Waybar Hotspot | Toggle Hotspot ON / OFF |
Left Click |
Waybar Hotspot | Open Hotspot GUI Menu |
Alt + S |
Hotspot Password Dialog | Toggle Password Visibility |
Ctrl + R |
Zsh Terminal | Fuzzy Command History Search (fzf) |
Up / Down |
Zsh Terminal | History Prefix Search |
Ravindran S
Software Development Engineer • Systems & Full-Stack Developer
This repository is licensed under the MIT License.