GetMediaWall

django-mediawall

A free, open-source Django app for TV-mounting and media-wall installers. It covers your price list, a customer quote form, itemised quotes with PDF, a drag-and-drop job board and printable job sheets. It also puts TV size, seating distance and mount height into any template. Made by GetMediaWall; to plan the whole wall around the TV, try our Design Your Wall planner.

Source on GitHub · MIT licence · version 2.0 · Django 4.2 LTS, 5.2 LTS, 6.0, 6.1 · Python 3.10–3.14

Quotes, jobs and job sheets for installers

Add django_mediawall.quotes to a Django site and the flow runs from a customer's request to a finished install:

  1. The customer fills in the request form: TV size, mount, wall type, cable concealment, console height and slat wall width.
  2. The quote is priced from your price list: the mount, large-TV and masonry surcharges, cable concealment, slat panels, a labour estimate and travel. The customer gets an itemised estimate and a PDF right away.
  3. You edit the lines, mark the quote as sent, and the customer accepts or declines it from a private link.
  4. An accepted quote becomes a card on the job board (New, Scheduled, In progress, Done).
  5. Each job has a job sheet for the crew: screen size, screen centre and edge heights over the console, how far the TV sits off the wall, the anchors for that wall type, the slat panel count, a site checklist and a signature line.
The django-mediawall quote screen: priced lines with tax and total, on-site facts for a 77-inch TV, and the edit form
The quote screen in the demo project (real screenshot).
The django-mediawall job board with New, Scheduled, In progress and Done columns
The job board: drag cards between columns or use the arrows.
pip install "django-mediawall[pdf] @ git+https://github.com/getmediawall/django-mediawall@v2.0.0"

# settings.py
INSTALLED_APPS = [..., "django_mediawall", "django_mediawall.quotes"]
MEDIAWALL_COMPANY = {"name": "Your company", "phone": "555-0100"}
MEDIAWALL_TAX_RATE = "8.25"

# urls.py
path("install/", include("django_mediawall.quotes.urls")),

# then
python manage.py migrate
python manage.py mediawall_demo_data   # a starter price list to edit in the admin

The labour estimate starts at 1.5 hours. It adds time for full-motion mounts, masonry or metal studs, cable concealment, 75-inch and larger TVs and each slat panel, then rounds up to the quarter hour. Override any value with MEDIAWALL_LABOUR_HOURS. The starter prices are placeholders; set your own in the admin.

TV size, seating and mount height tools

A Django demo page: TV sizes in running text, a size table and two summary cards, all generated by django-mediawall template filters and tags
The demo project that ships with the app (real screenshot).

Who it is for

Home-theater blogs, AV installers, TV retailers and smart-home sites built on Django or Wagtail. Instead of copying numbers from a chart, write {{ 65|seating_range }} and the page shows 6.5–8.8 ft.

Install

pip install git+https://github.com/getmediawall/django-mediawall@v2.0.0
# settings.py
INSTALLED_APPS = [..., "django_mediawall"]

# urls.py (optional calculator page)
path("tv-planner/", include("django_mediawall.urls")),

Template filters

{% load mediawall %}
{{ 65|tv_width }}            → 56.7   (inches, 16:9)
{{ 65|tv_height }}           → 31.9
{{ 65|seating_range }}       → 6.5–8.8 ft
{{ 9|tv_size_for_seat }}     → 66–90  (inches, for a 9 ft seat)
{{ 65|mount_center }}        → 42.0   (screen centre from the floor)
{{ 65|mount_center:24 }}     → 42.9   (over a 24" console)
{{ 65|tv_width|in_to_cm }}   → 144.0
{{ 65|seat_max_ft|ft_to_m }} → 2.7

Filters never raise: a typo in a CMS field renders as an empty string, the same convention as Django's built-in filters.

Tags

{% mediawall_card 65 seat_ft=8 furniture_top_in=24 %}
{% mediawall_card 77 seat_ft=10 metric=True %}
{% viewing_plan 65 seat_ft=12 as v %}{{ v.verdict }} {{ v.field_of_view_deg }}°
{% mount_plan 75 furniture_top_in=30 mount_type="tilt" as m %}{{ m.center_in }}

Calculator page

django_mediawall.urls adds a read-only GET form; nothing is stored. Set MEDIAWALL_BASE_TEMPLATE to your site's base template (it needs a content block).

The django-mediawall calculator page for a 65-inch TV on a tilting mount over a 24-inch console

Python API

from django_mediawall import planner
planner.screen_size(65)
planner.viewing_distance(65, 9 * 12)
planner.mount_height(65, furniture_top_in=24, mount_type="tilt")
planner.vesa_check("400x300", 60, mount_max_pattern="600x400", mount_max_weight_lb=100)
planner.wall_anchor_notes("brick")
planner.cable_length(96, cables=2)

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. Above 50" the app warns about neck strain.

These are typical values. The TV and mount makers' instructions, and local building and electrical codes, always win. If you'd rather not do it yourself, find a TV installer near you.

Changelog

2.0.0 (18 November 2026): installer quotes, PDF estimates, job board and job sheets (django_mediawall.quotes).
1.0.0 (18 November 2026): first release. See the full changelog.