Pelagica

Pelagica is a web and desktop client for Jellyfin built using React. It aims to provide a fast, modern, and customizable user experience for browsing and watching your media library. It's available both as a self-hosted web app and as a native desktop app for macOS, Windows, and Linux.

Table of Contents

• Features
• Web Demo
• Web Installation
• Desktop App
• Discord
• Localization
• Development Setup
• Contributing
• What does that name mean?
• Acknowledgements
• Disclaimer
• License

Features

• Customizable Sections: Tailor your homepage with sections like "Continue Watching", "Recently Added", or completely custom queries.
• Media Bars: Add custom media bars to feature specific content.
• Search: Quickly find media across your library from anywhere using Cmd+K / Ctrl+K.
• Video Player: Integrated video player for movies and TV shows.
• Music Player: A music player that allows you to listen to your music albums or playlists while browsing your library.
• Responsive Design: Works seamlessly on both desktop and mobile devices.
• Desktop App: Native apps for macOS, Windows, and Linux, built with Wails.
• Theming: Light and dark mode support as well as custom themes
• Localization: Supports multiple languages through community contributions.

If you want to suggest new features or report bugs, please use the GitHub Issues section.

Integrated Services

• Seerr: Discover new movies and TV shows to watch, and request them without leaving Pelagica.
• Streamystats: Get your streamystats recommendations directly on your home page.
• kefintweaks Watchlist: View and manage your kefintweaks watchlist within Pelagica.

Screenshots

Screenshots may include media artwork used for demonstration purposes only.

Web Demo

You can find a live demo of Pelagica web at:

https://demo.pelagica.app/

The demo instance has the jellyfin.streamyfin.app server with a username preconfigured, so you just have to click "Login" to test it out. If your own Jellyfin server is publicly accessible, you can also use that by entering the server URL and your credentials.

For production use, you should self-host Pelagica using Docker or another method.

Thank you to Streamyfin for providing a demo Jellyfin server for testing!

Web Installation

Pelagica web is distributed as a Docker image. See the Installation and Configuration docs for setup instructions, and Themes for applying custom themes.

Desktop App

Pelagica is also available as a native desktop app for macOS, Windows, and Linux, built with Wails v3. Download the latest build for your platform from the Releases page.

• macOS: Not notarized, so Gatekeeper will flag it — right-click the app and choose "Open" to bypass.
• Windows: Not signed with an Authenticode certificate, so SmartScreen will flag it.
• Linux: Available as a .deb package or an .AppImage.

See the desktop README for build and packaging instructions if you'd rather build it yourself.

Discord

For discussions about Pelagica, join the JellyfinCommunity and head to the #pelagica channel.

Localization

Pelagica supports multiple languages through community contributions. See the Translations docs for how to contribute.

Development Setup

See the Development Setup docs for prerequisites and how to run the project locally.

Contributing

See the Contributing docs for guidelines on reporting issues and submitting pull requests.

What does that name mean?

You might be wondering about the name "Pelagica". Since I didn't want to call it the usual "*fin" or "jelly*" names, I looked for synonyms related to the sea. "Pelagic" refers to living in the deep ocean, which felt fitting for a Jellyfin frontend.

Acknowledgements

Pelagica’s design was inspired by the finetic Jellyfin frontend.
No code was used; this project is an independent implementation.

Disclaimer

This project is a third-party frontend for Jellyfin and is not affiliated with the Jellyfin project.

Jellyfin is a media server designed to organize and stream legally obtained media. This project does not provide, host, or encourage access to pirated content.

The movie posters and images shown in the examples are not owned by me and are only used for demonstration purposes. All rights belong to their respective owners.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.