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 plugin | redmine_media_wall_estimator |
| Trac macros | trac_media_wall_estimator |
| phpBB BBCodes | phpbb-media-wall-bbcodes |
| Craft CMS plugin | craft-media-wall |
| Frappe / ERPNext app | frappe_media_wall |
| R package | mediawall-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.