Skip to content

AHouseOfBards/Bonfire-JellyProfiles

Repository files navigation

Bonfire/JellyProfiles

Adds multi-user profile switching to Jellyfin. A single account can have up to five isolated profiles — each with its own watch history, parental controls, and library access.

Built for Jellyfin Server 10.11.x (all minor versions supported).


Screenshots

Profile selection screen

Profile selector — shown on launch and when switching profiles.


Installation

  1. In your Jellyfin dashboard, go to Plugins → Repositories → +
  2. Paste the following URL and click Save:
    https://ahouseofbards.github.io/Bonfire-JellyProfiles/manifest.json
    
  3. Go to Plugins → Catalog, find Profiles Management, and click Install
  4. Restart your Jellyfin server when prompted

Once the server restarts, the plugin is active and will automatically load on all compatible clients with no further setup.

Note

Docker users: If your container's web directory is read-only, the plugin may not load automatically. If this happens, check your Jellyfin logs for a permission fix command.


Features

  • Multi-User Profile Switching: Up to 5 isolated sub-profiles per Jellyfin account, each with separate watch history, library access, and parental ratings.
  • Bonfire Grouping: Link different master accounts together using secure 6-character codes to share switcher screens. (Bonfire grouping is still under development and the UI is broken)
  • PIN Protection & LAN Bypass: Secure profiles with PIN codes and bypass verification automatically when connected on your local network (LAN).
  • Device Whitelists: Limit specific profiles to designated devices.
  • Premium UI: Seamless native UI integration with custom profile pictures, custom avatar colors, and TV D-pad navigation support.

Client Compatibility

Compatible Clients:

  • Jellyfin Web (desktop & mobile browsers)
  • Official Jellyfin Android App
  • Jellyfin Media Player (Windows, macOS, Linux)

Unsupported Clients (Requires native app updates):

  • Swiftfin (iOS / tvOS)
  • Findroid (Android / Android TV)
  • Jellyfin for Roku
  • Infuse (iOS / tvOS / macOS)

Known Limitations

Skin Manager / custom themes
The Switch Profile button is designed to align with standard Jellyfin layouts. If you use custom themes or a skin manager, the button might occasionally appear misaligned or out of place. If you run into visual conflicts, please open an issue with the name of the theme you are using.

Profile creation is on the home screen, not the admin dashboard
Profiles are created and managed via the Switch Profile button on the Jellyfin home screen. The admin dashboard page (Dashboard → Plugins → Profiles) is only for server-wide settings (maximum profile count, require-PIN policy) and administrator PIN resets.


For Developers

Building a native app or custom Jellyfin client?

📄 Developer API Reference

Covers all endpoints, request/response schemas, the session lifecycle, silent PIN verification, inactivity lockout, and platform-specific implementation notes for tvOS, Android, Roku, Tizen, webOS, Xbox, PS4/PS5, and Electron.


License

MIT — see LICENSE

About

Bonfire is a Jellyfin plugin that adds profiles on a per user basis to Jellyfin. Built with Gemini Flash. Designed to work with any Jellyfin client that is a web client or a wrapper for a web client. API Documentation is included for custom app developers.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors