Skip to content
sormyPublic

About

TVBian — Debian-based Linux for TV boxes

Resources

Stars

8 stars

Watchers

1 watching

Forks

Repository files navigation

TVBian — Debian for TV boxes

Latest release Released Weekly build

You bought a cheap Android TV box. It is silent, fanless, came with a remote, and runs an Android its maker forgot the day after it shipped. The hardware deserves better than a landfill next year. TVBian is the better: plain Debian, our own kernels and drivers, a signed apt repository, and a robot that builds fresh images every week whether anyone asked or not.

Images: the latest release. Checksums signed, because we have trust issues too.

Boards

Board PCB Form Hardware* Install
R69-1 XR821_V1.1 box SoC RK3518 · 2 GB RAM LPDDR3 (1.5 GB usable) · 16 GB eMMC HS200 · SD HS · USB-A 3.0 (OTG) + USB-A 2.0 · LAN 100M · AIC8800D80 Wi-Fi + BT · HDMI · AV · IR SD or OTG
↳ T8S R69MAX V1.1 box SoC RK3518 · 2 GB RAM LPDDR3 (1.5 GB usable) · 8 GB eMMC HS200 · SD HS · USB-A 3.0 (OTG) + USB-A 2.0 · LAN 100M · AIC8800D80 Wi-Fi + BT · HDMI · AV · IR SD or OTG
H96 Max 3518 3518_ZX_V01 box SoC RK3518 · 2 GB RAM LPDDR3 · 16 GB eMMC HS200 · SD UHS-I · USB-A 3.0 (OTG) + USB-A 2.0 · LAN 100M · SWT6621S Wi-Fi + BT · HDMI · AV · IR SD or OTG
↳ Leffot H313 3518_ZX_V01 box SoC RK3518 · 2 GB RAM LPDDR3 · 16 GB eMMC HS200 · SD UHS-I · USB-A 3.0 (OTG) + USB-A 2.0 · LAN 100M · SWT6621S Wi-Fi + BT · HDMI · AV · IR SD or OTG
H96 Max 3518D 3518_DG_ZX_V01 stick SoC RK3518 · 2 GB RAM LPDDR3 · 16 GB eMMC HS · no SD · USB-C 2.0 (OTG) + USB-A 2.0 · no LAN · SWT6621S Wi-Fi + BT · HDMI OTG
H96 Max M2 Plus M2_P_ZX_20250328 box SoC RK3528 · 4 GB RAM DDR3 · 32 GB eMMC HS200 · no SD · USB-A 3.0 (OTG) · LAN 100M · SWT6621S Wi-Fi + BT · HDMI · AV · IR OTG
H96 Max RK3528 ❓ RK3528_DDR3_8X4_V12 box SoC RK3528 · 4 GB RAM DDR3 · 64 GB eMMC HS400 · SD UHS-I · USB-A 3.0 (OTG) + USB-A 2.0 · LAN 100M · AIC8800D80 Wi-Fi + BT · HDMI · AV · SPDIF · IR · LCD SD or OTG
H96 Max M20 905_DG_ZX01_V01 stick SoC S905L3 · 2 GB RAM LPDDR3 · 16 GB eMMC HS · no SD · USB-C 2.0 (OTG) + USB-A 2.0 · no LAN · MT7668S Wi-Fi + BT · HDMI OTG
Tanix TX1 V2.0 QHZIW_H313_TX1_EMCP_V2.0 mini box SoC H313 · 1.5 GB RAM LPDDR3 (sold as 2 GB) · 16 GB eMMC DDR52 · no SD · USB-A 2.0 (OTG) · no LAN · ATBM6031-X Wi-Fi + BLE · HDMI · AV · IR OTG
H96 Max H313 BA979_627_V1.0 box SoC H313 · 2 GB RAM LPDDR3 · 16 GB eMMC HS200 · SD HS · USB-A 2.0 (OTG) + USB-A 2.0 · LAN 100M · AIC8800D40L Wi-Fi + BLE · HDMI · AV · IR SD or OTG

*What our units carry; the same model may ship with other RAM or eMMC. Any size works.

❓ Not tested here: built from the box's stock firmware, waiting for an owner's report.

Click the install method for its family's guide: what works, installing, updating, and getting Android back when regret sets in. OTG is a USB-A male-to-male cable into the box's OTG port, the one port that turns a TV box into a patient on the operating table. Host: macOS or Linux. Windows users: we believe in you, from a distance.

Will it brick my box?

We try hard not to: the installer leaves alone what recovery needs. Running from an SD card writes nothing to the eMMC and needs no backup; before anything is written there, back up first. Each family's guide says how.

Worst case, the box is not dead, just expensive: short the eMMC's CLK trace at power-on and the boot ROM listens again, if you can find the trace. One R69 still hides it, after Armbian's installer gave it another board's loader. TVBian's installer writes only the loader for the board you picked, and apt refuses a board package for another chip family. Pick the right one anyway.

Your box is not here

Box names lie. "H96 Max" is not a box, it is a lifestyle: hundreds of boards, several chips, one case. Ours had "H313" on the label and a Rockchip inside. A box is the board, and a board is its chips and layout, whatever its silkscreen says, so open it.

Adding one is a pull request, and an agent does most of the work. You bring an OTG cable and the patience to press a toothpick into a hole on command; a serial adapter helps on a new family, and when a box will not boot, so the failure is not blind: docs/bring-up/README.md.

Which model, as of 2026-11-09. Not an advert, what we saw. A new family, a new chip, or a vendor tree translated to mainline: Anthropic's Opus, even at low effort. OpenAI's Codex (Sol) copied other boards' translated trees wholesale instead of translating this one's. Grok's results could not be trusted.

Contributing

All welcome:

  • a new family, or a new board of one we have, by pull request;
  • a fix to a kernel, a driver, or a board's device tree wiring, by pull request;
  • a box measured: what works, what does not, with the numbers;
  • photos of a box, its label and both sides of its board, its stock dump or the vendor's firmware where there is one: enough for a blind bring-up, and you test the image when it is ready.

One fix a patch, written as if Linus himself will review it: ask your AI to write it that way. A separate place in heaven is kept for whoever has the patience to walk one through upstream review until it merges.

Built on and inspired by

  • Debian: the system every box runs, and the base of hundreds of distributions: the gold standard.
  • Armbian: a distribution for boards, run by its community; its process does not scale to the hundreds of TV boxes.
  • ophub: Armbian for hundreds of TV boxes, proof they are worth running Linux on.
  • juliovendramini/rk3518_armbian: a small README that brought up the first RK3518 box, and where this project started.

License

Scripts MIT, LICENSE. Device trees are decompiled from each box's factory DTB; vendor blobs keep their own licenses, and their own secrets.

About

TVBian — Debian-based Linux for TV boxes

Resources

Stars

8 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages