1
0
mirror of https://github.com/hrfee/jfa-go.git synced 2024-10-31 15:30:10 +00:00
a better way to manage your Jellyfin users, now in go.
Go to file
2023-06-22 10:12:22 +01:00
.github update version; mention log button in bug report template 2022-01-30 14:27:00 +00:00
common Show log on log.Fatal calls, provide "sanitized" version, fix goreleaser 2021-06-11 23:28:21 +01:00
config settings: add "note" type, shows as card 2023-06-21 12:28:52 +01:00
css userpage: add "back to admin" button 2023-06-22 09:41:41 +01:00
docs use esbuild to compile and minify ts 2020-09-29 20:35:06 +01:00
html form: add notice about userpage on success modal, userpage title 2023-06-22 10:12:22 +01:00
images add discord link; new thumbnail variant 2021-12-21 13:43:37 +00:00
lang form: add notice about userpage on success modal, userpage title 2023-06-22 10:12:22 +01:00
linecache Generate crash report txt and webpage 2021-06-11 21:56:53 +01:00
logger fix NewEmptyLogger 2021-10-03 15:59:58 +01:00
mail fix broken url in welcome email 2021-05-02 14:44:19 +01:00
ombi fix discord/telegram linking with ombi 2022-01-25 17:37:14 +00:00
scripts settings: add "note" type, shows as card 2023-06-21 12:28:52 +01:00
site site: update node deps 2023-06-12 18:49:42 +01:00
static Merge a17t-redesign, kinda ts-ify setup.js 2021-01-05 18:16:23 +00:00
ts form: add notice about userpage on success modal, userpage title 2023-06-22 10:12:22 +01:00
.drone.yml apidocs: re-version, set up for hosted ui 2021-11-15 00:19:52 +00:00
.gitignore userpage: use form langfile, move login strings to common 2023-06-17 12:48:28 +01:00
.goreleaser.yml telegram: modularize, add to userpage 2023-06-19 22:11:35 +01:00
api-invites.go storage: Use familiar api for invite access 2023-06-21 20:39:16 +01:00
api-messages.go storage: Use familiar api for invite access 2023-06-21 20:39:16 +01:00
api-ombi.go storage: user set/get methods for contact method access 2023-06-20 12:19:24 +01:00
api-profiles.go reorganise api, add "Connection refused" error in setup 2022-03-22 14:58:39 +00:00
api-userpage.go messages: assign tokens to jf users on userpage 2023-06-21 18:26:08 +01:00
api-users.go form: rework email confirmation 2023-06-21 21:14:41 +01:00
api.go settings: add "note" type, shows as card 2023-06-21 12:28:52 +01:00
args.go args: fix help not usually showing 2023-06-11 15:48:27 +01:00
auth.go storage: user set/get methods for contact method access 2023-06-20 12:19:24 +01:00
autostart.go fix cross compilation in goreleaser/drone 2021-05-16 21:01:31 +01:00
config.go userpage: implement login message card 2023-06-20 21:43:25 +01:00
CONTRIBUTING.md update contributing 2021-07-25 01:13:57 +01:00
daemon.go storage: user set/get methods for contact method access 2023-06-20 12:19:24 +01:00
discord.go messages: assign tokens to jf users on userpage 2023-06-21 18:26:08 +01:00
Dockerfile update node version in Dockerfile 2022-01-30 17:18:51 +00:00
email.go userpage: implement login message card 2023-06-20 21:43:25 +01:00
exit.go crash: render ANSI colors on crash page 2023-06-12 15:48:07 +01:00
external.go fix external fs 2021-07-16 15:39:22 +01:00
go.mod discord: proper support for discriminator-less 2023-06-12 16:32:40 +01:00
go.sum discord: proper support for discriminator-less 2023-06-12 16:32:40 +01:00
internal.go almost complete telegram user verification 2021-05-07 01:08:12 +01:00
jfa-go.service fix dropdown colors in dark mode on chrome 2021-03-09 18:15:14 +00:00
lang.go userpage: show expiry 2023-06-18 12:27:18 +01:00
LICENSE update license 2023-06-11 20:00:30 +01:00
log.go args: fix help not usually showing 2023-06-11 15:48:27 +01:00
main.go form: rework email confirmation 2023-06-21 21:14:41 +01:00
Makefile userpage: fix card color in light mode 2023-06-21 11:05:38 +01:00
matrix_crypto.go matrix: fix instant crash with e2ee 2021-07-20 15:34:39 +01:00
matrix_nocrypto.go matrix: remove crypto dep in main file 2021-07-16 17:11:17 +01:00
matrix.go userpage: implement login message card 2023-06-20 21:43:25 +01:00
migrations.go storage: user set/get methods for contact method access 2023-06-20 12:19:24 +01:00
models.go settings: add "note" type, shows as card 2023-06-21 12:28:52 +01:00
notray.go tray: remove systray dep in non-tray builds 2021-08-18 17:25:16 +01:00
package-lock.json userpage: fix card color in light mode 2023-06-21 11:05:38 +01:00
package.json userpage: fix card color in light mode 2023-06-21 11:05:38 +01:00
pwreset.go fix bugs with restarts/interrupts 2023-06-11 19:50:50 +01:00
pwval.go live validation on form, change special character definition 2021-01-09 01:00:27 +00:00
README.md README: add note about project status 2023-04-21 18:01:08 +01:00
restart_windows.go add hard restart for updates on *nix 2021-05-03 20:08:23 +01:00
restart.go fix bugs with restarts/interrupts 2023-06-11 19:50:50 +01:00
router.go form: fix captcha, matrix, telegram 2023-06-21 20:00:48 +01:00
setup.go lang: add patchable notifications to common 2023-06-16 18:29:49 +01:00
static.go use embed.fs wrapper on data 2021-02-12 14:35:16 +00:00
storage.go form: rework email confirmation 2023-06-21 21:14:41 +01:00
stripmd.go Discord: Remove extra newlines around links 2021-05-23 01:05:53 +01:00
tailwind.config.js discord: use placeholder if guild icon not available 2023-06-19 17:48:24 +01:00
telegram.go messages: assign tokens to jf users on userpage 2023-06-21 18:26:08 +01:00
template.go Fix email editor for other email types 2021-04-22 19:16:41 +01:00
tray.go fix bugs with restarts/interrupts 2023-06-11 19:50:50 +01:00
updater.go updater: check build is ready 2022-01-30 18:25:47 +00:00
user-auth.go userpage: store refresh token separately 2023-06-18 12:30:23 +01:00
userdaemon.go Split some settings into new "messages" section 2021-05-07 21:53:29 +01:00
views.go form: add notice about userpage on success modal, userpage title 2023-06-22 10:12:22 +01:00

