Free public beta
Install MediaCove on your computer and TV.
You need MediaCove Server on a Windows, Linux, or macOS computer and a MediaCove TV client on the same trusted home network. LG webOS is the current downloadable TV target. Samsung Tizen is an emulator-tested development preview.
Current release: 1.3.14. Windows has a guided x64 installer. Linux and macOS share a portable x64/ARM64 package that requires Node.js 22.x plus FFmpeg and ffprobe. Other Node.js major versions are not supported.
Open Server Control → Settings → Google settings to manage your Google account, cache budget, and saved episodes. Use Cache episode in the Library to save episodes with their preferred subtitles. Drive storage usage updates automatically, and sign-in is only requested when needed. Google setup is optional and happens on the computer. TV playback prefers the LAN. After updating both apps, connect once to save the ready cloud-copy catalog. When the computer is unavailable, Cached episodes streams those copies directly from Google with internet access. The TV reconnects automatically; Google delivery remains experimental.
Samsung status: MediaCove's shared TV client, remote handling, exit flow, lifecycle adapter, signing, installation, launch, and basic H.264/AAC HLS playback pass on the Tizen 10 Samsung TV emulator. Experimental physical-TV Developer Mode instructions are now included below, but they have not been verified on Samsung hardware. There is no universal public Samsung WGT or physical-TV support claim; Samsung packages must be signed for the intended target.
Direct downloads
Windows server installation
- Download the installer. Use the Windows link above and save
MediaCove-Server-1.3.14-Windows-x64.exe.
- Optionally, verify it. Download
SHA256SUMS.txt, open PowerShell in the download folder, and run:
Get-FileHash .\MediaCove-Server-1.3.14-Windows-x64.exe -Algorithm SHA256
The result must be ddb729fc0765fb20de0b2eb8463137c34667d8637b7ca6820876307515b44baa.
- Run setup. The beta installer is currently unsigned, so Windows may show an unknown-publisher warning. Confirm that the filename is correct, then continue. On a clean installation, keep the recommended Media tools task selected so setup can install FFmpeg through Microsoft WinGet. On upgrades, setup omits the FFmpeg and sign-in startup choices when they are already configured and ready.
- Open MediaCove. Setup keeps the MediaCove icon in the notification area beside the clock. Double-click it, or right-click and select Open MediaCove, to open Server Control. Right-click and select Exit MediaCove to stop the server and close the icon; open MediaCove from the Start menu to start both again.
- Optional: allow your local LAN through Windows Firewall. Skip this step if the TV connects normally. If Windows blocks the helper script, open PowerShell as Administrator and run it with a one-time execution-policy bypass. This does not change the system policy:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\allow-tv-firewall.ps1
The helper allows TCP port 32480 from the 192.168.0.* subnet. Alternatively, run the direct New-NetFirewallRule command below.
New-NetFirewallRule -DisplayName "MediaCove LAN 192.168.0.0/24" -Direction Inbound -Protocol TCP -LocalPort 32480 -RemoteAddress 192.168.0.0/24 -Action Allow -Profile Private
If your home LAN uses another subnet, replace 192.168.0.0/24 with that subnet. Do not expose port 32480 through the router.
Linux server installation
Install Node.js 22.x, npm, FFmpeg, and ffprobe. MediaCove does not support other Node.js major versions. On Debian or Ubuntu:
sudo apt update
sudo apt install -y ffmpeg
node --version
npm --version
ffmpeg -version
ffprobe -version
node --version must begin with v22.. If the distribution package installs another major version, install Node.js 22 from the official archive linked above.
- Download the portable archive from the link above.
- Optionally, verify it. Download its checksum, open a terminal in the download directory, and run:
sha256sum -c MediaCove-Server-1.3.14-Linux-macOS-Portable.tar.gz.sha256
- Extract it into a permanent location and install the native dependencies:
tar -xzf MediaCove-Server-1.3.14-Linux-macOS-Portable.tar.gz
cd MediaCove-Server-1.3.14-Linux-macOS-Portable
npm install --omit=dev
- Stop any previous MediaCove user service, then start this copy in the foreground:
systemctl --user stop mediacove.service 2>/dev/null || true
npm run start
Open http://localhost:32480. Press Ctrl+C after confirming it works.
- Install current-user automatic startup:
sh scripts/install-unix-service.sh
MediaCove then appears in the desktop application menu. Open it normally
to start the server and open Server Control, or use its
Stop MediaCove Server action. Remove the service and
launcher later without deleting library data with
sh scripts/remove-unix-service.sh.
- Optional security: If UFW is enabled and blocks the TV, allow the local private subnet. Skip this step when the TV already connects:
sudo ufw allow from 192.168.0.0/24 to any port 32480 proto tcp
macOS server installation
Install Homebrew if needed, then install Homebrew's versioned Node.js 22 formula, FFmpeg, and ffprobe. Do not use brew install node: the unversioned formula currently installs an unsupported newer Node.js major version.
brew install node@22 ffmpeg
echo 'export PATH="$(brew --prefix node@22)/bin:$PATH"' >> ~/.zprofile
export PATH="$(brew --prefix node@22)/bin:$PATH"
node --version
npm --version
ffmpeg -version
ffprobe -version
node --version must begin with v22. before continuing.
- Download the portable archive from the link above.
- Optionally, verify it. Download its checksum, open Terminal in the download directory, and run:
shasum -a 256 -c MediaCove-Server-1.3.14-Linux-macOS-Portable.tar.gz.sha256
- Extract it into a permanent location and install the native dependencies:
tar -xzf MediaCove-Server-1.3.14-Linux-macOS-Portable.tar.gz
cd MediaCove-Server-1.3.14-Linux-macOS-Portable
npm install --omit=dev
- To enable automatic captions, install Homebrew's native
whisper-cpp runtime and MediaCove's verified models:
npm run captions:install
This downloads about 785 MB and stores the models under ~/Library/Application Support/MediaCove/whisper.
- Stop any previous MediaCove LaunchAgent, then start this copy:
launchctl bootout "gui/$(id -u)/com.mediacove.server" 2>/dev/null || true
npm run start
Open http://localhost:32480, and allow incoming connections on the private home network if macOS asks.
- After the first check, stop the foreground process and install the current-user LaunchAgent:
sh scripts/install-unix-service.sh
This also creates ~/Applications/MediaCove.app. Double-click
it to start the server and open Server Control, or drag it to the Dock.
Configure the server
- Open http://localhost:32480 on the server computer. Administration is deliberately limited to that computer.
- Create the free beta household account and save its recovery key somewhere private, or connect with an existing recovery key.
- Under Media folders, choose or enter an absolute folder containing your videos, select Add folder, then select Scan library.
- Confirm the dashboard reports FFmpeg and ffprobe as ready. Leave MediaCove running while using the TV.
- Do not expose port
32480 through router port forwarding. MediaCove is for a trusted private LAN.
Install the LG TV app
Developer Mode is temporary. LG removes sideloaded apps when the Developer Mode session expires. Use EXTEND in the TV's Developer Mode app before the timer reaches zero.
- Create or sign in to an LG Developer account.
- On the TV, install Developer Mode from LG Apps. Open it, sign in, enable Dev Mode Status, and let the TV reboot. LG's official walkthrough is here.
- On the computer, install Node.js 22.x and npm if they are not already available, then install LG's official webOS CLI:
npm install -g @webos-tools/cli
ares -V
- Find the TV IP in its network settings. Run
ares-setup-device, choose add, and enter:
Name: myTV
IP: your TV IP address
Port: 9922
User: prisoner
Password: leave empty
Profile: tv
- In Developer Mode on the TV, enable Key Server. Retrieve the key and enter the six-character passphrase displayed by the TV:
ares-novacom --device myTV --getkey
ares-device --system-info --device myTV
- Download
MediaCove-TV-1.3.14.ipk using the direct link above. Open a terminal in its download folder, install it, and launch it:
ares-install --device myTV ./MediaCove-TV-1.3.14.ipk
ares-launch --device myTV com.mediacove.app.tv
Samsung Tizen development preview
Experimental on physical TVs. The Tizen 10 emulator is verified. Samsung's official Developer Mode workflow should also install MediaCove on a compatible physical Tizen TV, but MediaCove has no Samsung hardware test result. Do not expect an existing WGT to install on another target: Samsung distributor signing must authorize the intended emulator or TV DUID.
Install the Samsung development tools
- Install Tizen Studio, the Samsung TV Extension, Web CLI, Certificate Manager, and Samsung Certificate Extension.
- Use either a Samsung TV emulator or the physical-TV connection steps below. Tizen 10 is the currently verified MediaCove target.
- Create a private Samsung > TV certificate profile containing the connected target's DUID. Keep certificate files, passwords, DUID lists, and
profiles.xml outside source control.
- From an authorized MediaCove source checkout using Node.js 22.x, build and validate the shared Samsung wrapper:
pnpm build:tv
node scripts/package-samsung-tv.mjs --prepare-only
- Build, sign, install, and launch with your own profile and the exact serial from
sdb devices:
node scripts/package-samsung-tv.mjs --profile YourSamsungProfile ^
--target emulator-26101 --install --run
In PowerShell, replace ^ with a backtick or put the command on one line.
Connect an experimental physical TV
- Update the TV firmware. Put the Samsung TV and development computer on the same trusted home network, and record both LAN IPv4 addresses.
- On the TV open Smart Hub > Apps > App Settings, enter
12345, enable Developer mode, enter the computer's LAN IPv4 address, and reboot. If Samsung Instant On is enabled, disconnect and reconnect TV power during this reboot.
- In Tizen Studio open Tools > Device Manager > Remote Device Manager, add the TV's LAN IPv4 address, and switch the connection on. If needed, run
sdb connect <TV-IP>, then sdb devices.
- In Device Manager, right-click the connected TV or its filesystem and select Permit to install applications.
- In Certificate Manager create a Samsung TV author certificate and distributor certificate. Add the connected TV's DUID with the + control. Samsung also documents the DUID under Menu > Support > Contact Samsung > Unique Device ID.
- Run the package command above, replacing
emulator-26101 with the exact TV serial reported by sdb devices, which can resemble 192.168.1.50:26101.
- Keep MediaCove Server running and allow private-LAN TCP port
32480. On the TV, connect using automatic discovery or the computer's LAN IPv4 address. Enter the optional management password from http://localhost:32480, or leave it blank when none is configured.
- For screenshots and more troubleshooting, read the official Samsung TV connection guide, certificate guide, and MediaCove Samsung preview guide.
Connect and verify
- Keep the server and TV app running on the same network.
- Optionally create one management password under Remote management on the server dashboard.
- On the TV, leave Host/IP blank for automatic discovery, enter that password if configured, and select Connect.
- If discovery fails, enter the server computer's private LAN IP manually. Confirm both devices use the same network, Wi-Fi client isolation is disabled, and, if you added the optional firewall rule, it includes the TV's current subnet (the Windows default is
192.168.0.0/24).
- If the library opens but playback reports that server access is inactive, open Server Control > MediaCove account on the computer. Create free beta access and save its recovery key, or connect with an existing key, then select Refresh status. Connecting and browsing can work while stream creation is blocked.
- Open a movie and test play, pause, ±10-second seeking, subtitles, and resume.
Current beta limitations
- The Windows installer and Unix portable archive are not code-signed.
- The Unix package does not bundle Node.js, FFmpeg, Whisper, or automatic-caption models; its caption installer downloads the optional runtime and models when requested.
- The TV IPK remains a temporary Developer Mode package until LG Content Store approval.
- Samsung Tizen support remains an emulator-tested development preview. The physical-TV Developer Mode path is unverified, and no universal public WGT or physical-TV compatibility claim is available.
- Free beta access is temporary and governed by the beta terms.