Skip to content
View parallaxtv's full-sized avatar

Block or report parallaxtv

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ParallaxTV/README.md

ParallaxTV

ParallaxTV banner

A polished Jellyfin desktop experience built for modern media lovers.

ParallaxTV brings Jellyfin to the desktop with native MPV playback, a refined interface, and a focus on discovery, anime, and comfort-first viewing.

ParallaxTV hero preview


What's New in v0.1.1

Version 0.1.1 marks the moment ParallaxTV starts feeling like its own product rather than a collection of features. It brings a more cohesive UI, smoother navigation, and a stronger foundation for the desktop-first experience.

Highlights

  • A refreshed experience built around the new media-first layout
  • Better continuity across details, discovery, and playback flows
  • Improved polish for anime-focused browsing and recommendations
  • A stronger release identity for the project moving forward

Overview

ParallaxTV is a premium open-source Jellyfin desktop client focused on performance, beautiful design, and a modern streaming experience.

Built with Tauri, React, TypeScript, and MPV, ParallaxTV combines the flexibility of Jellyfin with the responsiveness and polish expected from modern streaming applications.

Unlike traditional browser-based clients, ParallaxTV uses native MPV playback to provide smooth playback of high bitrate media, anime, movies, and TV shows.


Why ParallaxTV?

Most Jellyfin clients feel like browser experiences wrapped in a shell. ParallaxTV is different.

It is designed for people who want Jellyfin to feel fast, immersive, and purpose-built for desktop use.

Experience Traditional web clients ParallaxTV
Playback Browser-dependent Native MPV playback
Interface Generic Tailored, modern, media-first
Anime support Basic Deep metadata and discovery
Desktop feel Secondary Primary design goal
Focus Compatibility Polish and experience

Features

Native MPV Playback

  • Native MPV player integration
  • Hardware accelerated playback
  • HEVC / H.265 support
  • High bitrate support
  • Direct Play support
  • Server transcoding support
  • Audio track switching
  • Subtitle switching
  • Playback speed controls
  • Fullscreen support

Smart TV Experience

  • Continue Watching
  • Up Next episodes
  • Watch History
  • Favorites
  • Resume playback
  • Episode progress tracking
  • Automatic playback reporting to Jellyfin
  • Smart playback resume

Anime Features

  • AniList integration
  • Anime discovery
  • Voice actor information
  • Anime recommendations
  • Trailer support
  • Anime cast pages
  • Enhanced anime metadata

Discovery System

  • Trending content
  • Recommended content
  • Because You Watched
  • Genre-based discovery
  • Similar content suggestions
  • Dynamic recommendation rows

Advanced Playback Features

  • Intro detection
  • Outro detection
  • Recap detection
  • Skip Intro
  • Skip Outro
  • Auto Skip
  • Next Episode countdown
  • Trickplay previews
  • Playback statistics overlay
  • Keyboard shortcuts overlay

Settings

  • Appearance settings
  • Playback settings
  • Discovery settings
  • Jellyfin settings
  • About page

Built With

Frontend

  • React
  • TypeScript
  • Vite
  • Zustand

Desktop Framework

  • Tauri v2

Playback Engine

  • MPV

Media Server

  • Jellyfin

Anime Metadata

  • AniList
  • Jikan

Backend Services

  • Cloudflare Workers
  • Cloudflare KV

Current Status

Version

v0.1.1

Development Status

ParallaxTV is actively developed and already provides a functional media experience.

The project is currently Alpha software and may contain bugs or unfinished features.

Expect:

  • Bugs
  • Missing features
  • UI refinements
  • Breaking changes between releases

Download

Prebuilt Windows builds are available through GitHub Releases.


Installation

Prerequisites

  • Jellyfin Server
  • Windows 10 or Windows 11
  • Node.js 20+
  • Rust
  • Tauri v2

Clone Repository

git clone https://github.com/parallaxtv/ParallaxTV.git
cd ParallaxTV

Install Dependencies

npm install

Development

npm run tauri dev

Production Build

npm run tauri build

Building from Source

Requirements

  • Windows 10 or Windows 11
  • Node.js 20+
  • Rust
  • Tauri v2
  • A Jellyfin server

Setup

git clone https://github.com/parallaxtv/ParallaxTV.git
cd ParallaxTV
npm install
npm run tauri dev

For a production build:

npm run tauri build

Development Notes

ParallaxTV is actively developed and is still evolving quickly. The current focus is on refining the overall experience, improving stability, and making the app feel more deliberate and cohesive across the full media flow.


Project Philosophy

ParallaxTV exists to make Jellyfin feel like a true desktop application again: fast, elegant, and intentional.

It is built for users who want a more immersive experience without sacrificing the flexibility of self-hosted media. The project is guided by a simple idea: media should feel beautiful, responsive, and effortless to enjoy from the first launch.


Roadmap

v0.1.x

  • Native MPV playback
  • Continue watching and up next
  • Favorites and discovery flows
  • Settings and playback improvements
  • Intro/outro skipping and overlays

v0.2.x

  • User profiles
  • Better search experience
  • Expanded viewing statistics
  • Improved recommendation engine

Future

  • Download manager
  • Offline playback
  • More discovery providers
  • Sync and cross-device features

Contributing

Contributions are welcome. If you have an idea, bug report, or improvement, open an issue or start a discussion.

Please include as much context as possible so the project can be improved effectively. Feedback from Jellyfin users, anime fans, and self-hosting enthusiasts is especially valuable as the project continues to grow.


Community and Feedback

ParallaxTV is built with the community in mind. If you are a Jellyfin user, anime fan, media server operator, or desktop app enthusiast, your feedback helps shape the direction of the project.

Please use GitHub Issues and Discussions to report bugs, share ideas, and help define what the experience should become next.


Support Development

If you enjoy ParallaxTV and want to support future development, consider supporting the project:

https://ko-fi.com/iitzmyung

Support helps fund development, testing, hardware, software licensing, hosting, and continued refinement of the experience.


Created By

ParallaxTV is created and maintained by iiTzMYUNG.


License

ParallaxTV is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

See the LICENSE file for full details.


Trademark Notice

The ParallaxTV name, logo, branding, artwork, and related assets are the property of the ParallaxTV project. Forks and derivative works should use a different name and branding if they are distributed publicly.


Acknowledgements

Special thanks to the Jellyfin team, the MPV project, the Tauri team, the React ecosystem, and the wider open-source community for making projects like this possible.


Disclaimer

ParallaxTV is an independent community project and is not affiliated with, endorsed by, or officially connected to the Jellyfin Project. Jellyfin is a trademark of the Jellyfin Project.


Made with ❤️ for the Jellyfin community.

Popular repositories Loading

  1. ParallaxTV ParallaxTV Public

    A premium native Jellyfin desktop client built with Tauri, React, TypeScript and MPV.

    TypeScript 23 1