FreeX

Self-hosted · Open source · No cloud

Your Media.
Your Server.
Your Freedom.

FreeX turns your folders of movies and TV shows into a library with artwork and details – on your own hardware. One server, apps for every screen in the house, and all of them remember where you stopped. No third-party account, no cloud, no telemetry.

FreeX Web: home screen
The home screen with Continue watching, Up next and Recently added.

Everything a media server should do.

FreeX Media Server is one small native program without a runtime. It comes with the web client FreeX Web built in – all you need is a browser.

A beautiful library

Poster grids, collections, playlists, a watchlist and search. The home screen shows what you're watching and what's up next.

Plays everything

Directly when the device can decode the file – otherwise the server converts it on the fly with ffmpeg, optionally with hardware acceleration (NVENC, Quick Sync, VAAPI).

Metadata, even offline

Artwork and details from TMDB – or fully offline from Kodi .nfo files and local artwork.

Skip intro and credits

Detected automatically from the audio, with a countdown to the next episode.

For the whole household

Multiple users with their own progress, history, profile picture and preferred audio and subtitle language. Share all libraries or only some.

Watch Together

Watch in sync with other users of your server – wherever they are.

Secure by default

Two-factor sign-in, brute-force protection, per-device sessions and strict security headers.

Managed in the browser

Libraries, users and every server setting, a live activity view, CPU and memory graphs and the server log.

Your media stays with you

FreeX runs on your server, your NAS or your PC. There is no FreeX account, no cloud in between and no telemetry. Your files are only read – FreeX never deletes or changes anything on disk.

One family for every screen.

Every app talks to the same server with the same account. Progress, Continue watching and settings follow you from device to device.

The core

FreeX Media Server

Libraries, users, streaming, conversion and the API – with the web client FreeX Web for every modern browser.

LinuxWindowsAPT repository

Freex-Media-Server

FreeX TV

A home screen and player made for the remote, using the TV's own player.

Samsung (Tizen)LG (webOS)Fire TVAndroid TV

FreeX-TV-Apps

FreeX Mobile

A player made for touch: double tap to jump, picture in picture, and AirPlay on iOS.

iPhoneiPadAndroid phones and tablets

FreeX-Mobile

FreeX Desktop

FreeX Web in its own window, playing every file directly with mpv. With a TV mode that turns the PC into a FreeX box on the TV.

WindowsLinuxmacOS

Freex-Desktop

FreeX for Kodi

Your libraries like a Kodi library, played with Kodi's own player – including skip intro and Up Next.

Kodi 20+LibreELECCoreELECRaspberry Pi

FreeX-Kodi-Addon

FreeXHT

A system image: the box boots straight into the FreeX TV interface, with mpv as player and the TV remote over HDMI-CEC.

Raspberry Pi 4 / 5PC (x86_64)

FreeX-HT
FreeX for Kodi: a show page with Resume S1 E1
FreeX for Kodi
FreeX for Kodi: a library with filters
A library with filters in Kodi

Even more ways to watch.

Jellyfin apps

With the optional Jellyfin layer, apps such as Swiftfin and Streamyfin (iPhone, iPad, Apple TV), Findroid (Android) and Jellyfin for Android TV use your FreeX server – with the same account and progress. On Apple devices this is the recommended way.

DLNA

Smart TVs, consoles and players in the home network find the server on their own – no app needed.

Chromecast

Cast from Chrome to the TV, with the browser as remote control.

FreeX Mobile for iPhone and iPad and FreeX TV for Samsung and LG are not in the app stores and can only be installed by sideloading. Without sideloading, use a Jellyfin app on Apple devices and DLNA on Samsung TVs.

Download

Start with the server. Then sign in from any FreeX app – enter the address (e.g. 192.168.1.10, port 32500) and you're done.

FreeX Media Server

Debian 12+ / Ubuntu 22.04+

From the MirraNET package repository – ffmpeg comes along, updates arrive with sudo apt upgrade.

sudo install -d /etc/apt/keyrings
sudo curl -fsSL https://apt.mirranet.de/mirranet.gpg \
    -o /etc/apt/keyrings/mirranet.gpg
echo "deb [signed-by=/etc/apt/keyrings/mirranet.gpg] https://apt.mirranet.de stable main" \
    | sudo tee /etc/apt/sources.list.d/mirranet.list
sudo apt update && sudo apt install freex-media-server

Then open http://<your-server>:32500/, create the admin account and add your movie and TV show folders.

Windows 10 / 11

The installer brings ffmpeg along, sets up a Windows service and opens the web interface when it's done.

Download setup

The installer isn't code-signed yet. If Windows shows “Windows protected your PC”, click More info and then Run anyway.

Apps

FreeX Desktop

FreeX TV

  • Fire TV / Android TV.apk
  • Samsung (Tizen).zip
  • LG (webOS).ipk

FreeX for Kodi

In Kodi: Settings › Add-ons › Install from zip file.

FreeXHT

Write it to an SD card or USB stick with Raspberry Pi Imager or balenaEtcher. On a Pi 3 the interface is noticeably laggy.