1
0
mirror of https://github.com/hrfee/jfa-go.git synced 2024-12-28 20:10:11 +00:00
jfa-go/README.md

164 lines
8.8 KiB
Markdown
Raw Normal View History

2021-01-11 16:09:30 +00:00
![jfa-go](images/banner.svg)
2021-02-17 20:52:49 +00:00
[![Build Status](https://drone.hrfee.dev/api/badges/hrfee/jfa-go/status.svg?ref=refs/heads/main)](https://drone.hrfee.dev/hrfee/jfa-go)
2021-01-11 16:09:30 +00:00
[![Docker Hub](https://img.shields.io/docker/pulls/hrfee/jfa-go?label=docker)](https://hub.docker.com/r/hrfee/jfa-go)
2021-06-30 17:06:31 +00:00
[![Translation status](https://weblate.jfa-go.com/widgets/jfa-go/-/svg-badge.svg)](https://weblate.jfa-go.com/engage/jfa-go/)
[![Docs/Wiki](https://img.shields.io/static/v1?label=documentation&message=jfa-go.com&color=informational)](https://wiki.jfa-go.com)
[![Discord](https://img.shields.io/discord/922842034170122321?color=%235865F2&label=discord)](https://discord.com/invite/MrtvuQmyhP)
##### Downloads:
2021-05-25 00:33:58 +00:00
##### [docker](#docker) | [debian/ubuntu](#debian) | [arch (aur)](#aur) | [other platforms](#other-platforms)
2023-04-21 17:01:08 +00:00
---
## 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).
2023-04-21 17:01:08 +00:00
#### Does/Will it still work?
jfa-go currently works on Jellyfin 10.8.13, the latest version as of 26/12/23. I should be able to maintain compatability in the future, unless any big changes occur.
2023-04-21 17:01:08 +00:00
#### Alternatives
If you want a bit more of a guarantee of support, I've seen these projects mentioned although haven't tried them myself.
2023-04-21 17:01:08 +00:00
* [Wizarr](https://github.com/Wizarrrr/wizarr) focuses on invites, and also includes some Discord & Ombi integration.
* [Jellyseerr](https://github.com/Fallenbagel/jellyseerr) is a fork of Overseerr, which can manage users and mainly acts as an Ombi alternative.
* [Organizr](https://github.com/causefx/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.
2021-01-11 16:09:30 +00:00
---
2023-12-28 14:24:21 +00:00
jfa-go is a user management app for [Jellyfin](https://github.com/jellyfin/jellyfin) (and [Emby](https://emby.media/) as 2nd class) that provides invite-based account creation as well as other features that make one's instance much easier to manage.
2020-08-18 14:47:03 +00:00
#### Features
2021-05-25 00:33:58 +00:00
* 🧑 Invite based account creation: Send invites to your friends or family, and let them choose their own username and password without relying on you.
2023-12-28 14:24:21 +00:00
* Send invites via a link and/or email, discord, telegram or matrix
2020-08-18 14:47:03 +00:00
* 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.
2020-08-18 14:47:03 +00:00
* Password validation: Ensure users choose a strong password.
2023-12-28 14:24:21 +00:00
* 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.
2023-12-28 14:24:21 +00:00
* 🔗 Ombi Integration: Automatically creates Ombi accounts for new users using their email address and login details, and your own defined set of permissions. See [wiki](https://wiki.jfa-go.com/docs/ombi/) for a warning on this one.
* 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.
2021-05-31 23:06:35 +00:00
* Telegram/Discord/Matrix Integration: Verify users via a chat bot, and send Password Resets, Announcements, etc. through it.
2023-12-28 14:24:21 +00:00
* "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.
2023-02-05 00:59:04 +00:00
* 🔑 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.
2023-09-07 22:07:52 +00:00
* Can also be done through the "My Account" page if enabled.
2023-02-05 00:59:04 +00:00
* Admin Notifications: Get notified when someone creates an account, or an invite expires.
* 🌓 Customizations
* Customize emails with variables and markdown
2020-08-18 14:47:03 +00:00
* Specify contact and help messages to appear in emails and pages
* Light and dark themes available
2021-01-11 16:09:30 +00:00
#### Interface
2020-08-18 14:47:03 +00:00
<p align="center">
<img src="images/invites.png" width="47%" style="margin-left: 1.5%;" align="top" alt="Invites tab"></img>
<img src="images/create.png" width="47%" style="margin-right: 1.5%;" align="top" alt="Accounts creation"></img>
<img src="images/myaccount.png" width="47%" style="margin-left: 1.5%; margin-top: 1rem;" align="top" alt="My Account Page"></img>
<img src="images/accounts.png" width="47%" style="margin-right: 1.5%; margin-top: 1rem;" align="top" alt="Accounts tab"></img>
2020-08-18 14:47:03 +00:00
</p>
2020-08-02 01:11:50 +00:00
2020-08-03 19:10:45 +00:00
#### Install
2020-08-19 11:31:16 +00:00
**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](https://hub.docker.com/r/hrfee/jfa-go)
```sh
2020-08-03 19:10:45 +00:00
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
2023-12-28 14:24:21 +00:00
-v /path/to/jellyfin:/jf \ # Only needed for password resets through Jellyfin, ignore if not using or using Emby
2020-08-03 19:10:45 +00:00
-v /etc/localtime:/etc/localtime:ro \ # Makes sure time is correct
2020-09-15 11:23:43 +00:00
hrfee/jfa-go # hrfee/jfa-go:unstable for latest build from git
2020-08-03 19:10:45 +00:00
```
2021-05-23 22:49:48 +00:00
2021-05-25 00:33:58 +00:00
##### [Debian/Ubuntu](https://apt.hrfee.dev)
```sh
sudo apt-get update && sudo apt-get install curl apt-transport-https gnupg
2023-12-28 14:24:21 +00:00
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 (has dependencies)
sudo apt-get install jfa-go-tray
# ------
```
##### Arch
Available on the AUR as:
* [jfa-go](https://aur.archlinux.org/packages/jfa-go/) (stable)
* [jfa-go-bin](https://aur.archlinux.org/packages/jfa-go) (pre-compiled, stable)
* [jfa-go-git](https://aur.archlinux.org/packages/jfa-go-git/) (nightly)
##### Other platforms
Download precompiled binaries from:
* [The releases section](https://github.com/hrfee/jfa-go/releases) (stable)
2023-12-28 14:24:21 +00:00
* [dl.jfa-go.com](https://dl.jfa-go.com) (nightly)
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.
2020-08-18 14:47:03 +00:00
#### Build from source
If you're using docker, a Dockerfile is provided that builds from source.
2020-08-18 14:47:03 +00:00
Otherwise, full build instructions can be found [here](https://wiki.jfa-go.com/docs/build/).
2020-08-18 14:47:03 +00:00
2020-08-03 19:10:45 +00:00
#### Usage
2020-08-18 14:47:03 +00:00
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.
2020-08-02 01:11:50 +00:00
```
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")
2020-09-19 15:38:53 +00:00
-debug
Enables debug logging.
-help, -h
prints this message.
2020-08-02 01:11:50 +00:00
-host string
alternate address to host web ui on.
-port, -p int
2020-08-02 01:11:50 +00:00
alternate port to host web ui on.
-pprof
Exposes pprof profiler on /debug/pprof.
2023-12-28 14:24:21 +00:00
-restore string
path to database backup to restore.
-swagger
Enable swagger at /swagger/index.html
2020-08-02 01:11:50 +00:00
```
#### 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.
2021-01-11 16:09:30 +00:00
#### Contributing
2023-12-28 14:24:21 +00:00
See [the wiki page](https://wiki.jfa-go.com/docs/dev/).
2021-01-17 20:02:02 +00:00
##### Translation
2021-06-30 17:06:31 +00:00
[![Translation status](https://weblate.jfa-go.com/widgets/jfa-go/-/multi-auto.svg)](https://weblate.jfa-go.com/engage/jfa-go/)
2021-01-17 20:02:02 +00:00
2021-06-30 17:06:31 +00:00
For translations, use the weblate instance [here](https://weblate.jfa-go.com/engage/jfa-go/). You can login with github.
2021-11-10 19:26:39 +00:00
#### Sponsors
Big thanks to those who sponsor me. You can see them below:
[<img src="https://sponsors-endpoint.hrfee.pw/sponsor/avatar/0" width="35">](https://sponsors-endpoint.hrfee.pw/sponsor/profile/0)