Skip to content
View johnvexcoder's full-sized avatar
:octocat:
In development.
:octocat:
In development.

Block or report johnvexcoder

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.

Content in all repositories owned by your account will be closed.
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
johnvexcoder/README.md

J0hn Vex Coder

SOFTWARE DEVELOPMENT · SYSTEMS · OPEN SOURCE

Linux engineering, self-hosted infrastructure, automation, observability, and practical developer software.

GitHub Projects X Ko-fi

Profile · Selected Work · Architecture · Engineering Index · Technology · Principles · Support


01 · Profile

I build software that stays useful after the demo.

My work sits at the intersection of applications and systems: tools that run on Linux, observe infrastructure, automate repetitive operations, expose useful telemetry, manage local resources, or improve how developers interact with their machines.

I am most interested in projects where understanding the underlying system matters just as much as building the interface around it.

That has led me to work across:

  • self-hosted infrastructure and observability
  • Linux and terminal environments
  • host-level telemetry and automation agents
  • web, desktop, and CLI applications
  • private media and local-first systems

I value software that is clear to operate, straightforward to inspect, modular enough to extend, and useful enough to keep running.

Engineering focus

SYSTEMS
Linux · Shell · Hardware

INFRASTRUCTURE
Docker · Proxmox · Telemetry

APPLICATIONS
Web · Desktop · CLI

AUTOMATION
Agents · Monitoring · Tooling

PHILOSOPHY
Useful · Observable · Modular

Build the product. Understand the system. Remove the repetition.


02 · Selected Work

A portfolio of systems, tools, and applications built around real workflows.

🖥️ HomeLab OS

Infrastructure Command Center

A self-hosted, NOC-style platform for viewing a homelab as one operating environment instead of a collection of disconnected machines and dashboards.

Engineering surface

  • live server and fleet telemetry
  • network topology
  • hardware metrics
  • alerts and operational views
  • Docker visibility
  • historical data
  • provider-oriented integrations
  • administration and control surfaces

Built with

TypeScript React Vite Node.js WebSocket SQLite


View HomeLab OS →

🤖 HomeLab Agent

Node Intelligence Layer

A lightweight agent designed to run close to the host and expose information that central infrastructure APIs do not always provide.

Telemetry surface

  • CPU, memory, and storage
  • hardware sensors and temperatures
  • SMART health
  • Docker information
  • kernel and host details
  • network statistics
  • local system telemetry
  • Proxmox-related enrichment

Built with

TypeScript Node.js Linux Docker


View HomeLab Agent →

🐧 DistroZSH

Linux-Native Shell Environment

A framework-free ZSH environment that gives Linux systems a polished, distribution-aware shell while keeping the implementation lightweight and understandable.

Designed around

  • native ZSH
  • distribution-aware presentation
  • multiple Linux distributions
  • install / uninstall tooling
  • configurable layouts
  • theme previews
  • minimal framework overhead

Built with

ZSH Shell Linux


View DistroZSH →

🗜️ CompressMe

Image Optimization Workspace

A cross-platform image compression application built for both interactive use and repeatable automation.

Designed around

  • GUI + CLI workflows
  • batch compression
  • parallel processing
  • duplicate detection
  • SHA-256 and perceptual hashing
  • metadata preservation
  • multiple image formats
  • history and reporting

Built with

Python PySide6 Pillow CLI


View CompressMe →

⌨️ Python-Keybr

Terminal Training + Diagnostics

A curses-based typing environment that combines practice, persistent progress, adaptive offline learning, and keyboard diagnostics inside the terminal.

Designed around

  • multiple training modes
  • WPM and accuracy tracking
  • persistent statistics
  • adaptive practice
  • per-letter analysis
  • progressive unlocking
  • bigram tracking
  • visual keyboard diagnostics

Built with

Python curses CLI


View Python-Keybr →

🎬 MovieFlix

Private Media Platform

A self-hosted media application that turns local or network-attached storage into a complete streaming environment.

Designed around

  • media library scanning
  • movie / TV identification
  • metadata and artwork enrichment
  • FFprobe analysis
  • profiles and authentication
  • HTTP range streaming
  • subtitles and transcoding
  • administration

Built with

Next.js TypeScript Node.js FFmpeg SQLite


View MovieFlix →



03 · Systems Architecture

The HomeLab ecosystem

HomeLab OS and HomeLab Agent are intentionally separate.

The dashboard owns the operational experience.
The agent owns node-local enrichment.

┌────────────────────────────────────────────────────────────────────────────┐
│                              HOME LAB OS                                   │
│                                                                            │
│   Fleet · Servers · Topology · Telemetry · Alerts · Administration         │
└────────────────────────────────┬───────────────────────────────────────────┘
                                 │
                         normalized data model
                                 │
               ┌─────────────────┴──────────────────┐
               │                                    │
      ┌────────▼─────────┐                ┌─────────▼─────────┐
      │ Infrastructure   │                │   HomeLab Agent   │
      │ Providers        │                │                   │
      │                  │                │ Node-local        │
      │ Proxmox / APIs   │                │ enrichment        │
      │ VM / LXC state   │                │                   │
      │ Cluster state    │                │ Sensors · SMART   │
      │ Storage / Tasks  │                │ Docker · Network  │
      └──────────────────┘                └─────────┬─────────┘
                                                   │
                             ┌─────────────────────┼────────────────────┐
                             │                     │                    │
                        ┌────▼────┐           ┌────▼────┐         ┌────▼────┐
                        │ Linux   │           │ Docker  │         │Hardware │
                        │ Host    │           │ Engine  │         │ / Disks │
                        └─────────┘           └─────────┘         └─────────┘