jfa-go Build Status Docker Hub Translation status Docs/Wiki Discord

Downloads:
docker | debian/ubuntu | arch (aur) | other platforms

Project Status

Due to studies and general lack of enthusiasm for work on this project, new features are unlikely, and while occasionally I might fix a bug or two, I won't be supporting the project a lot.

Does it still work?

jfa-go still appears to work on the latest version of Jellyfin (10.8.9), and unless any large architectural changes occur to it, functionality should still remain.

Alternatives

None of these have been tested by myself, but I have seen them mentioned quite frequently.

  • Wizarr focuses on invites, and also includes some Discord & Ombi integration.
  • Jellyseerr is a fork of Overseerr, which can manage users and mainly acts as an Ombi alternative.
  • Organizr doesn't focus on Jellyfin, but allows putting self-hosted services into "tabs" on a central page, and allows creating users, which lets one control who can access what.

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

a rewrite of jellyfin-accounts (original naming for both, ik 😂).

Features

  • 🧑 Invite based account creation: Send 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 profiles: Assign settings profiles to invites so new users have your predefined permissions, homescreen layout, etc. applied to their account on creation.
    • Password validation: Ensure users choose a strong password.
    • CAPTCHAs can be enabled to avoid bots
  • User expiry: Specify a validity period, and new users accounts will be disabled/deleted after it. The period can be manually extended too.
  • 🔗 Ombi Integration: Automatically creates Ombi accounts for new users using their email address and login details, and your own defined set of permissions.
  • Account management: Apply settings to your users individually or en masse, and delete users, optionally sending them an email notification with a reason.
  • Telegram/Discord/Matrix Integration: Verify users via a chat bot, and send Password Resets, Announcements, etc. through it.
  • 📨 Email storage: Add your existing users 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 users forget their passwords and request a change in Jellyfin, jfa-go reads the PIN from the created file and sends it straight to them via email/telegram.
  • Admin Notifications: Get notified when someone creates an account, or an invite expires.
  • 📣 Announcements: Bulk message your users with announcements about your server.
  • 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
  • 🌓 Customizations
    • Customize emails with variables and markdown
    • Specify contact and help messages to appear in emails and pages
    • Light and dark themes available

