selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

jcorp-nomad logo

Self-host jcorp-nomad

mk3

Pocket ESP32-S3 offline media server with its own hotspot

BetaOpen SourceOther
Updated10 hours ago
LanguageHTML
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
1 244
Storage
microSD card, exFAT or FAT32 (16-128GB recommended, up to 2TB)
Install with Build from Source
jcorp-nomad screenshot 1jcorp-nomad screenshot 2

What is jcorp-nomad?

Jcorp Nomad is a pocket-sized media server that runs on an ESP32-S3 board, spins up its own Wi-Fi hotspot (or joins your existing network in WiFi Mode), and streams movies, shows, music, books, comics and photos to any browser — no internet needed. The author started it as a portable, low-cost take on running a Jellyfin server. Firmware 4.6 brings exFAT card support, offline ZIM encyclopedias such as Wikipedia with a PC-built search index, offline maps with routing, in-browser language translation, DLNA serving for TVs, EmulatorJS ROM play including DOOM, two-player games over the local Wi-Fi, a chat page, sidecar subtitles, recipe and 3D-model libraries, a file browser, global search, themes with dark mode, and a login-gated admin panel. To run it you flash the firmware with Arduino IDE or the browser flasher at nomadflash.jcorptech.net, copy the SD card template onto a microSD card, and prepare ZIMs, maps and language packs with the companion Nomad Tools app. A 3D-printable case is included, and prebuilt units are sold, though every device runs the same open-source system. It targets the Waveshare ESP32-S3 board specifically, six to eight simultaneous 480p streams are typical, the project labels itself beta, and offline maps remain slow.

Should you self-host jcorp-nomad?

jcorp-nomad scores 52/100 on selfhost.directory (how scoring works) and ranks #53 of 118 in Media Server. It has 1 244 GitHub stars.

It shipped 3 stable releases in the past year. The latest, mk3, came out on 26 September 2026.

Setup is moderate: expect some configuration beyond a single command. It is Other-licensed and written mostly in HTML.

Its closest alternative on selfhost.directory is Jellyfin (88/100, 58 737 stars). It scores higher overall, so compare the two before you pick. See jcorp-nomad vs Jellyfin side by side.

Features

  • DLNA server for TVsTested against few routers and TVs; roughly one stream at 4K.
  • Ebook, PDF and comic readers
  • File BrowserA PC is recommended for bulk work.
  • Game ROM emulation
  • Global Search
  • Local multiplayer games
  • Movies and shows playback with resume
  • Music player with background playback
  • Offline maps with routingKnown rough edge: big regions are slow to draw; routing maps are US only for now.
  • Offline media streaming over Wi-Fi hotspot
  • Offline translation
  • Offline Wikipedia / ZIM archives
  • Subtitles
  • Themes and Customization
  • WiFi Mode (join existing network)

jcorp-nomad README

How to install jcorp-nomad

Install jcorp-nomad with Build from Source

  1. Flash ESP32-S3 firmware from /firmware/.
  2. Copy /SD_Card_Template/ files onto the card. Any exFAT or FAT32 card works as-is, you only need to format if the card is brand new or broken.
  3. Place media in /Movies, /Shows, /Books, /Music, /Gallery, /Files, /Games, /Cookbook, /Workshop.

Quick Start steps 1-3; then insert the SD card, power over USB and connect to the hotspot.

How to configure jcorp-nomad

  • BOARD_USB_CIn Display_ST7789.h, set to 1 when building for the USB-C ESP32-S3-LCD-1.47B board (LCD backlight moves from GPIO 48 to GPIO 46).

    In Display_ST7789.h, set to 1 when building for the USB-C ESP32-S3-LCD-1.47B board (LCD backlight moves from GPIO 48 to GPIO 46).

    values: 0 or 1

  • Jcorp_NomadJcorp_NomadDefault Wi-Fi hotspot SSID the device creates (Quick Start step 5).

    Default Wi-Fi hotspot SSID the device creates (Quick Start step 5).

jcorp-nomad releases & version history

More in Homelab

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…