Repository navigation
Version 0.3.0
Release Notes
Key Features
1. Automated Setup & Dependency Management
- Interactive Setup Script:
Setup/Start_hyprland_setup.shautomates installation, configuration, and verification of all required packages (Pacman & AUR), and guides the user through system-specific steps. - Logging: All actions are logged to
~/Linux-Setup.logfor troubleshooting. - Package Verification: Ensures all required packages are installed and reports missing ones.
- Backup & Stow: Dotfiles are managed with GNU stow, with automatic backup of existing files.
2. Modular Dotfile Structure
- Config Organization: All configs are split into modular files (monitors, keybindings, autostart, environment, etc.) for easy customization and troubleshooting.
- Stow Deployment:
.local/scripts/Start_stow_solve.shdeploys dotfiles using stow.
3. Hyprland Desktop Environment
- Multi-Monitor Support: Interactive monitor configuration, per-monitor workspaces, and dynamic workspace assignment.
- Window Management: Advanced controls (edge snap, resize, floating/tiled toggle, window grouping/tabbing).
- Custom Window Rules: Easily define rules for floating, centering, opacity, and workspace assignment.
- Keybindings: Modular, user-editable keybindings for window management, media, screenshots, and more.
4. Visual & Usability Enhancements
- Waybar Status Bar: Custom modules (power, weather, updates, Dunst, etc.), system tray, workspace overview, network, volume, battery, and more. Toggle visibility with a script.
- Wofi Launcher: Themed, image-capable application launcher with custom menu and style.
- Kitty Terminal: Multiple layouts, session management, and custom key mappings.
- Fish Shell: Smart history, completions, and workflow aliases.
- Modern CLI Tools: Includes
bat,lsd,btop,fzf,fd, and more for an enhanced terminal experience. - Theming: JetBrains Mono Nerd Font, custom CSS for Waybar and Wofi, and easy appearance tweaks.
5. Wallpaper & Appearance Management
- Random Wallpaper Script:
change_wallpaper.shselects a random wallpaper (excluding the current one) and applies it to all monitors, with support for multiple formats. - Hyprpaper Integration: Ensures the wallpaper daemon is running and applies changes live.
- Night Light:
hyprsunset.shtoggles color temperature for day/night modes.
6. Notification & System Integration
- Dunst Notifications: Persistent critical notifications, action button support, and a script to ensure Dunst is running.
- Autostart Checks:
Startup_check.shverifies all essential processes (network, clipboard, notifications, etc.) are running and notifies the user of any failures. - File Manager Fixes:
fix-dolphin.shensures Dolphin file manager integration works as expected.
7. Productivity & Helper Scripts
- Music Player:
play_music.shprovides a TUI for music playback, including album art and track selection. - Notes Utility:
notes.shlaunches a note-taking session in Kitty and Neovim, with file management. - Toggle Scripts: Scripts to toggle Waybar visibility and window floating state.
8. Security & Power Management
- Screen Locking: Hyprlock with custom styling and multi-monitor support.
- Authentication: Polkit and keyring integration for secure privilege escalation and credential storage.
- Power Profiles: Waybar integration for power profile switching and battery monitoring.
9. Customization & Extensibility
- Easy Customization: All configs are modular and well-commented for user extension.
- Autostart Applications: User-defined startup programs via modular config.
- Environment Variables: Locale, language, and environment settings are modular and easily adjustable.
10. Troubleshooting & Recovery
- Comprehensive Logging: All setup and runtime actions are logged for easy troubleshooting.
- Helper Scripts: For common issues (e.g., fixing Dolphin, restarting Dunst, checking autostart status).
- Recovery Options: Guidance for configuration errors and Hyprland startup issues.
Supported Platforms
- Arch Linux and derivatives (EndeavourOS tested)
- Wayland (Hyprland compositor)
Getting Started
- Clone the repository and run the setup script to install dependencies and configure your system.
- Deploy dotfiles using the provided stow script.
- Customize configuration files as needed for your environment.
For detailed instructions, see the README.md.
Additional Resources
For issues, suggestions, or contributions, please open an issue or pull request on GitHub.