Interface

Invites tab Accounts tab Accounts creation

Install

Note: TrayIcon builds include a tray icon to start/stop/restart, and an option to automatically start when you log-in to your computer. For Linux users, these builds depend on the libappindicator3-1/libappindicator-gtk3/libappindicator package for Debian/Ubuntu, Fedora, and Alpine respectively.

Docker
docker create \
             --name "jfa-go" \ # Whatever you want to name it
             -p 8056:8056 \
            # -p 8057:8057 if using tls
             -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, ignore if using Emby
             -v /etc/localtime:/etc/localtime:ro \ # Makes sure time is correct
             hrfee/jfa-go # hrfee/jfa-go:unstable for latest build from git
Debian/Ubuntu
sudo apt-get update && sudo apt-get install curl apt-transport-https gnupg
curl https://apt.hrfee.dev/hrfee.pubkey.gpg | sudo apt-key add -

# For stable releases
echo "deb https://apt.hrfee.dev trusty main" | sudo tee /etc/apt/sources.list.d/hrfee.list
# ------
# For unstable releases
echo "deb https://apt.hrfee.dev trusty-unstable main" | sudo tee /etc/apt/sources.list.d/hrfee.list
# ------

sudo apt-get update

# For servers
sudo apt-get install jfa-go
# ------
# For desktops/servers with GUI (has dependencies)
sudo apt-get install jfa-go-tray
# ------
Arch

Available on the AUR as:

Other platforms

Download precompiled binaries from:

unzip the jfa-go/jfa-go.exe executable to somewhere useful.

  • For *nix/macOS users, chmod +x jfa-go then place it somewhere in your PATH like /usr/bin.

Run the executable to start.

Build from source

If you're using docker, a Dockerfile is provided that builds from source.

Otherwise, 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.

Usage of jfa-go:
  start
	start jfa-go as a daemon and run in the background.
  stop
	stop a daemonized instance of jfa-go.
  systemd
	generate a systemd .service file.

  -config, -c string
    	alternate path to config file. (default "/home/hrfee/.config/jfa-go/config.ini")
  -data, -d string
    	alternate path to data directory. (default "/home/hrfee/.config/jfa-go")
  -debug
    	Enables debug logging.
  -help, -h
    	prints this message.
  -host string
    	alternate address to host web ui on.
  -port, -p int
    	alternate port to host web ui on.
  -pprof
    	Exposes pprof profiler on /debug/pprof.
  -swagger
    	Enable swagger at /swagger/index.html

Systemd

jfa-go does not run as a daemon by default. Run jfa-go systemd to create a systemd .service file in your current directory, which you can copy into ~/.config/systemd/user or somewhere else.


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

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

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

Contributing

See the wiki page or CONTRIBUTING.md.

Translation

Translation status

For translations, use the weblate instance here. You can login with github.

Sponsors

Big thanks to those who sponsor me. You can see them below: