Skip to content
View Piercingxx's full-sized avatar

Block or report Piercingxx

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Piercingxx/README.md

PiercingXX

I bend Linux to my will so you don’t have to. Desktops, tablets, servers —press the button, watch the chaos organize itself.


About ⚙️

I build reproducible Linux environments and dotfile ecosystems, optimize Wayland desktops (Hyprland, GNOME, etc.), and ship menu‑driven installers that turn “fresh ISO” into “daily driver” before your coffee cools. Yes, it’s opinionated. No, I won’t apologize. My work spans:

  • Distro installers for Arch, Debian, and Fedora
  • A comprehensive dotfiles suite with unified UX across WMs
  • Device enablement (Surface devices, and more obsecure tablets and touchscreens)
  • Workhorse server for self hosting: website, local AI, business communications, and storage.

If you like scripts that remove friction, enforce taste, and deliver a clean Wayland UX—this is that. If you don’t, there’s always “try turning it off and on again.”


What I build 🧰

  • Arch / Debian / Fedora “mod” installers
    • Menu‑driven setup (whiptail) with sensible defaults (mine)
    • Hyprland + GNOME mods, Flatpak, UFW, developer tooling
    • Optional NVIDIA + Microsoft Surface kernel support (for the brave)
  • Piercing‑Dots
    • One repo to keep your machine updated and configured
    • Hyprland and Gnome are fully built out. Awesome/BSPWM/i3/Sway are mostly there/depreciated
    • Waybar, kitty, Neovim, Yazi, GIMP are all heavily customized into minimal yet fully functional power houses.
    • Maintenance and software manager scripts so you stop copy‑pasting from blogs
    • ' /' will open your Cheat Sheet
  • Bash driven Settings Menu
    • Dont leave the keyboard, ' S' and your in my settings menu
  • Device enablement
    • Surface kernel helpers and services
    • NuVision 8" tablet Wi‑Fi/Bluetooth/Audio fixes (you’re welcome)
    • KooTigers touchscreen/driver utilities
  • Workstations & servers
    • Debian server bootstrap with CUDA/NVIDIA, Docker/Compose, Nextcloud set up for local AI and self hosting needs.
    • Local LLMs with Ollama, creative tooling (DaVinci Resolve), fonts

Selected projects 📦

Project What it does Highlights
arch‑mod Full‑featured Arch workstation installer Hyprland/GNOME, Paru+Flatpak, UFW, NVIDIA/Surface options
arch‑mini‑mod Minimal Arch + Hyprland for tablets and low‑resource devices Touch‑friendly, NuVision/KooTigers resources, lean setup
debian‑mod One‑step Debian workstation Hyprland session, NVIDIA/Surface options, Flatpak
fedora‑mod Menu‑driven Fedora setup GNOME customizations, Cosmic/Hyprland options, Surface
debian‑server Headless Server NVIDIA+CUDA, Docker, Nextcloud, Ollama, Nginx, Cloudflare
piercing‑dots Dotfiles + maintenance WM dots (Hyprland/Awesome/BSPWM/i3/Sway), Neovim, eww/waybar, GIMP, scripts

Bonus: Raspberry Pi experiments live in Pi-Gnome/. No, they’re not “production ready.” They’re fun.


How I work 🧪

  • POSIX‑first Bash with clear prompts and escape hatches
  • Reproducibility over hand‑tweaking; scripts > screenshots (always)
  • Wayland‑centric desktop ergonomics (fast keybinds, low friction)
  • Minimal dependencies, sane defaults, readable code, zero drama

Tech I reach for 🛠️

  • Bash, systemd, whiptail
  • Hyprland, GNOME, eww, waybar, kitty, Yazi, Neovim
  • Pacman/Paru, apt, dnf, Flatpak
  • Docker/Compose, NVIDIA + CUDA, Nextcloud, Ollama

Philosophy (short version) 🌀

  • Applied entropy: build systems that stay useful as the world changes
  • Elegant complexity: hide the sharp edges, keep the power
  • Repeatable results: a fresh install should feel like home in minutes
  • Defaults with a spine: opinions included at no extra charge


Contact 📮

  • Email: Don’t

    Open an issue in the relevant repo instead. If it’s a rant, make it entertaining.


Pinned Loading

  1. debian-mod debian-mod Public

    Automates the installation of a fully‑featured Debian workstation, including optional GPU drivers, Mircosoft Surface support, Hyprland, and a curated set of workstation tools.

    Shell 1

  2. arch-mod arch-mod Public

    Personal setup for all Arch based systems (Hyprland & Gnome)

    Shell 1

  3. fedora-mod fedora-mod Public

    Automates the installation of a fully‑featured Fedora workstation, including optional GPU drivers, Mircosoft Surface support, Gnome, Cosmic, and Hyprland, and a curated set of workstation tools.

    Shell

  4. piercing-dots piercing-dots Public

    All my dot files and then some... This is where the goodness lives

    Python 1

  5. Pi-Gnome Pi-Gnome Public

    Install Gnome on a Raspberry Pi 5, starting with a fresh install of Raspberry Pi OS 64bit

    Shell 2

  6. arch-mini-mod arch-mini-mod Public

    Minimal setup designed for linux powered note taking tablet

    Shell 2