GetMediaWall

mediawall CLI

An open-source command-line tool and Rust library for TV mounting and media wall jobs. Give it a TV size and a few room measurements and it prints the numbers an installer needs, plus a materials checklist.

What it calculates

  • Screen width and height of a 16:9 TV from its diagonal
  • The seating distance range for a 40° (THX) to 30° (SMPTE) horizontal field of view, and the field of view from your seat
  • Mount height: the bottom and top edges of the TV for a chosen centre height, and how far the TV stands off the wall for fixed, tilting and full-motion mounts
  • The recess (niche) rough opening when the TV is set into the wall
  • HDMI cable length rounded up to stock sizes (3–50 ft), and the cable count, with one extra for a soundbar
  • Slat-wall panels to order (24" × 96" panels, plus one spare)
  • A materials checklist with wall anchors for wood stud, metal stud, brick or concrete, and warnings

All lengths are in inches. The tool has no dependencies, needs no network access and sends nothing anywhere.

Install

From source (Rust 1.70+):

cargo install --git https://github.com/getmediawall/rust-mediawall

Fedora 43, 44, 45 and Rawhide, x86_64 and aarch64 (COPR):

sudo dnf copr enable getmediawall/mediawall
sudo dnf install mediawall

Usage

mediawall key=value ... [--json]

keys: tv_diagonal tv_depth eye_height seat_distance wall_width wall_height
      mount_type (fixed|tilt|full_motion) wall_type (wood_stud|metal_stud|brick|concrete)
      recessed niche_margin console_height console_offset hdmi_runs soundbar slat_wall

Example: a 75" TV, centre at 44", sofa 110" away, recessed into a brick wall, with a soundbar:

$ mediawall tv_diagonal=75 eye_height=44 seat_distance=110 recessed=1 wall_type=brick soundbar=1
75" TV: 65.4" x 36.8" screen
75" TV: sit 7.5-10.2 ft from the screen (40-30 degree field of view)
75" TV centred at 44": bottom edge 26" from the floor

Materials:
  1 x Fixed TV mount rated for the TV's weight and VESA pattern
  1 x Masonry sleeve anchors for brick  (Drill into solid brick, not the mortar joints.)
  1 x In-wall power relocation kit (recessed outlet behind the TV, inlet near the console)
  3 x HDMI cable, in-wall rated (CL2/CL3), 6 ft
  2 x Low-voltage mounting bracket (old-work) with brush wall plate
  1 x Pull string / flexible conduit for future cables
  1 x Framing for the recess, rough opening 69.4" x 40.8" x 4.5" deep
  1 x Soundbar bracket

Add --json to get the whole estimate as JSON, for scripts and quoting tools.

Library

use mediawall::Estimator;

let e = Estimator::from_pairs(&[("tv_diagonal", "65"), ("seat_distance", "96")]);
assert_eq!(e.tv_size_text(), "65\" TV: 56.7\" x 31.9\" screen");

Same numbers everywhere

The formulas match GetMediaWall's other open tools, so a quote prepared in one gives the same result in another:

Redmine pluginredmine_media_wall_estimator
Trac macrostrac_media_wall_estimator
phpBB BBCodesphpbb-media-wall-bbcodes
Craft CMS plugincraft-media-wall
Frappe / ERPNext appfrappe_media_wall
R packagemediawall-r

Source, issues and license

Source code and issue tracker: github.com/getmediawall/rust-mediawall. License: MIT. Contact: team@getmediawall.com.

The tool was written with an AI assistant (Claude) and is checked with unit tests against the GetMediaWall reference estimator. Results are planning estimates: always follow the mount and anchor maker's instructions and your local building and electrical codes, and never run a TV power cord inside a wall.

To lay out the whole wall visually (TV, console, fireplace, slats), use the free Design Your Wall planner.