Nuroneko is a modular Hyprland environment for people who want a complete Arch Linux or Artix Linux desktop without manually assembling and maintaining dozens of separate configurations.
It provides a cohesive desktop workflow around Hyprland, including application launching, notifications, clipboard management, OCR utilities, screenshots, scratchpads, power management, shell tooling, and desktop integration. The project combines configuration, tooling, deployment, and workflow into a single maintainable environment instead of a collection of unrelated dotfiles.
The environment is designed around modern Wayland workflows, keyboard-driven interaction, and long-term maintainability. Configuration deployment, service integration, backups, and validation are handled automatically through the provided installer.
Important
Arch Linux and Artix Linux are currently the primary supported platforms. Future support for additional distributions may be explored as the project continues to evolve.
Why Nuroneko • What It Includes? • Preview • Installation • Documentation
Many Hyprland setups focus primarily on appearance.
While visually impressive, they often require users to manually maintain independent configurations for launchers, notifications, screenshots, clipboard utilities, shell environments, status bars, and supporting scripts.
Over time, this can result in fragmented workflows, duplicated configuration, and increasing maintenance overhead.
Nuroneko approaches the desktop differently.
Rather than treating each component as a separate system, it provides a curated environment where common workflows are already integrated and designed to work together consistently.
The goal is not only to provide a visually cohesive desktop, but also to provide a desktop that remains easy to understand, extend, and maintain over time.
Nuroneko provides a complete workflow around Hyprland, including:
- Application launching and desktop actions
- Clipboard history and clipboard utilities
- OCR and screenshot workflows
- Notification center and on-screen displays
- Scratchpad workflows
- Power profile management
- Wallpaper and appearance integration
- Terminal and shell tooling
- Development-oriented command-line utilities
- Safe configuration deployment and backup management
The project also includes an installation framework capable of:
- Detecting supported distributions
- Detecting supported init systems
- Installing required packages
- Creating configuration backups
- Deploying configurations safely
- Applying service configuration
- Validating installation results
Nuroneko currently supports:
| Distribution | Init Systems |
|---|---|
| Arch Linux | systemd |
| Artix Linux | OpenRC, runit, dinit |
Init-specific service configuration is handled automatically during installation when supported.
Nuroneko is an environment and workflow layer built around Hyprland.
It provides desktop integration, workflow tooling, shell configuration, utility integration, deployment tooling, and desktop customization.
Nuroneko does not replace the responsibilities of the Linux distribution itself, nor does it attempt to replace dedicated applications such as web browsers, development environments, office software, or media applications.
Users remain free to choose their preferred applications while benefiting from a consistent underlying desktop workflow.
|
||
|
|
|
Clone the repository:
git clone https://github.com/AikoAii/Nuroneko.git ~/.config/Nuroneko
cd ~/.config/NuronekoStandard installation:
./install.shDevelopment installation:
./install.sh --symlinkNote
Existing configurations are automatically backed up before deployment.
Backup archives are stored in:
~/.local/share/Nuroneko/backups/
Additional documentation is available for:
Quick keybinding reference can be opened from within the desktop environment:
SUPER + /
Bug reports, documentation improvements, workflow suggestions, and pull requests are welcome.
When contributing, please ensure that changes remain consistent with the project's goals of maintainability, modularity, and cross-init compatibility.
Nuroneko builds upon the work of many open-source projects and communities that make modern Linux desktops possible.
MIT License. See LICENSE for details.