🪼 Jellify

🔗 Quick Links

TestFlight

ℹ️ About

jellify (verb) - to make gelatinous
see also

Jellify is a free and open source music player for Jellyfin. Built with React Native, Jellify provides a user experience that feels familar to other popular music apps and a has featureset to match

Jellify requires a connection to a Jellyfin server to work.

🤓 Background

I was after a music app for Jellyfin that showcased my music with artwork, had a user interface congruent with what the big guys do, and had the ability to algorithmically curate music (not that you have to use Jellify that way). I also wanted to create a music app that could handle my extremely large music libraries (i.e., 100K+ songs) and not get bogged down.

This app was designed with me and my dad in mind, since I wanted to give him a sleek, one stop shop for live recordings of bands he likes (read: the Grateful Dead). The UI was designed so that he'd find it instantly familiar and useful. CarPlay / Android Auto support was also a must for us, as we both use CarPlay religiously.

TL;DR Designed to be lightweight and scalable, Jellify caters to those who want a mobile Jellyfin music experience similar to what's provided by the big music streaming services.

💡 Features

✨ Current

• Available via Testflight and Android APK
  • APKs are associated with each release
• Light and Dark modes
• Home screen access to previously played tracks, artists, and your playlists
• Quick access to similar artists and items for discovering music in your library
• Jellyfin playback reporting and Last.FM Plugin support
• Library of Favorited Music, not too dissimilar to how streaming services handle your 'library'
• Full playlist support, including creating, updating, and reordering
• Offline Playback

🛠 Roadmap

• CarPlay / Android Auto Support
• Support for Jellyfin Instant Mixes
• Shared, Public, and Collaborative Playlists
• Web / Desktop support
• Watch (Apple Watch / WearOS) Support
• TV (Android, Apple, Samsung) Support

👀 Lemme see!

Screenshots taken on iPhone 15 Pro Max

Home

Home

Library

Library Artists

Artist

Similar Artists

Album

Album (Multiple Artists)

Album (Offline Mode)

Track Options

Playlist

Search

Player

CarPlay

On the Server

🏗 Built with good stuff

🎨 Frontend

Tamagui
React Navigation
React Native CarPlay
React Native Draggable Flatlist
React Native Reanimated
React Native Toast Message
React Native Vector Icons

• Specifically using Material Community Icons

🎛️ Backend

Jellyfin SDK
Tanstack Query
React Native File Access
React Native MMKV
React Native Track Player
React Native URL Polyfill

👩‍💻 Monitoring

GlitchTip

💜 Love from Wisconsin 🧀

This is undoubtedly a passion project of mine, and I've learned a lot from working on it (and the many failed attempts before it). I hope you enjoy using it! Feature requests and bug reports are welcome :)

🏃‍♀️Running Locally

⚛️ Universal Dependencies

• Ruby for Fastlane
• NodeJS v22 for React Native

🍎 iOS

Dependencies

• Xcode for building

Instructions

Setup

• Clone this repository
• Run yarn init-ios:new-arch to initialize the project
  • This will install npm packages, install bundler and required gems, and install required CocoaPods with React Native's New Architecture
• In the ios directory, run fastlane match development --readonly to fetch the development signing certificates
  • You will need access to the "Jellify Signing" private repository

Running

• Run yarn start to start the dev server
• Open the Jellify.xcodeworkspace with Xcode, not the Jellify.xcodeproject
• Run either on a device or in the simulator
  • You will need to wait for Xcode to finish it's "Indexing" step

Building

• To create a build, run yarn fastlane:ios:build to use fastlane to compile an .ipa

🤖 Android

Dependencies

• Android Studio
• Java Development Kit

Instructions

Setup

• Clone this repository
• Run yarn install to install npm packages

Running

• Run yarn start to start the dev server
• Open the android folder with Android Studio
  • Android Studio should automatically grab the "Run Configurations" and initialize Gradle
• Run either on a device or in the simulator

Building

• To create a build, run yarn fastlane:android:build to use fastlane to compile an .apk for all architectures

References

• Setting up Android SDK
• ANDROID_HOME not being set
• Android Auto app not showing up

🙏 Special Thanks To

• The Jellyfin Team for making this possible with their software, SDKs, and unequivocal helpfulness.
  • Extra thanks to Niels and Bill
• James and all other contributors of Finamp. Jellify draws inspiration and wisdom from it, and is another fantastic music app for Jellyfin.
  • James’ API Blog Post proved to be exceptionally valuable during development
• The folks in the Margelo Community Discord for their assistance
• Nicolas Charpentier for his React Native URL Polyfill module and for his assistance with getting Jest working
• The team behind Podverse for their incredible open source project, of which was used as a reference extensively during development
• My fellow contributors who have poured so much heart and a lot of sweat into making Jellify a great experience
  • Extra thanks to John and Vali-98 for shaping and designing the user experience in many places
    • Huge thank you to Ritesh for your project automation and backend expertise (and for the memes)
• The friends I made along the way that have been critical in fostering an amazing community around Jellify
  • Thalia
  • BotBlake
• My long time friends that have heard me talk about Jellify for literally eons. Thank you for testing Jellify during it's infancy and for supporting me all the way back at the beginning of this project
  • Tony (iOS, Android)
  • Trevor (Android)
  • Laine (Android)
  • Jordan (iOS)
• My best(est) friend Alyssa, for your design knowledge and for making various artwork for Jellify.
  • You’ve been instrumental in shaping it’s user experience, my rock during development, and an overall inspiration in my life