FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Original HTTPS Page]

PiercingXX · GitHub

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.

Close all issues, pull requests, and discussions opened by this user Content in all repositories owned by your account will be closed.
Add an optional note
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to 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. Workstations, laptops, tablets, servers, phones — press the button, watch the chaos organize itself.


About ⚙️

I prefer a simple clean UI based on a reproducible dotfile ecosystem, with customizations that make sense and eliminate friction.

  • I had to build a few things to make that happen:
    • A twelve‑app phone suite for GrapheneOS — launcher, dialer, SMS, notes, calendar, clock, calculator, email, weather, file sync, app blocker, fitness tracker — plus a keyboard. My daily driver, built by me.
    • A Wayland shell for Linux phones, so the whole suite has somewhere to go next.
    • A series of reproducible Linux menu‑driven installers that turn “fresh ISO” into “daily driver”.
    • A local‑first AI assistant that runs entirely on my own hardware.
    • A keyboard layout for every platform I touch.

Where the open source ecosystem falls short, I fork it and grow it.

Yes, it’s opinionated, but that is why it’s good.


Phone 📱

The mobile market is overrun by two equally non‑valid options... then there are Linux phones, also not valid but for different reasons: way underdeveloped, many issues, and not enough financial backing to make it a viable market — yet.

So while we wait, my daily is a Pixel 9 Pro running GrapheneOS, and I've replaced the stock experience one app at a time:

  • XX-Launcher — text‑first Android launcher (Kotlin). No icons, no wallpaper clutter. Search‑first drawer, 8 home slots, inline folders, gestures, widgets, theme presets, JSON backup. The design ancestor of everything below.
  • TxxT — SMS in the same style as the launcher, with a few extras to cut out the noise.
  • XX-Dialer — pretty much the same as TxxT but for calls, with a ring policy attached: spam never rings, starred contacts always ring, everyone else rings only inside their allowed time-window.
  • XX-Contacts (under construction) — Theme-matched contact list with more group options than starred.
  • Nope-Mode — selected apps go silent and un‑openable, on a schedule or on demand. Focus Mode for GrapheneOS, where Digital Wellbeing doesn't exist. Runs as device owner; no accounts, no network, no analytics.
  • XX-Calculator — Its a Calculator, that matches my theme. BigDecimal engine, no Android dependencies in the math.
  • XX-Calendar — syncs with Google through DAVx⁵, because sometimes we still need to use Google, but not on my phone, refuses to do the other ninety things Google Calendar does at you.
  • XX-Email — Gmail without the proprietary Google blob. Tabs, snooze, undo-send, operator search. No Play Services, no analytics.
  • XX-Note — Keep's front end over a folder of Markdown files on my own NAS. Every note is one plain file with frontmatter. Delete the app and lose nothing.
  • XX-Clock — clock, alarms, timers, offline. Per‑alarm ringtones.
  • XX-Weather — ZIP in, forecast out. NWS first, Open-Meteo if NOAA is down. No location permission, no Play Services.
  • XX-Files (lol & under construction) — File manager that actually respects the hierarchy.
  • XX-Keyboard (under construction) — Colemak and Piercing keyboard layout glide typing without the proprietary Google blob.
  • XX-Vitals — a cleanroom Google Fit replacement: entered on the phone, Postgres on my own NAS, no cloud anywhere.

The app that works with Android and Linux right now:

  • XX-Drive — self‑hosted file sync: one static Go binary on the server, plus a web UI, a Linux CLI client, and an Android app. Files stay as plain files on disk, metadata in SQLite.

They work individually or with the xx-launcher sharing a single active color theme. These apps will probably work on other versions of android, but its not tested. Any app that reaches out to a server, make sure you have Tailscale installed (or Headscale) and point the app at your server. Done.

And where it's all headed:

  • XX-WM — a minimalist Wayland shell for Linux phones and tablets. Text‑first, gesture‑driven, AMOLED black, Space Mono. No icon grids, anywhere. Calls, SMS, lock screen, notification shade — all first‑class surfaces. The Android suite above is the rehearsal; this is the venue. Working toward this being my daily driver.

All the Android apps ARE my daily drivers. XX-WM is under construction.

Which brings us to...


Linux 🐧

Installers & dotfiles (the classics)

  • Distro “mod” installersArch, Debian, Fedora, Void, Artix, FreeBSD, plus mini variants for tablets and note‑taking machines (arch-mini-mod, debian-mini-mod), Pi-Gnome for the Raspberry Pi 5, and debian-server for the media & AI box
    • Menu‑driven setup (whiptail) with sensible defaults (mine)
    • Hyprland, Awesome, BSPWM, DWM, i3, Sway, Qtile and GNOME mods, Flatpak, UFW, developer tooling
    • Optional NVIDIA + Microsoft Surface kernel support assembled for easy script install
    • Different variants for workstations, servers, tablets, and phones
  • Piercing-Dots — one repo to keep your machine updated and configured
    • Hyprland, Awesome, BSPWM, DWM, i3, Sway, and Qtile with unified UX across all of them
      • For touchscreen tablets and the like: customized GNOME and my own XX-WM (see above)
    • Waybar, kitty, Neovim, Yazi, Tmux, GIMP customized into minimal yet fully functional powerhouses
    • Maintenance and software‑manager scripts so you stop copy‑pasting from blogs
    • Super+/ opens your Cheat Sheet; Super+S opens a bash‑driven settings menu — don’t leave the keyboard

