'%20/%3e%3cg%20clip-path='url(%23sq)'%3e%3crect%20x='100'%20y='100'%20width='824'%20height='824'%20fill='url(%23bg)'%20/%3e%3cpath%20d='M100,100%20L560,100%20L280,924%20L100,924%20Z'%20fill='%23FFFFFF'%20opacity='0.025'%20/%3e%3c!--%20TV%20--%3e%3crect%20x='380'%20y='190'%20width='500'%20height='320'%20rx='22'%20fill='url(%23metal)'%20/%3e%3crect%20x='398'%20y='208'%20width='464'%20height='284'%20rx='12'%20fill='%230C1219'%20/%3e%3crect%20x='398'%20y='208'%20width='464'%20height='284'%20rx='12'%20fill='url(%23on)'%20/%3e%3crect%20x='612'%20y='510'%20width='36'%20height='28'%20fill='%2366717E'%20/%3e%3crect%20x='520'%20y='538'%20width='220'%20height='18'%20rx='9'%20fill='url(%23metal)'%20/%3e%3c!--%20cable%20--%3e%3cpath%20d='M530,606%20C640,606%20618,560%20645,514'%20fill='none'%20stroke='%2300D4FF'%20stroke-width='14'%20stroke-linecap='round'%20filter='url(%23glow)'%20opacity='0.55'%20/%3e%3cpath%20d='M530,606%20C640,606%20618,560%20645,514'%20fill='none'%20stroke='%2300D4FF'%20stroke-width='12'%20stroke-linecap='round'%20/%3e%3ccircle%20cx='645'%20cy='512'%20r='9'%20fill='%237FE9FF'%20/%3e%3c!--%20MacBook%20--%3e%3crect%20x='150'%20y='470'%20width='380'%20height='250'%20rx='16'%20fill='url(%23alu)'%20/%3e%3crect%20x='166'%20y='486'%20width='348'%20height='218'%20rx='8'%20fill='%2310151C'%20/%3e%3crect%20x='166'%20y='486'%20width='348'%20height='26'%20rx='8'%20fill='%231D2632'%20/%3e%3ccircle%20cx='486'%20cy='499'%20r='5'%20fill='%2300D4FF'%20/%3e%3cpath%20d='M110,720%20L570,720%20L556,748%20Q554,752%20548,752%20L132,752%20Q126,752%20124,748%20Z'%20fill='url(%23alu)'%20/%3e%3crect%20x='306'%20y='720'%20width='68'%20height='8'%20rx='4'%20fill='%236B7684'%20/%3e%3c/g%3e%3c/svg%3e)
Your TVs, on the same schedule as your Mac.
On when you connect your display, off when you disconnect. No remote, no app switching, no thinking about it.
- LG webOS
- Roku TV
- Sony Bravia
- Samsung Tizen
Automation
It follows the display, not a schedule.
TV Companion watches for HDMI display changes and, optionally, Mac sleep and wake. Connect the display and the right TVs power on and switch to their input. Disconnect and they turn back off.
- Debounced display events, no false triggers
- Retries while the TV boots, re-sending Wake-on-LAN
- Follows IP changes by matching the TV MAC
Setup once
Pair a TV once, then forget it.
A first SSDP scan finds your TVs. Accept the pairing prompt on screen and the client key is saved to the Keychain. From then on each TV has a card with a status dot, a live on/off badge, and inline controls.
- Per-TV power, input, volume, and screen off
- Add a TV by IP if discovery misses it
- Credentials live in the login Keychain, never in config
Looks right
Fits your Mac, light or dark.
The panel is a native macOS surface. It tracks the system appearance, reads cleanly at a glance, and never opens a window you have to manage.
$ open ~/screenshots
A closer look
$ man tv-companion
Everything it handles
Small footprint, careful defaults, and no surprises.
-
Menu bar only
No Dock icon. It lives in the menu bar and stays out of the way after the first pairing.
-
Launch at login
Starts with your Mac through SMAppService, ready before the first HDMI connect.
-
Auto-discovery
Finds TVs on your network over SSDP and refreshes their IP and MAC on every scan.
-
Wake-on-LAN
Sends magic packets and retries while the TV boots, then switches to the right HDMI input.
-
Input guard
Only powers a TV off when it is still on your Mac's input, so it never cuts off other viewing.
-
All On / All Off
Flip every configured TV at once, or drive each one from its own card.
-
Native protocols
Each TV is driven in parallel over its own protocol: LG SSAP, Roku ECP, Sony Bravia, Samsung Tizen.
-
Clear feedback
macOS notifications report each result, and every card keeps its last error until the next success.
$ tv-companion --help
Before you install
Which TVs does it work with?
LG webOS, Roku TV, Sony Bravia, and Samsung Tizen. Each is driven over its own native protocol rather than a universal remote API, so power, input, and volume behave the way the TV expects.
Does it need anything installed on the TV?
No. Pairing happens once over the network, and the client key is stored in your login Keychain. The TV keeps its stock firmware.
Will it turn a TV off while someone else is watching?
Not by default. A TV is only powered off while it is still on your Mac's input, so switching the TV to another source takes it out of scope.
Does it run in the Dock?
No. It is menu bar only, starts at login through SMAppService, and opens no windows you have to manage.
More detail on the support page.
Set it up once. Never touch it again.
Quiet by design, and out of your way.