Skip to content
movena-appPublic

About

Private, cross-platform IPTV and VOD desktop player for Xtream Codes and M3U/M3U8, with XMLTV EPG, downloads, and native libmpv playback.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

22 stars

Watchers

1 watching

Forks

Latest commit

 

History

149 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Movena icon

Movena

A private, cross-platform IPTV and VOD desktop player for Xtream Codes and M3U/M3U8 playlists, with XMLTV EPG and native libmpv playback.

Latest release Verify workflow status Discord community GPL-3.0-or-later license Windows, macOS, and Linux

Download · Microsoft Store · Website · Discord · Report an issue · Support · Contribute

Important

Use official sources only. Movena is a free, open-source player. It does not sell or provide subscriptions, channels, playlists, or media. Download it only from this repository or the official website.

Note

Bring your own authorized content. Movena does not bypass DRM; use recording, catch-up, and download features only where you have permission.

Movena Discover workspace showcasing Dark and Light themes side-by-side with real metadata and TMDB artwork

Get started

  1. Download the latest Movena release for your desktop platform.
  2. Connect an authorized Xtream Codes account or add a local or remote M3U/M3U8 playlist.
  3. Browse Live TV, movies, series, and available programme guide data.

Movena keeps sources separate at the credential boundary while presenting their enabled channels, catalogues, categories, and guides in one workspace.

Features

Sources and playlists

  • Connect multiple Xtream Codes and M3U/M3U8 sources at the same time.
  • Load playlists from local files or remote URLs, with scheduled background refresh.
  • Fold duplicate quality tiers (4K, FHD, HD, RAW, HEVC) of the same live channel into a single entry with automatic stream failover.
  • Detect playlist XMLTV metadata or configure a per-source XMLTV override.
  • Set source-specific user-agent and referrer headers when required.

Live TV and programme guide

  • Browse provider or XMLTV guide data with now/next information and a timeline grid.
  • Search channels, organize categories, and move between channels without leaving playback.
  • Correct distorted 16:9 and 4:3 broadcast logos with smart aspect-ratio detection.
  • Play supported provider and M3U catch-up/archive programmes.
  • Use a dedicated audio-only interface for playlist entries marked as radio.

Movies, series, and discovery

  • Browse VOD catalogues, seasons, episodes, recently added media, and upcoming releases.
  • Search across Live TV, movies, and series, then filter and sort large catalogues.
  • Enable optional TMDB enrichment for localized posters, backdrops, and descriptions.
  • Track upcoming movie premieres and TV broadcasts with a monthly release calendar and live second-by-second countdowns backed by TMDB and TVmaze.

Native playback

  • Play video in-window through native libmpv rather than browser video decoding.
  • Configure GPU hardware decoding, demuxer buffer sizes (50–500 MiB), and automatic playback recovery.
  • Apply HDR-to-SDR tone-mapping algorithms (BT.2446a, Filmic, Reinhard, Mobius), real-time color controls, custom aspect ratios, and Side-by-Side 3D-to-2D conversion.
  • Customize subtitle styling (font size, color, background, outline, screen offset) and adjust audio/subtitle synchronization delays.
  • Skip chapter-marked or IntroDB-detected intros and recaps with on-screen prompts or hands-free auto-skip.
  • Auto-play next episodes with an interactive countdown and navigate seasons through the in-player drawer.

Library and offline use

  • Save favorites, custom collections, watch history, and Continue Watching progress locally.
  • Download movies and episodes with multi-threaded background transfers (1–8 parallel queues), pause, resume, retry, and file reveal.
  • Record live TV streams directly to the system Downloads folder with sandboxed path validation.

M3U workspace

  • Edit playlists through structured channel tables or the raw syntax-highlighted document.
  • Batch-clean titles, find and replace values, renumber entries, and manage categories.
  • Validate playlist syntax and probe stream health in the background without exposing connection secrets.
  • Undo and redo edits, recover local drafts, review changes, export copies, and restore saved versions.

Privacy and personalization

  • Keep passwords and connection secrets in the operating-system credential vault.
  • Use Movena without a project-operated account, advertising, analytics, or telemetry.
  • Choose English, German, Spanish, French, Italian, Dutch, Polish, or Brazilian Portuguese.
  • Customize accent, catalogue layout, motion, playback, subtitle, picture, and notification settings.
  • Export portable preferences without credentials, playlist URLs, history, favorites, or cached media.
  • Check for and install signed Movena updater packages from GitHub Releases.

Product tour

These are browser captures of Movena's production React pages, shared components, CSS modules, and application shell at 1440×900—not recreated mockups. The movie and series surfaces use real titles, factual TMDB metadata, and TMDB poster/backdrop artwork. Live TV uses real channel identities and official channel marks; programme times remain deterministic example XMLTV data. Provider accounts, stream URLs, downloads, and playback state use reserved .test fixture data. No commercial video is included.

