Media Centre

One remote for your whole home. Control your TVs, air conditioners, lights, heating, Echo and Ring devices room by room, and play the films, shows and music on your PC or NAS on any TV, from any phone, tablet or computer on your home network. It runs on your own Hub, with no account.

Website: media-centre.adrianeyre.co.uk · Code: github.com/adrianeyre/media-centre

• The Hub is the always-on process, on a PC or in Docker on a NAS, that serves the Remote, controls every Appliance and serves Media Files to the Player.
• The Remote is the web app you use from any phone, tablet or computer on the home network: a tab each for the TVs, air conditioners, lights, heating, the network, Amazon Echos, Ring doorbells and Rooms, and Settings. It meets WCAG 2.2 at Level AA, in light and dark, and installs to a home screen.
• The Player is the app the Hub installs on each Samsung TV to play your films, shows and music.

Screenshots

All screenshots show demo Rooms and the project's fake Appliances, not a real home. pnpm screenshots takes them again, in Docker. The website shows the same tabs, and illustrations of the Remote at work.

Air conditioners	Lights
Heating	Rooms and the floor plan
The network	Amazon Echo
Ring	Settings

Dark mode

TV	Rooms

On a tablet

On a phone

Quick start

You need Node 26 or later, pnpm 12, and ffmpeg with ffprobe on the PATH.

pnpm install
pnpm start        # builds the Remote and starts the Hub on http://localhost:41080

Then open http://localhost:41080 in a browser. To run the Hub in Docker on a NAS, see Getting started.

The website

The project's website, media-centre.adrianeyre.co.uk, is site/: one static page, published to GitHub Pages by .github/workflows/pages.yml when it changes on main. Its illustrations of the Remote, the hero and the feature tiles, are drawn in React with the Stageshow kit, in site/stage/, in the Remote's own colours, light and dark; without JavaScript the page shows the screenshots instead.

pnpm site:build                                # builds the illustrations, then the website, in site/dist/
pnpm --filter @media-centre/site scenes:dev    # every illustration on one page, while drawing them

Documentation

Guides

• Getting started: what you need, running the Hub on a PC or a NAS, its settings and the network
• The Player and playback: installing the Player on a TV, Routes, subtitles, music, Queues and Resume Positions
• Air Conditioners: the Midea Driver, adding units in Settings and the Aircon tab
• Lights: the Lepro Driver, adding Lights, the Lights tab, Light Scenes and a TV's film Light Scene
• Heating: the Hive Driver, signing in to Hive and the Heating tab
• Rooms and the floor plan: the Rooms tab, naming places on the floor plan, and drawing the plan on your own image
• The Network tab: every device on the home network and every Bluetooth device near the Hub, who made it, its open ports, and naming each
• The Amazon tab: every Echo on your Amazon account, with everything the Alexa app allows, through Amazon's cloud
• The Ring tab: your Ring doorbell, cameras and chimes, with snapshots, live video, events and recordings, through Ring's cloud
• Versions and releases: update notices, the Changelog and semantic-release
• Testing: the gate that must pass before work lands
• The fake Appliances: the fake Samsung TV, Midea Air Conditioner, Midea cloud, Lepro Light and Hive cloud

This is the beginning of the README. Read the rest at the original. Read the full README ↗