Skip to content

zhaleff/BlackNode

Repository files navigation

BlackNode

stars   forks   issues   last commit   license   discord

Your home in the terminal. Simple, clean, yours.

Dotfiles that embrace, not complicate.


Hello.

This is my configuration favourite for Linux. BlackNode is a collection of dotfiles that grew from years of tweaking, breaking, and slowly understanding what makes a system feel like home. It is not a monolithic “rice” that you copy and forget. It is a living set of files, each one written to be read, understood, and eventually changed by you.

My first dotfiles were horrible. I mean it. They were messy, inconsistent, and half of them did not even work. But I kept at it, and over time they became something I was proud to share. BlackNode is that pride, packaged up and offered to you with a single wish: that you take it, make it your own, and in doing so discover that you are capable of so much more than you think.


What is Inside?

At its heart, BlackNode brings together a set of powerful tools that work in harmony:

  • ZSH with a curated set of plugins: autosuggestions, syntax highlighting, fzf‑tab, history substring search, and more. Aliases that actually save time.
  • Hyprland – a dynamic tiling Wayland compositor that is fast, beautiful, and endlessly configurable.
  • Waybar – a modern status bar with multiple styles (Classic, Minimal, and a work‑in‑progress Hacking style).
  • Kitty – a GPU‑accelerated terminal emulator, configured for clarity and performance.
  • Rofi – an application launcher that doubles as a window switcher and dmenu replacement.
  • dunst – a lightweight notification daemon with a clean look.
  • clipse – a clipboard manager that stays out of your way.
  • fastfetch – system information at a glance.
  • yazi – a fast terminal file manager.
  • And many others: cava, nvim, sddm, wlogout, and more.

Each configuration is thoroughly commented, so you can understand what every line does. No magic. No mystery.


Documentation

Beyond this README, each major aspect of BlackNode has its own detailed document. Use the buttons at the top to jump to them, or explore the files directly:

  • Installation – step‑by‑step guide to get BlackNode running.
  • Keybindings – every Hyprland shortcut, explained.
  • Modules – a deep dive into Waybar modules and what they do.
  • Waybar – the different styles available and how to switch.
  • Reference – where this all came from, and how to build your own dotfiles.
  • HollowSec – information about the community behind this project.

The HollowSec Community

BlackNode is maintained by 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, and lifting each other up.

If you want to chat, ask questions, or just hang out, join us on Discord: discord.gg/hollowsec. We have an active community of learners and professionals who are always happy to help.


A Word to You

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.


License

BlackNode is released under the MIT License. You are free to use, modify, and share it as you wish. Attribution is appreciated but not required.


Made with ❤️ by Zhaleff and the HollowSec community.

Happy hacking.