Live TV catalogue Timeline programme guide
Movena Live TV catalogue with real channel identities and logos Movena timeline programme guide with real channels and example XMLTV scheduling
Movie details and playback actions Seasons and episode browser
Movena movie details showing real Dune Part Two metadata and TMDB poster artwork Movena series details showing Severance with its correct two seasons and 19 episodes
Upcoming release calendar Light appearance
Movena upcoming release schedule with live countdowns Movena Discover view in clean light appearance
VOD player controls Series playback & episode navigation
Movena native VOD player controls over a TMDB backdrop with timeline, chapters, and playback settings Movena series player with episode drawer and skip prompts
M3U visual channel workspace M3U raw syntax editor
Movena M3U editor with example channels, categories, filters, and stream-health status Movena M3U raw syntax editor with line numbers and editing controls
Download queue Source management
Movena downloads page with real movie titles and deterministic example transfers Movena source settings with a reserved example M3U library
Global library search Playback configuration
Movena global search returning a real movie title and example Live TV results Movena player and video settings for decoding, buffering, playback behavior, and subtitles

Download and platform support

Download the current packages from the latest release. Release assets also include a SHA-256 checksum file, an SPDX SBOM, GitHub build-provenance attestations, and updater signatures where applicable. Platform trust status remains explicitly disclosed below.

Platform Published packages Important notes
Windows x64 Microsoft Store, WinGet, NSIS .exe, .msi, portable .zip Microsoft Store / WinGet (winget install movena). Standalone NSIS and portable packages bundle libmpv.
macOS Apple Silicon .dmg (aarch64) Bundles its own mpv runtime, nothing else to install. Current builds are ad-hoc signed rather than Developer ID notarized.
macOS Intel .dmg (x86_64) Bundles its own mpv runtime, nothing else to install. Current builds are ad-hoc signed rather than Developer ID notarized.
Linux x64 .deb, .AppImage A compatible system libmpv and normal Tauri/WebKit desktop libraries are required. Install mpv through your distribution if necessary.

If installation or playback fails, search the existing issues before opening a new report. Never include credentials, playlist URLs, provider responses, or real viewing data in an issue.

Keyboard shortcuts
Area Shortcut Action
Navigation Ctrl/Cmd + 1–5 Open Home, Live TV, TV Guide, Movies, or Series
Navigation Ctrl/Cmd + K Open Search
Navigation Ctrl/Cmd + </kbd> Collapse or expand the sidebar
Help ? Show or hide the in-app shortcut guide
Playback Space or K Play or pause
Playback F Toggle fullscreen
Playback M Mute or restore volume
Playback ← / → Seek backward or forward during VOD playback
Playback ↑ / ↓ Adjust volume, or change channels when the live drawer is open
Playback Esc Close the active player menu, drawer, or player

Technology

Layer Technology
Desktop shell Tauri 2
Interface React, TypeScript, Zustand, and TanStack Query
Native core Rust
Playback libmpv

React owns presentation and client state; Rust owns native playback, credential storage, filesystem access, downloads, and native cache/network operations. See docs/ARCHITECTURE.md for the full boundary and repository map.

Build from source

You will need Node.js 20.19+, npm, Rust, the Tauri 2 prerequisites, and libmpv development/runtime files.

git clone https://github.com/movena-app/movena.git
cd movena
npm install

On macOS:

xcode-select --install
brew install mpv

On Windows, install Visual Studio C++ Build Tools and the Windows SDK, then provision the pinned development copy of mpv:

npm run setup:mpv

On Linux, install the Tauri prerequisites and your distribution's libmpv development package. Then start Movena:

npm run dev

Contributing

Contributions are welcome. Before submitting a change:

npm run check
npm run check:licenses

Every commit needs a DCO sign-off created with git commit -s. Please read Contributing guide, docs/ARCHITECTURE.md, and docs/DESIGN_SYSTEM.md before substantial changes. Project direction is documented in the roadmap.

Project information

Movena keeps app data local and operates no media proxy or project account. Read the privacy documentation and security policy for data handling and private vulnerability reporting.

Movena is licensed under GPL-3.0-or-later. Packaging and distribution requirements are documented in docs/RELEASING.md. See CHANGELOG.md for unreleased and tagged product changes. Third-party notices and asset provenance are in docs/THIRD_PARTY_NOTICES.md, THIRD_PARTY_LICENSES.txt, and docs/ASSETS.md. See the Code of Conduct and trademark guidance for community and branding terms.

About

Private, cross-platform IPTV and VOD desktop player for Xtream Codes and M3U/M3U8, with XMLTV EPG, downloads, and native libmpv playback.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

22 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages