https://github.com/zhaleff/BlackNode
// ------ Your home in the terminal. Simple, clean, yours.
https://github.com/zhaleff/BlackNode
archlinux-dotfiles btop configs dotfiles dots hyprdots hyprdots-hyprland hyprland kitty linux-dotfiles rice ricing rofi unixporn wallust waybar wlogout
Last synced: 7 days ago
JSON representation
// ------ Your home in the terminal. Simple, clean, yours.
- Host: GitHub
- URL: https://github.com/zhaleff/BlackNode
- Owner: zhaleff
- License: mit
- Created: 2025-12-10T22:55:50.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2026-06-17T06:08:06.000Z (8 days ago)
- Last Synced: 2026-06-17T08:08:04.682Z (8 days ago)
- Topics: archlinux-dotfiles, btop, configs, dotfiles, dots, hyprdots, hyprdots-hyprland, hyprland, kitty, linux-dotfiles, rice, ricing, rofi, unixporn, wallust, waybar, wlogout
- Language: Shell
- Homepage:
- Size: 65.5 MB
- Stars: 148
- Watchers: 1
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- hyprdots - zhaleff/BlackNode
README
###### _
// by zhaleff · HollowSec_
BlackNode // Your Setup
#
#
Your home in the terminal. Simple, clean, yours.
Dotfiles that embrace, not complicate.
#
BlackNode is my personal Linux configuration. It grew from years of tweaking, breaking, and slowly understanding what makes a system feel like home. It is not a monolithic rice you copy and forget. It is a living set of files, each one written to be read, understood, and eventually changed by you.
Every tool in this setup was chosen deliberately. Nothing is here just because it is popular. Each component has its own independent install script — you run only what you need, nothing runs without your input.
#
| Component | Tool | Role |
|---|---|---|
| Window Manager | Hyprland | Dynamic tiling Wayland compositor |
| Status Bar | Waybar | Fully configurable bar |
| Terminal | Kitty + Alacritty | GPU-accelerated terminal emulators |
| Shell | Zsh + Powerlevel10k | Fast shell with a powerful prompt |
| Launcher | Rofi | App launcher and dmenu replacement |
| Notifications | Dunst | Lightweight notification daemon |
| Lockscreen | Hyprlock + Hypridle | GPU-accelerated lock with idle management |
| File Manager | Yazi | Blazing-fast terminal file manager |
| Editor | Neovim | Extensible modal text editor |
| Theming | Wallust | Colour schemes generated from your wallpaper |
| Wallpaper | awww | GPU-accelerated Wayland wallpaper daemon |
| Clipboard | Clipse | Persistent clipboard history for Wayland |
| Audio | Cava | Terminal audio visualiser |
| Logout | Wlogout | Clean session management screen |
| System Info | Fastfetch | Fast, customisable fetch tool |
| AUR Helper | yay | AUR package manager |
#
BlackNode is designed for a minimal [Arch Linux](https://wiki.archlinux.org/title/Arch_Linux) install. It may work on Arch-based distros, but this has not been tested on all of them.
> [!IMPORTANT]
> Installing BlackNode alongside another DE or WM should work, but it **will** overwrite your GTK, Qt, SDDM, shell and Zsh configuration. Proceed at your own risk.
> [!NOTE]
> `blacknode.sh` is the main entry point. It presents you with options and calls individual component scripts based on your choices. Nothing is installed without your input.
Clone the repository and run the main installer:
```bash
git clone https://github.com/zhaleff/BlackNode.git $HOME/BlackNode
cd $HOME/BlackNode
bash blacknode.sh
```
> [!TIP]
> If you only want specific components, skip `blacknode.sh` entirely and jump to [Manual Install](#manual-install).
Please reboot after the installer completes for all changes to take effect.
#
Every script is fully independent. Run any of them on their own, in any order. No script depends on another.
If you do not have an AUR helper yet, start here:
```bash
bash yay.sh
```
Then run whatever you need:
```bash
# Documentation — informational only, no side effects
bash welcome.sh / introduction.sh / information.sh / changelog.sh / help.sh
# Core
bash flatpak.sh && bash bins.sh && bash update.sh
# Window Manager
bash hyprland.sh && bash hyprlock.sh && bash hyprshot.sh
# Bar & Launcher
bash waybar.sh && bash rofi.sh
# Terminal & Shell
bash kitty.sh && bash alacritty.sh && bash zsh.sh
# Tools
bash nvim.sh && bash yazi.sh && bash fastfetch.sh
bash cava.sh && bash clipse.sh && bash dunst.sh && bash wlogout.sh
# Theming
bash wallust.sh && bash wallpaper.sh && bash gtk.sh && bash awww.sh
```
For a complete breakdown of what every script installs and deploys, see [INSTALLATION.md](./INSTALLATION.md).
#
To update the entire system at once, run:
```bash
bash update.sh
```
This runs `pacman -Syu` → `yay -Syu` → `flatpak update` in sequence. Any tool that is not installed is skipped automatically.
To pull the latest BlackNode configs:
```bash
cd $HOME/BlackNode
git pull
```
> [!WARNING]
> Pulling new configs and re-running component scripts will overwrite your local configuration files. Back up anything you have modified before doing so.
#
BlackNodeHyprlockRofi
KittyNeoVimFastFetch
BtopCavaBookmarks
Control MusicHyprShotWallpaper Select
wf-recorderWlogoutBanner
#
BlackNode is maintained by [zhaleff](https://github.com/zhaleff) and supported by the **HollowSec** community — a group of people passionate about cybersecurity, programming, and building cool things together. We believe in learning by doing, sharing knowledge freely, and lifting each other up.
If you want to chat, ask questions, or just hang out with people who get it:
#
I have been where you are. I have stared at other people's dotfiles, overwhelmed by the complexity, convinced I could never create something like that. But I started small. I copied one line, then another. I broke things and fixed them. And slowly, it became mine.
You can do this. You are capable of more than you know. All it takes is the courage to start, the patience to learn from mistakes, and the belief that you belong here.
BlackNode is not the answer. It is just a starting point. The real answer is inside you.
Now go. Explore. Break things. Fix them. And make this your own.
#
BlackNode is released under the [MIT Licence](./LICENSE). You are free to use, modify, and share it however you wish. Attribution is appreciated but not required.
#
Last edited on: 2025