Skip to content
terminaltrovePublic

About

The work is mysterious and important...

Topics

Resources

Stars

108 stars

Watchers

2 watching

Forks

Repository files navigation

lumon

The work is mysterious and important...

lumon preview

Go 1.26.11+ Built with Bubble Tea LAN multiplayer

Description

Lumon is an interactive terminal experience that simulates the macrodata refinement process shown in the TV series "Severance."

This TUI application is built using the Bubble Tea framework and related libraries from Charm.

Play

Installation

From GitHub Releases

You can download the latest binary from GitHub releases for your platform here.

Using Homebrew

brew install terminaltrove/tap/lumon

Using eget

eget terminaltrove/lumon

Using Go

go install github.com/terminaltrove/lumon/cmd/lumon@latest

Build from Source

Requirements: Go 1.26.11 or later

git clone https://github.com/terminaltrove/lumon.git
cd lumon
go build -o lumon ./cmd/lumon
# or: ./scripts/build.sh   for every target, into dist/, with checksums

Features

  • Find the corrupt clusters in the grid and refine them into five bins
  • A fisheye lens that grows the digits under your cursor and pushes the grid apart
  • Clusters that swell, redden and eventually detonate if you leave them
  • Up to four refiners on a file, on the public server or on your own network
  • Computer refiners for company, nine colour themes, and mouse support
  • Type KIER for a nice treat ;)

Screenshots


Scary numbers growing under the cursor

The Lumon logo at startup

Choosing a file

Refined numbers flying into bin 01

Three refiners on one file

The file in 3D

Standings

Controls

Credits

Four of the nine themes, on the same board:


lumon

phosphor

amber

trove

Preview


The boot log, then the Lumon logo

Taking a cluster, choosing a bin, and refining it

An unrefined cluster exploding across the board

Mark and Helly finishing Cold Harbor

Helly, Mark and Dylan refining Labrador together

Usage

TUI Controls

  • ↑ ↓ ← → or h j k l - Move the cursor
  • f - Take the cluster under the cursor
  • 1-5 - Choose a bin
  • enter or space - Refine the cluster under the cursor
  • ? - Every control
  • q - Back out, or quit

The full list is in docs/controls.md.

Recommended terminals

Ghostty, WezTerm, iTerm2 or kitty are recommended. See more at docs/terminals.md.

More

Development

make help                          # every task
make test                          # the suite, under the race detector
make check                         # fmt, vet and test

For inline plugin development (Bun 1.3.14 or later):

bun install --frozen-lockfile --ignore-scripts
bun run check:plugins
bun run test:plugins

The integration tests build this checkout's native game and exercise embedded rendering, input, resizing, activation defaults and cleanup.

License

MIT, in LICENSE. Third-party licences are in licenses/.

Disclaimer

This project is not affiliated with, endorsed by, or connected to Apple TV+, "Severance," or Lumon Industries (which is fictional).

Acknowledgements

  • Inspired by the TV show "Severance" on Apple TV+
  • Built with Bubble Tea and Lip Gloss from our friends at Charm
  • The physics is ported from inertia by Kairav Mittal
  • To you for checking out and trying lumon!

Lumon Screenshot

About

The work is mysterious and important...

Topics

Resources

Stars

108 stars

Watchers

2 watching

Forks

Releases

Contributors

Languages