luthebao

Llflash — A Flash Player emulator in Rust, with a one-line RTMP host install

2026-05-21T00:00:00+00:00

Llflash is an Adobe Flash Player emulator written in Rust, targeting both desktop and the web via WebAssembly. It’s a fork of Ruffle with one headline addition: RTMP support, delivered through a small native messaging host that pairs with the browser extension. The rest of the runtime tracks upstream — ActionScript 1, 2, and 3 are all supported, enough to bring most legacy .swf content back to life: games, animations, learning tools, and the multiplayer-streaming SWFs that vanilla Ruffle can’t reach because browsers don’t expose raw TCP.

Desktop builds and the RTMP native messaging host are published on the llflash release. Questions, bug reports, and feature requests go through the luthebao discussions tab — there’s no public issue tracker.

Setup in three steps

Install the browser extension. Coming soon — the Chrome Web Store / Firefox Add-ons listing isn’t published yet. Until then, you can side-load the unpacked extension from the release page.
Install the RTMP native messaging host with the one-liner for your OS (see below). This is the small out-of-process helper that lets SWFs reach rtmp:// servers.
Visit any page that uses Flash. The extension picks up .swf embeds automatically and routes RTMP traffic through the host you just installed — no per-site configuration.

Install the RTMP native messaging host

Llflash plays static SWFs entirely in the browser, but RTMP-based content (legacy live-streaming SWFs, multiplayer games that talk to rtmp:// servers) needs an out-of-process helper — browsers can’t open raw TCP sockets. The RTMP native messaging host is a small Rust binary the browser extension launches over Chrome / Firefox’s native-messaging protocol. Once registered, RTMP traffic inside any SWF is routed through it transparently.

Pick the line that matches your OS.

macOS / Linux

curl -fsSL https://github.com/luthebao/luthebao/releases/download/llflash/rtmp-host-install.sh | bash

Supports macOS (Apple Silicon) and Linux x86_64. The script downloads the latest release tarball, drops the binary under ~/.llflash/rtmp-host/, and writes the native-messaging manifest (com.longliveflash.rtmp_host) into the right per-browser directory. Default target is Chrome — pass a browser name to install for a different one:

# chrome | chromium | edge | brave | firefox | all
curl -fsSL https://github.com/luthebao/luthebao/releases/download/llflash/rtmp-host-install.sh | bash -s -- firefox

Windows

In PowerShell:

irm https://github.com/luthebao/luthebao/releases/download/llflash/rtmp-host-install.ps1 | iex

Same behaviour as the bash version: pulls the latest zip, extracts to %LOCALAPPDATA%\LongLiveFlash\rtmp-host\, and registers the native-messaging manifest. To pass a browser argument, save the script first and run it locally:

$u = 'https://github.com/luthebao/luthebao/releases/download/llflash/rtmp-host-install.ps1'
iwr $u -OutFile rtmp-host-install.ps1
PowerShell -ExecutionPolicy Bypass -File .\rtmp-host-install.ps1 all

After install, restart your browser and reload the extension — the host appears under chrome://extensions/ (or the Firefox equivalent) and RTMP-backed SWFs should connect straight away.

Environment overrides

Both scripts honour the same overrides if you need to pin a specific release or change the install location:

Variable	Default
`LLFLASH_REPO`	`luthebao/luthebao`
`LLFLASH_TAG`	`llflash`
`LLFLASH_INSTALL_DIR`	`~/.llflash/rtmp-host` (Unix) / `%LOCALAPPDATA%\LongLiveFlash\rtmp-host` (Windows)

Desktop builds

Standalone desktop builds are listed on the release page alongside the install scripts:

llflash-rtmp-host-1.1.0-macOS-arm64.tar.gz
llflash-rtmp-host-1.1.0-Linux-x64.tar.gz
llflash-rtmp-host-1.1.0-Windows-x64.zip

Each archive contains the host binary plus the install script for that platform — useful if you’d rather audit the script and run it offline instead of piping from curl.

Relationship to Ruffle

Llflash is a fork of Ruffle, not a rewrite. The AVM1/AVM2 interpreters, the renderer, and the SWF parser are Ruffle’s work — credit and thanks go to that project and its contributors. What this fork adds is the rtmp:// path: the llflash-rtmp-host binary you just installed terminates the RTMP/RTMPE/RTMPT protocols outside the browser sandbox, and a thin bridge inside the wasm module forwards NetConnection / NetStream traffic to it. With that in place, SWFs that depend on Flash Media Server, Wowza, or any RTMP origin keep working — which is the gap that kept a noticeable slice of legacy Flash content from running under stock Ruffle.

Everything else — including most ActionScript edge cases, codec coverage, and the desktop player — behaves like upstream Ruffle. Questions, bug reports, and feature requests live on the luthebao discussions tab (the source repo is private, so there’s no public issue tracker)

Privacy

Long Live Flash respects user privacy. The browser extension searches website HTML for embedded Flash content without storing or transmitting browsing activity.

Flash content may store data locally using browser LocalStorage APIs and make network requests to third-party servers, potentially transmitting personally identifiable or “fingerprintable” information. The llflash-rtmp-host extends that surface in one direction only: when a SWF opens an rtmp:// connection, the host establishes a TCP connection to that origin on the SWF’s behalf. Llflash itself does not inspect, log, or retain RTMP payloads — they pass through the host and back to the wasm runtime — but the destination server will see traffic from your IP address, exactly as it would have under the original Flash Player.

LLFlash stores settings locally via the browser’s extension storage API. These settings don’t contain identifying information and aren’t transmitted to servers.

When errors occur, users can optionally submit crash reports through the luthebao discussions tab. These reports include browser and site information but aren’t stored or transmitted without explicit user consent.

The project is a fork of Ruffle, which is open-source; LLflash’s additions are distributed via the release page above.

Users should exercise caution with untrusted content. LLflash isn’t responsible for third-party privacy practices, and we encourage reviewing the applicable privacy policies and terms of the websites and services visited.

MMStock — Native terminal for the Vietnamese stock-futures market

2026-05-20T00:00:00+00:00

MMStock is a native desktop terminal for the Vietnamese stock-futures market. It connects directly to the VPS data feed (web7.vps.com.vn) — no separate backend service in between — and renders charts, indicators, and a real-time price stream entirely on the client.

The app is written in Odin on top of Sokol, Dear ImGui, and ImPlot. Builds run on macOS (Apple Silicon and Intel), Linux x86_64, and Windows x86_64.

MMStock — two chart panels with VPVR overlays and the BLT-MACD/RSI indicators

Download

Download MMStock — macOS and Windows builds available on the release page.

One-liner install

macOS / Linux:

curl -fsSL https://github.com/luthebao/luthebao/releases/download/mmstock/install.sh | sh

Windows (PowerShell):

irm https://github.com/luthebao/luthebao/releases/download/mmstock/install.ps1 | iex

What it does

Charts — candlestick, line, and Heiken Ashi, across multiple timeframes (1m, 5m, 15m, 30m, 1H, 4H, 8H, 1D, 1W, 1M).
Real-time stream — live prices over WSS, historical bars over HTTPS, both from VPS directly.
Drawing tools — per-chart horizontal line, rectangle, and point-line annotations.
Indicators
- VPVR — volume-by-price overlay.
- BLT-ID-RSI — a Pine-script port combining RSI with Fast (RMA 5) and Slow (WMA 45) moving averages, regular and hidden bull/bear divergence detection, a VMC gold buy signal, a Stoch-RSI sell signal, and a configurable multi-timeframe table.

Architecture in one paragraph

A single Odin binary holds the UI (ImGui/ImPlot rendered through Sokol), the VPS HTTPS + WSS client, and a local SQLite store for cached bars. There is no server-side component to deploy — the terminal is the entire app, and updates ship as new binaries.

Why a native client

Two reasons. First, charting tens of thousands of bars at 60 fps with smooth pan/zoom is straightforward in ImPlot and painful in a browser. Second, going straight to the exchange feed cuts an entire layer of infrastructure: no API gateway, no backend cache, no queue — fewer moving parts to break and nothing to host.

Status

Active development. The Vietnamese stock-futures market is a relatively niche audience, so MMStock is built primarily as a tool I want to use myself, with an eye on making it pleasant for anyone with a similar workflow.

mac-cli — A multi-purpose macOS command-line tool

2026-05-20T00:00:00+00:00

mac-cli is a multi-purpose command-line tool for macOS, written in Odin. It bundles several utilities I reach for daily — disk cleaning, image/video optimisation, and screenshots — behind one small, agent-friendly binary. Currently ships an Apple Silicon (arm64) build only.

Source and releases live at github.com/luthebao/mac-cli.

Install

One-liner — pulls the latest release binary, no Odin toolchain required:

curl -fsSL https://raw.githubusercontent.com/luthebao/mac-cli/main/install.sh | bash

The script downloads the latest tarball, picks a sensible install dir (/usr/local/bin if writable, otherwise ~/.local/bin), strips the macOS quarantine xattr so Gatekeeper doesn’t block the first run, and prints a PATH hint if the chosen dir isn’t already on $PATH.

Self-update

The binary updates itself — same install logic, no flags needed:

mac-cli update            # install latest if newer
mac-cli update --check    # report only; exits non-zero when update available
mac-cli update --force    # re-run the installer even if already current

Commands

`clean` — disk cleaner

mac-cli clean                        # interactive cleaner
mac-cli clean --risky                # include risky categories
mac-cli clean categories             # list all 16 cleanable categories
mac-cli clean uninstall              # remove apps + their leftovers
mac-cli clean maintenance --dns      # flush DNS cache
mac-cli clean backup --list          # list pre-delete backups

The interactive cleaner scans every category, then shows exactly what it will remove and how much space you get back before you commit:

mac-cli clean — scan summary and confirmation prompt

Anything outside a known-safe path is refused rather than deleted, so a stray bad rule can’t touch the wrong directory. When it finishes you get a tally of what was freed:

mac-cli clean — “path not safe” refusals and the final freed-space tally

`clop` — image & video optimiser

mac-cli clop                         # interactive picker
mac-cli clop -o photo.png            # optimise in place
mac-cli clop -o ~/Pictures -r        # recurse into a directory
mac-cli clop -d 50% clip.mp4         # downscale by factor
mac-cli clop -c webp cover.png       # convert image format
mac-cli clop -s IMG_2156.jpg         # strip EXIF metadata

Shells out to format-specific CLIs (pngquant, jpegoptim, gifsicle, ffmpeg, vips, cwebp, heif-enc, exiftool). Missing tools trigger an interactive brew install prompt on first use. Supported formats: .png .jpg .jpeg .gif (images) and .mp4 .mov .m4v (videos).

`shot` — screenshots

mac-cli shot                         # interactive picker (type to filter)
mac-cli shot -s                      # capture full screen
mac-cli shot -l                      # list running GUI apps with PIDs
mac-cli shot -p 1234                 # capture a specific app by PID

All screenshots land in ~/Desktop as PNGs. First run may prompt for the Screen Recording permission in System Settings → Privacy.

Claude Code agent skill

If you use Claude Code, install the companion agent skill so Claude can drive mac-cli for you — cleaning caches, taking app-specific screenshots, optimising media, and so on:

npx skills add luthebao/mac-cli

The skill assumes the mac-cli binary is already on $PATH, so install that first.

Build from source

git clone https://github.com/luthebao/mac-cli.git
cd mac-cli
make build                           # → build/mac-cli
make test
make install

Licensed under MIT.