Device enabling

Drivers and scripts for hardware that isn’t in the Linux kernel:

  • Surface kernel support across the installers.
  • NuVision 8" tablet Wi‑Fi/Bluetooth/Audio fixes — obscure old tech that could be perfect if it was made with modern hardware.
  • KooTigers touchscreen/driver utilities — neat little toy that needed some help.

Local AI & self‑hosting 🤖

  • Skippy (private) — the local‑first AI assistant on my own hardware and private cloud.
    • Skippy is truly a universal AI:
      • Terminal coding agent
      • Personal assistant with Home Assistant tie‑in
      • Per‑person / per‑location recognition and memory
      • Mobile app remote over Tailscale (text and voice)
      • Optional Discord presence (text and voice)
    • The brain is served locally by whatever model your hardware can manage
    • Designed to be subscription‑free. Only runs on local hardware.
  • Nagatha (private) — Skippy add‑on: Skippy's independent auditor and cleanroom counterpart in a two‑agent estate: Skippy builds, Nagatha audits. A terminal agent framework for self‑hosted LLMs behind any OpenAI‑compatible API.
  • Roscoe (private) — Skippy add‑on: face‑recognition presence and greetings for home and business sites, served over the tailnet.
  • skpp‑radio (private) — Skippy add‑on: a local radio station that streams to multiple locations inside your Tailscale network. Skippy writes and voices the ads (if you want them), controls the Home Assistant speakers, and airs spots on a schedule. Because he can.
  • skippy-tel (private) — Skippy add‑on: Skippy's communications layer: event streams with a hard business/personal wall, offline‑first, and agents post through the same door people do.
  • elder-ai (private) — Skippy add‑on: This is a local AI model trainer. Runs on this box. No cloud.
  • jal (private) — Skippy add‑on: offline inventory sourcing engine. House catalog, USD quotes, a staff chatbot via skippy-tel; everything stays on the machine.
  • wyoming-sentence-tts — fork of the Wyoming‑protocol TTS bridge that streams audio per sentence, so your voice assistant starts talking after the first sentence instead of the last one.
  • XX‑Stack (private) — self‑hosted AI orchestration with optional cloud tie-in for Opencode and Hermes Agent: agent contracts, routing policy, an MCP server, and a local inference control plane over Tailscale. This is what Skippy started as. This has grown alongside Skippy as a benchmark tool.

Battlezone 98 Redux 🎮

The 1998 tank‑RTS/FPS hybrid that refuses to die...and I intend to keep it that way:

  • battlezone-netcode-patch — netcode patch for BZ98 Redux multiplayer.
  • battlezone98-map-generator — AI map‑generation toolchain (bzmap) for multiplayer maps: generation pipeline, format writers, validators, and Workshop packaging.
  • BattleZone98-Godot-Map-Editor — a feature rich Godot‑based map editor for the same.
  • BZ1-GameWatcher — fork of the multiplayer game watcher.
  • skippy-battlezone-map-generator (private) — this one is explicitly for Skippy with lots of testing and future plans in the works. The public toolchain above was extracted from this.
  • skippy-plays-battlezone (private) — Skippy plays BZ98 Redux as a real multiplayer opponent: own client, own player slot, own scoreboard line, acting only through the same input path a human uses. **Currently Shelved ** - Skippy needs more data.

Odds & ends 🗃️

  • piercingxx-branding (private) — the brand system behind all of the above: color, type, logomark, and voice.
  • xx-platform (private) — a full business web platform: booking, chat, docs, and forms. Next.js + Prisma.
  • piercing-keyboard-layout — my own layout that no one else will ever use. One layout, every platform: Linux (xkb), Windows, Android/GrapheneOS, and QMK/Vial ortho boards.
  • book-list (private) — my ongoing attempt to separate the worthwhile from the well‑marketed nonsense.

How I work 🧪

  • POSIX‑first Bash where Bash belongs; Python + GTK4, Kotlin, or TypeScript where it doesn’t
  • Local‑first, always: my AI, my inference, my data, my hardware. Cloud is opt‑in or absent.
  • Reproducibility over hand‑tweaking; scripts > screenshots (always)
  • Text‑first, gesture‑driven, low‑friction UX — on a desktop, a phone, or a lock screen
  • Minimal dependencies, sane defaults, readable code, zero drama

Tech I reach for 🛠️

  • Bash, systemd (when needed), whiptail
  • Hyprland (also Sway and Herbst; GNOME on tablets; phoc on phones)
  • Kitty, Yazi, Neovim, tmux
  • Python + GTK4/libadwaita + layer‑shell for mobile surfaces; Kotlin for Android
  • Pacman/Paru, apt, xbps, Flatpak… build from source when needed (Neovim Nightly & Yazi)
  • Docker/Compose, NVIDIA + CUDA, SGLang, Wyoming/Home Assistant, Tailscale

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
  • Local first: if it can run on my hardware, it will...if it cant, buy more hardware
  • Defaults with a spine: opinions included at no extra charge

Contact 📮

  • Email: Don’t

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


Pinned Loading

  1. XX-WM XX-WM Public

    Minimalist Linux Phone Wayland Shell.

    Python 1

  2. piercing-dots piercing-dots Public

    All my dot files and scripts and customizations for all my systems

    Python 1

  3. arch-mini-mod arch-mini-mod Public

    Minimal setup designed for linux powered note taking tablet

    Shell 5

  4. 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 2


Back | FazBrowse Home | New Git URL