GetMediaWall

mediawall-ui

A free, open-source shadcn/ui registry of React components for TV planning: screen size, seating distance and mount height over a console, with a to-scale wall elevation. Made by GetMediaWall; to plan the whole wall around the TV, try our Design Your Wall planner.

Live demo · Source on GitHub · MIT licence · React 19, Tailwind 4, shadcn/ui

The mediawall-ui planner block: a TV size card with a to-scale outline, a seating distance card with an in-range badge, and a mount height card with a wall elevation drawing
The tv-wall-planner block from the demo (real screenshot).

Install

In a project that already uses shadcn/ui, add any item by URL. The CLI also installs the card, input, label and badge primitives the components use.

npx shadcn@latest add https://getmediawall.github.io/mediawall-ui/r/tv-wall-planner.json
ItemWhat you get
tv-wall-plannerAll three cards laid out as one section (block)
tv-size-calculatorWidth and height from the diagonal (16:9, 21:9, 4:3), to-scale outline
seating-distanceTHX 40° to SMPTE 30° range, plus a verdict and ideal TV sizes for your own seat
mount-heightCentre, bottom and top edge over a console or mantel, with a wall elevation drawing
mediawall-plannerJust the maths: TypeScript, no dependencies

Use

import { TvWallPlanner } from "@/components/tv-wall-planner"
import { SeatingDistance } from "@/components/seating-distance"

<TvWallPlanner />
<SeatingDistance units="metric" defaultDiagonal={77} />

How the numbers are worked out

  • Size: width = diagonal × 16/√337, height = diagonal × 9/√337 for 16:9 screens.
  • Seating: from a 40° horizontal field of view (THX recommendation) to 30° (SMPTE EG-18 minimum).
  • Height: screen centre at seated eye height (42" by default). Over furniture, the centre is raised up to 4" to leave a 3" gap. If that is not enough, the card shows how far the TV still overlaps.

These are typical values. The TV and mount makers' instructions, and local building and electrical codes, always win. Prefer a pro? Find a TV installer near you.

Quality

Unit tests cover the maths. On every commit, CI installs each item into a fresh Next.js app with npx shadcn add and builds it.

Written with AI assistance (Claude) and tested by the GetMediaWall team. Related: django-mediawall for Django sites.