abderazak-py/retro-homepage

Analysis updated 2026-05-18

★ 6HTMLAudience · ops devopsComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((Retro Homepage))
    Dashboard features
      Service link nodes
      Live system monitor
      Browser CLI shell
    System stats
      CPU cores and threads
      RAM and storage
      Temperature and battery
      Uptime
    Visuals
      CRT scanlines and flicker
      Three color themes
      Mobile Game Boy layout
    Tech
      Rust Axum backend
      Single HTML file embedded
      Single binary deployment
    Platforms
      Linux x86_64
      Android Termux ARM64

mindmap root((Retro Homepage)) Dashboard features Service link nodes Live system monitor Browser CLI shell System stats CPU cores and threads RAM and storage Temperature and battery Uptime Visuals CRT scanlines and flicker Three color themes Mobile Game Boy layout Tech Rust Axum backend Single HTML file embedded Single binary deployment Platforms Linux x86_64 Android Termux ARM64

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Set up a homelab start page on a Linux server that links to your NAS, media server, and dashboards inside a retro CRT interface.

USE CASE 2

Run a live system monitor on an old laptop or Raspberry Pi serving as a home server, accessible from any browser on your network.

USE CASE 3

Deploy Retro Homepage on an Android phone via Termux to use the phone as a lightweight home server dashboard node.

USE CASE 4

Replace a plain browser bookmark bar with a styled service-link page that also shows real-time hardware stats.

What is it built with?

RustAxumHTMLJavaScriptPython

How does it compare?

	abderazak-py/retro-homepage	benagastov/nim-wasm-compiler	founddream/quire
Stars	6	6	6
Language	HTML	HTML	HTML
Setup difficulty	easy	easy	easy
Complexity	2/5	3/5	2/5
Audience	ops devops	developer	designer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Download the pre-built binary for your architecture, run it, and open localhost:3000, no config files or dependencies required.

MIT license, use freely for any purpose, including commercial projects, as long as you keep the copyright notice.

In plain English

Retro Homepage is a self-hosted dashboard for home lab servers that presents everything in a CRT monitor visual style, complete with scanlines, phosphor flicker, and boot animations. You run a single binary on Linux (or on Android via Termux), open a browser to port 3000, and get a page that links out to all the services running on your network alongside live system stats. The system monitor panel shows CPU usage across physical cores and logical threads, RAM, storage, temperature read from thermal sensors, battery status on laptops and Android devices, and uptime. The dashboard also includes a browser-based CLI shell where you can run a small set of built-in commands: matrix (a falling-characters animation), neofetch (system info summary), ping, and monitor (live hardware display). Three color themes are switchable from the interface: Retro Green, Amber, and Cyberpunk Blue. On small screens the layout shifts to a Game Boy-style shell. Service links are added and managed through the settings page in the UI itself, with no config files to edit manually. Changes take effect immediately. On first launch a setup screen lets you name your server and add your initial services. The binary is built with Rust using the Axum web framework. The entire frontend is a single HTML file embedded in the binary at compile time, which means there are no separate files to serve and no web server to configure. Pre-built binaries are available on the releases page for x86_64 Linux and ARM64 (for Android Termux). Building from source requires Rust, Node.js for frontend minification, and Docker or Podman for cross-compiling the ARM64 version. The project is MIT licensed and runs on Linux only, with Termux on Android as the supported mobile path.

Copy-paste prompts

Prompt 1

I downloaded the retro-homepage binary for Linux x86_64. Walk me through running it, adding my Plex and Home Assistant service links, and switching to the Amber theme.

Prompt 2

I want to run retro-homepage on an Android phone via Termux. What are the exact steps to download the ARM64 binary, set permissions, run it, and access it from another device on my network?

Prompt 3

I'm building from source and want to add a new CLI command to retro-homepage's browser shell. Where in src/main.rs do the built-in commands live, and how do I add a new one?

Prompt 4

My retro-homepage temperature sensor shows no data. How does it read thermal zones from /sys/class/thermal/ and what do I check if no sensor is detected?

Frequently asked questions

What is retro-homepage?

A single-binary homelab dashboard with a retro CRT aesthetic that shows service links, live system stats, and a browser-based CLI shell, runs on Linux or Android Termux with no config files.

What language is retro-homepage written in?

Mainly HTML. The stack also includes Rust, Axum, HTML.

What license does retro-homepage use?

MIT license, use freely for any purpose, including commercial projects, as long as you keep the copyright notice.

How hard is retro-homepage to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is retro-homepage for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub abderazak-py on gitmyhub

Verify against the repo before relying on details.