/streamyfin

A Jellyfin client build with Expo

Primary LanguageTypeScriptMozilla Public License 2.0MPL-2.0

๐Ÿ“บ Streamyfin

Welcome to Streamyfin, a simple and user-friendly Jellyfin client built with Expo. If you're looking for an alternative to other Jellyfin clients, we hope you'll find Streamyfin to be a useful addition to your media streaming toolbox.

๐ŸŒŸ Features

  • ๐Ÿ“ฑ Native video player: Playback with the platform native video player. With support for subtitles, playback speed control, and more.
  • ๐Ÿ“บ Picture in Picture (iPhone only): Watch movies in PiP mode on your iPhone.
  • ๐Ÿ”Š Background audio: Stream music in the background, even when locking the phone.
  • ๐Ÿ“ฅ Download media (Experimental): Save your media locally and watch it offline.
  • ๐Ÿ“ก Chromecast (Experimental): Cast your media to any Chromecast-enabled device.

๐Ÿงช Experimental Features

Streamyfin includes some exciting experimental features like media downloading and Chromecast support. These are still in development, and we appreciate your patience and feedback as we work to improve them.

Downloading

Downloading works by using ffmpeg to convert a HLS stream into a video file on the device. This means that you can download and view any file you can stream! The file is converted by Jellyfin on the server in real time as it is downloaded. This means a bit longer download times but supports any file that your server can transcode.

Collection rows

Jellyfin collections can be shown as rows or carousel on the home screen. The following tags can be added to an collection to provide this functionality.

Avaiable tags:

  • sf_promoted: Wil make the collection an row on home
  • sf_carousel: Wil make the collection an carousel on home.

A plugin exists to create collections based on external sources like mdblist. This makes managing collections like trending, most watched etc an automatic process. See Collection Import Plugin for more info.

Roadmap for V1

Check out our Roadmap to see what we're working on next. We are always open for feedback and suggestions, so please let us know if you have any ideas or feature requests.

Get it now

Get Streamyfin on App Store Get the beta on Google Play

Or download the APKs here on GitHub for Android.

Beta testing

Get the latest updates by using the TestFlight version of the app.

Get the beta on TestFlight

๐Ÿš€ Getting Started

Prerequisites

  • Ensure you have an active Jellyfin server.
  • Make sure your device is connected to the same network as your Jellyfin server.

๐Ÿ™Œ Contributing

We welcome any help to make Streamyfin better. If you'd like to contribute, please fork the repository and submit a pull request. For major changes, it's best to open an issue first to discuss your ideas.

Development info

Add this to AppDelegate.mm:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// @generated begin react-native-google-cast-didFinishLaunchingWithOptions - expo prebuild (DO NOT MODIFY) sync-8901be60b982d2ae9c658b1e8c50634d61bb5091
#if __has_include(<GoogleCast/GoogleCast.h>)
...

[GCKCastContext sharedInstance].useDefaultExpandedMediaControls = true;`
#endif

Add this to Info.plist:

<key>NSBonjourServices</key>
<array>
  <string>_googlecast._tcp</string>
  <string>_CC1AD845._googlecast._tcp</string>
</array>
<key>NSLocalNetworkUsageDescription</key>
<string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi network.</string>

๐Ÿ“„ License

Streamyfin is licensed under the Mozilla Public License 2.0 (MPL-2.0). This means you are free to use, modify, and distribute this software. The MPL-2.0 is a copyleft license that allows for more flexibility in combining the software with proprietary code. Key points of the MPL-2.0:

  • You can use the software for any purpose
  • You can modify the software and distribute modified versions
  • You must include the original copyright and license notices
  • You must disclose your source code for any modifications to the covered files
  • Larger works may combine MPL code with code under other licenses
  • MPL-licensed components must remain under the MPL, but the larger work can be under a different license
  • For the full text of the license, please see the LICENSE file in this repository.

๐ŸŒ Connect with Us

Join our Discord: https://discord.gg/zyGKHJZvv4

If you have questions or need support, feel free to reach out:

Support

Buy Me A Coffee

๐Ÿ“ Credits

Streamyfin is developed by Fredrik Burmester and is not affiliated with Jellyfin. The app is built with Expo, React Native, and other open-source libraries.

โœจ Acknowledgements

I'd like to thank the following people and projects for their contributions to Streamyfin:

  • Reiverr for great help with understanding the Jellyfin API.
  • Jellyfin TS SDK for the TypeScript SDK.
  • The Jellyfin devs for always being helpful in the Discord.