Why this split matters

Layer Responsibility
HomeLab OS presentation, fleet state, alerts, topology, workflows
Infrastructure providers authoritative platform / infrastructure data
HomeLab Agent host-only telemetry and machine-local enrichment
Linux / Docker / hardware raw operating environment

The result is a system where richer telemetry can be added without forcing the dashboard to become tightly coupled to one operating system, one hypervisor, or one hardware layout.


04 · Engineering Index

SYSTEMS

Linux
Shell environments
Hardware telemetry
Diagnostics

INFRASTRUCTURE

Self-hosting
Docker
Proxmox
Monitoring

AUTOMATION

Agents
Installers
Background services
Operational tooling

APPLICATIONS

Web platforms
Desktop tools
CLI software
Media systems

Current development lines

┌────┬────────────────┬────────────────────────────────────────────────────┐
│ 01 │ HomeLab OS     │ Infrastructure visibility and operations           │
│ 02 │ HomeLab Agent  │ Host telemetry and system enrichment               │
│ 03 │ DistroZSH      │ Lightweight Linux shell experience                 │
│ 04 │ Python-Keybr   │ Terminal training and keyboard diagnostics         │
│ 05 │ CompressMe     │ Image optimization for users and automation        │
│ 06 │ MovieFlix      │ Private media built around local / NAS storage     │
└────┴────────────────┴────────────────────────────────────────────────────┘

05 · Technology

Languages

Languages

Application Engineering

Application engineering

Infrastructure & Platform

Infrastructure and platform

The problem determines the stack. Technologies are tools, not the identity of the project.


06 · Principles

01 / Utility

Useful over impressive.

A project should solve a workflow or remove friction, not exist only to demonstrate a technology.

02 / Clarity

Understand the system.

Good software makes behavior observable and important decisions explainable.

03 / Automation

Remove repetition.

Repeated operations eventually become scripts, tools, agents, or better interfaces.

04 / Architecture

Keep boundaries deliberate.

Collection, presentation, integrations, storage, and platform-specific logic should have clear responsibilities.

05 / Ownership

Control the important layers.

Self-hosting is valuable when it improves control over deployment, data, and the underlying system.

06 / Iteration

Ship, observe, refine.

Useful software is shaped by real usage, debugging, feedback, and repeated improvement.


07 · Operating Model

           DISCOVER
      understand the problem
               │
               ▼
            BUILD
      create the smallest
       useful system
               │
               ▼
           OBSERVE
      expose behavior and
          failure modes
               │
               ▼
           IMPROVE
      remove friction and
      tighten architecture
               │
               ▼
          AUTOMATE
      make repeated work
         disappear
               │
               └──────────────────────► iterate

The standard I aim for

A project is not finished because the interface renders or the command succeeds.

It becomes valuable when someone can understand it, run it, operate it, recover from problems, and extend it without fighting the architecture.


GitHub Activity

GitHub statistics

Top languages


GitHub contribution streak


08 · Support

Open source should stay useful.

I publish my main projects in public because software becomes more valuable when people can inspect it, learn from it, run it, adapt it, and improve it.

If something I built has saved you time or made a system easier to operate, you can support continued development here:

Support me on Ko-fi

Based in the Philippines · Support is open worldwide.


Connect

GitHub X Ko-fi


ENGINEER THE SYSTEM · SHIP THE TOOL · IMPROVE THE WORKFLOW

J0hn Vex Coder · Open Source Engineering · Linux · Self-Hosted Systems



Pinned Loading

  1. HomeLab-OS HomeLab-OS Public

    A premium self-hosted Infrastructure Operating System for your homelab — a real-time NOC dashboard with animated telemetry, hardware monitoring, alerts, topology mapping, and a modular architecture…

    TypeScript

  2. HomeLab-Agent HomeLab-Agent Public

    Lightweight agent for remote VMs and container hosts. Collects host metrics and Docker container info, then posts telemetry to your HomeLab OS dashboard.

    TypeScript

  3. MovieFlix MovieFlix Public

    MovieFlix transforms local media folders (HDD/SSD/NAS) into a polished streaming platform. It scans files, identifies movies and shows, fetches metadata and artwork from TMDB, analyzes codecs with …

    TypeScript

  4. CompressMe CompressMe Public

    A powerful, cross-platform image compression tool with both a modern GUI (PySide6) and a CLI interface. Batch-compress images, detect duplicates, preserve metadata, and generate detailed reports.

    Python

  5. Python-Keybr Python-Keybr Public

    A terminal-based typing trainer inspired by keybr.com, built entirely in Python using the curses library.

    Python 1

  6. DistroZSH DistroZSH Public

    A lightweight, framework-free ZSH configuration that delivers a native, professional terminal experience across multiple Linux distributions.

    Shell