1
0
mirror of https://github.com/hrfee/jfa-go.git synced 2024-12-29 20:40:10 +00:00
a better way to manage your Jellyfin users, now in go.
Go to file
dependabot[bot] 436a1db087
build(deps): bump ws from 6.2.2 to 6.2.3 in /site
Bumps [ws](https://github.com/websockets/ws) from 6.2.2 to 6.2.3.
- [Release notes](https://github.com/websockets/ws/releases)
- [Commits](https://github.com/websockets/ws/compare/6.2.2...6.2.3)

---
updated-dependencies:
- dependency-name: ws
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2024-08-29 13:31:18 +00:00
.github update version; mention log button in bug report template 2022-01-30 14:27:00 +00:00
.woodpecker build: push redoc after build 2024-08-06 21:06:06 +01:00
common update go.mods 2024-08-26 17:26:04 +01:00
config build: remove compile_mjml script, no python! 2024-08-26 17:01:34 +01:00
css setup: fix config application 2024-08-29 13:30:03 +01:00
docs use esbuild to compile and minify ts 2020-09-29 20:35:06 +01:00
easyproxy build(deps): bump golang.org/x/net from 0.15.0 to 0.23.0 in /easyproxy 2024-08-26 18:58:16 +00:00
html accounts: css adjustments 2024-08-28 20:55:52 +01:00
images users: huge cleanup/dedupe, interface-based third-party services 2024-08-03 21:27:46 +01:00
jellyseerr update go.mods 2024-08-26 17:26:04 +01:00
lang form/admin: don't allow "+" in username/email 2024-08-24 15:04:18 +01:00
linecache Generate crash report txt and webpage 2021-06-11 21:56:53 +01:00
logger form/admin: don't allow "+" in username/email 2024-08-24 15:04:18 +01:00
logmessages setup: fix config application 2024-08-29 13:30:03 +01:00
mail accounts: notify users of expiry adjustment 2024-07-28 16:53:27 +01:00
ombi update go.mods 2024-08-26 17:26:04 +01:00
scripts update go.mods 2024-08-26 17:26:04 +01:00
site build(deps): bump ws from 6.2.2 to 6.2.3 in /site 2024-08-29 13:31:18 +00:00
static build: include latest banner automatically 2024-08-04 21:04:20 +01:00
ts accounts: fix profile list for enabling referrals 2024-08-29 12:14:43 +01:00
.gitignore settings: dependencies of dependencies 2024-08-23 18:50:50 +01:00
.goreleaser.yml build: change deprecated goreleaser option 2024-08-26 17:47:40 +01:00
' ts: use pages modules in admin (kinda), change pseudo-links 2024-08-28 14:18:52 +01:00
api-activities.go api: adjust a couple of URIs 2024-08-21 20:35:08 +01:00
api-backups.go logmessages: finish up to api-users (alphabetically), refactor 2024-08-01 13:59:24 +01:00
api-invites.go api: adjust a couple of URIs 2024-08-21 20:35:08 +01:00
api-jellyseerr.go users: huge cleanup/dedupe, interface-based third-party services 2024-08-03 21:27:46 +01:00
api-messages.go config: add support for "list" type 2024-08-20 20:19:32 +01:00
api-ombi.go api clients: return data, error, no status 2024-08-06 14:48:31 +01:00
api-profiles.go api: adjust a couple of URIs 2024-08-21 20:35:08 +01:00
api-userpage.go api clients: return data, error, no status 2024-08-06 14:48:31 +01:00
api-users.go accounts: standardise "text with edit button" component 2024-08-28 20:22:25 +01:00
api.go setup: fix config application 2024-08-29 13:30:03 +01:00
args.go backups: add -restore cli argument 2023-12-21 17:27:28 +00:00
auth.go bump mediabrowser version, always verbose 2024-08-29 14:30:16 +01:00
autostart.go fix cross compilation in goreleaser/drone 2021-05-16 21:01:31 +01:00
backups.go matrix: working E2EE, on by default 2024-08-10 19:31:54 +01:00
config.go config: migrate to new yaml format 2024-08-26 15:43:28 +01:00
CONTRIBUTING.md readme: cleanup and up-to-dateness 2023-12-28 14:24:21 +00:00
discord.go proxy: use wherever http.Client is, update mautrix 2024-08-09 21:42:16 +01:00
Dockerfile build: correct updater on docker 2024-08-11 17:39:58 +01:00
email.go auth: source cookie hostname from jfa_url 2024-08-13 20:39:06 +01:00
exit.go crash: render ANSI colors on crash page 2023-06-12 15:48:07 +01:00
external.go admin: add build tags to "About" 2024-08-11 17:55:12 +01:00
generic-d.go logmessages: all log strings in one file 2024-08-01 20:17:05 +01:00
go.mod bump mediabrowser version, always verbose 2024-08-29 14:30:16 +01:00
go.sum bump mediabrowser version, always verbose 2024-08-29 14:30:16 +01:00
housekeeping-d.go bump mediabrowser version, always verbose 2024-08-29 14:30:16 +01:00
internal.go admin: add build tags to "About" 2024-08-11 17:55:12 +01:00
jellyseerr-d.go matrix: working E2EE, on by default 2024-08-10 19:31:54 +01:00
jfa-go.service fix dropdown colors in dark mode on chrome 2021-03-09 18:15:14 +00:00
lang.go config: migrate to new yaml format 2024-08-26 15:43:28 +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 bump mediabrowser version, always verbose 2024-08-29 14:30:16 +01:00
Makefile build: fix crash css/js inlining 2024-08-28 15:55:30 +01:00
matrix_crypto.go admin: add build tags to "About" 2024-08-11 17:55:12 +01:00
matrix_nocrypto.go admin: add build tags to "About" 2024-08-11 17:55:12 +01:00
matrix.go matrix: working E2EE, on by default 2024-08-10 19:31:54 +01:00
migrations.go config: add support for "list" type 2024-08-20 20:19:32 +01:00
models.go config: migrate to new yaml format 2024-08-26 15:43:28 +01:00
notray.go admin: add build tags to "About" 2024-08-11 17:55:12 +01:00
package-lock.json Merge pull request from hrfee/dependabot/npm_and_yarn/word-wrap-1.2.5 2024-08-26 19:01:20 +00:00
package.json build(deps): bump postcss from 8.4.24 to 8.4.31 2024-08-26 18:57:04 +00:00
pwreset.go auth: source cookie hostname from jfa_url 2024-08-13 20:39:06 +01:00
pwval.go live validation on form, change special character definition 2021-01-09 01:00:27 +00:00
README.md update: distinguish E2EE builds 2024-08-11 20:00:55 +01:00
restart_windows.go logmessages: all log strings in one file 2024-08-01 20:17:05 +01:00
restart.go fix bugs with restarts/interrupts 2023-06-11 19:50:50 +01:00
router.go userpage: add password reset direct link 2024-08-27 14:56:24 +01:00
setup.go api clients: return data, error, no status 2024-08-06 14:48:31 +01:00
static.go use embed.fs wrapper on data 2021-02-12 14:35:16 +00:00
storage.go matrix: working E2EE, on by default 2024-08-10 19:31:54 +01:00
stripmd.go Discord: Remove extra newlines around links 2021-05-23 01:05:53 +01:00
tailwind.config.js css: add notification animation 2023-06-26 20:13:02 +01:00
telegram.go proxy: use wherever http.Client is, update mautrix 2024-08-09 21:42:16 +01:00
template.go Fix email editor for other email types 2021-04-22 19:16:41 +01:00
tray.go admin: add build tags to "About" 2024-08-11 17:55:12 +01:00
updater.go webhooks: add "user created" webhook 2024-08-20 21:45:31 +01:00
user-auth.go auth: source cookie hostname from jfa_url 2024-08-13 20:39:06 +01:00
user-d.go api clients: return data, error, no status 2024-08-06 14:48:31 +01:00
users.go form/admin: don't allow "+" in username/email 2024-08-24 15:04:18 +01:00
views.go form/admin: don't allow "+" in username/email 2024-08-24 15:04:18 +01:00
webhooks.go webhooks: add "user created" webhook 2024-08-20 21:45:31 +01:00

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

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

Project Status: Active-ish

Studies mean I can't work on this project a lot outside of breaks, however I hope i'll be able to fit in general support and things like bug fixes into my time. New features and such will likely come in short bursts throughout the year (if they do at all).

Does/Will it still work?

jfa-go currently works on Jellyfin 10.9.8, the latest version as of 31/07/2024. I should be able to maintain compatability in the future, unless any big changes occur.

Alternatives

If you want a bit more of a guarantee of support, I've seen these projects mentioned although haven't tried them myself.


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

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, discord, telegram or matrix
    • 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 and contact method verificatoin 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/Jellyseerr Integration: Automatically creates and synchronizes details for new accounts. Supports setting permissions with the Profiles feature. Ombi integration use is risky, see wiki.
  • Account management: Bulk or individually; apply settings, delete, disable/enable, send messages and much more.
  • 📣 Announcements: Bulk message your users with announcements about your server.
  • Telegram/Discord/Matrix Integration: Verify users via a chat bot, and send Password Resets, Announcements, etc. through it.
  • "My Account" Page: Allows users to reset their password, manage contact details, view their account expiry date, and send referrals. Can be customized with markdown.
  • Referrals: Users can be given special invites to send to their friends and families, similar to some invite-only services like Bluesky.
  • 🔑 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.
    • Can also be done through the "My Account" page if enabled.
  • Admin Notifications: Get notified when someone creates an account, or an invite expires.
  • 🌓 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 creation My Account Page Accounts tab

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.

MatrixE2EE builds (and Linux TrayIcon builds) include support for end-to-end encryption for the Matrix bot, but require the libolm(-dev) dependency. .deb/.rpm/.apk packages list this dependency, and docker images include it.

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 \ # Only needed for password resets through Jellyfin, ignore if not using or 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 | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/apt.hrfee.dev.gpg

# 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 (may pull in lots of 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.
  -restore string
    	path to database backup to restore.
  -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.

Contributing

See the wiki page.

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: