a better way to manage your Jellyfin users, now in go
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Harvey Tindall 5ba40cd6f8
fix panic when jfa-go user has no email set with jellyfin_login
4 years ago
.github/ISSUE_TEMPLATE add issue template 4 years ago
config Add account deletion with email notification 4 years ago
data Remove view settings button 4 years ago
images add about page to web ui 4 years ago
mail Add account deletion with email notification 4 years ago
scss omit source map url in compiled css 4 years ago
.gitignore Remove view settings button 4 years ago
.goreleaser.yml fix goreleaser to include data subdirectories 4 years ago
Dockerfile compress executable in dockerfile 4 years ago
LICENSE Added install step to makefile; start PKGBUILD 4 years ago
Makefile version based on current tag for makefile 4 years ago
README.md mention unstable docker branch 4 years ago
api.go fix panic when jfa-go user has no email set with jellyfin_login 4 years ago
auth.go cleaned up auth 4 years ago
config.go Add account deletion with email notification 4 years ago
daemon.go use app identifier instead of ctx 4 years ago
email.go Add account deletion with email notification 4 years ago
go.mod Upgrade packages 4 years ago
go.sum Upgrade packages 4 years ago
jfa-go.service add example systemd service 4 years ago
jfapi.go Add account deletion with email notification 4 years ago
main.go add user button 4 years ago
ombi.go add issue template 4 years ago
package-lock.json CLI flags, start setting up goreleaser, add build scripts 4 years ago
package.json CLI flags, start setting up goreleaser, add build scripts 4 years ago
pwreset.go userByName reloads cache if user not found, more things in test 4 years ago
pwval.go Partial check for invite page, 404 handling 4 years ago
setup.go use newJellyfin instead of constructor method 4 years ago
storage.go Initial Ombi integration 4 years ago
version.py version based on current tag for makefile 4 years ago
views.go add user button 4 years ago

README.md

jfa-go

jfa-go is a user management app for Jellyfin that provides invite-based account creation as well as other features that make one's instance much easier to manage.

I chose to rewrite the python jellyfin-accounts in Go mainly as a learning experience, but also to slightly improve speeds and efficiency.

Features

  • 🧑 Invite based account creation: Sends invites to your friends or family, and let them choose their own username and password without relying on you.
    • Send invites via a link and/or email
    • Granular control over invites: Validity period as well as number of uses can be specified.
    • Account defaults: Configure an example account to your liking, and its permissions, access rights and homescreen layout can be applied to all new users.
    • Password validation: Ensure users choose a strong password.
  • 🔗 Ombi Integration: Automatically creates Ombi accounts for new users using their email address and login details, and your own defined set of permissions.
  • 📨 Email storage: Add your existing user's email addresses through the UI, and jfa-go will ask new users for them on account creation.
    • Email addresses can optionally be used instead of usernames
  • 🔑 Password resets: When user's forget their passwords and request a change in Jellyfin, jfa-go reads the PIN from the created file and sends it straight to the user via email.
  • Notifications: Get notified when someone creates an account, or an invite expires.
  • Authentication via Jellyfin: Instead of using separate credentials for jfa-go and Jellyfin, jfa-go can use it as the authentication provider.
    • Enables the usage of jfa-go by multiple people
  • 🌓 Customizable look
    • Specify contact and help messages to appear in emails and pages
    • Light and dark themes available
    • Optionally provide custom CSS

Interface

Admin page Account creation page

Install

Available on the AUR as jfa-go or jfa-go-git.

For other platforms, grab an archive from the release section for your platform, and extract jfa-go and data to the same directory.

  • For linux users, you can place them inside /opt/jfa-go and then run sudo ln -s /opt/jfa-go/jfa-go /usr/bin/jfa-go to place it in your PATH.

Run the executable to start.

For docker, run:

docker create \
             --name "jfa-go" \ # Whatever you want to name it
             -p 8056:8056 \
             -v /path/to/.config/jfa-go:/data \ # Path to wherever you want to store the config file and other data
             -v /path/to/jellyfin:/jf \ # Path to jellyfin config directory
             -v /etc/localtime:/etc/localtime:ro \ # Makes sure time is correct
             hrfee/jfa-go # hrfee/jfa-go:unstable for latest build from git

Build from source

A Dockerfile is provided that creates an image built from source, but it's only suitable for those who will run jfa-go in docker.

Full build instructions can be found here.

Usage

Simply run jfa-go to start the application. A setup wizard will start on localhost:8056 (or your own specified address). Upon completion, refresh the page.

Note: jfa-go does not run as a daemon by default. You'll need to figure this out yourself.

Usage of ./jfa-go:
  -config string
    	alternate path to config file. (default "~/.config/jfa-go/config.ini")
  -data string
    	alternate path to data directory. (default "~/.config/jfa-go")
  -host string
    	alternate address to host web ui on.
  -port int
    	alternate port to host web ui on.

If you're switching from jellyfin-accounts, copy your existing ~/.jf-accounts to:

  • XDG_CONFIG_DIR/jfa-go (usually ~/.config) on *nix systems,
  • %AppData%/jfa-go on Windows,
  • ~/Library/Application Support/jfa-go on macOS.

(or specify config/data path with -config/-data respectively.)