mirror of
https://github.com/antebudimir/feishin.git
synced 2025-12-31 10:03:33 +00:00
This commit is contained in:
parent
e154810b21
commit
8bc45cda3b
1 changed files with 1 additions and 77 deletions
78
README.md
78
README.md
|
|
@ -43,7 +43,6 @@ Rewrite of [Sonixd](https://github.com/jeffvli/sonixd).
|
||||||
- [x] Scrobble playback to your server
|
- [x] Scrobble playback to your server
|
||||||
- [x] Smart playlist editor (Navidrome)
|
- [x] Smart playlist editor (Navidrome)
|
||||||
- [x] Synchronized and unsynchronized lyrics support
|
- [x] Synchronized and unsynchronized lyrics support
|
||||||
- [ ] [Request a feature](https://github.com/antebudimir/feishin/issues) or [view taskboard](https://github.com/users/jeffvli/projects/5/views/1)
|
|
||||||
|
|
||||||
## Screenshots
|
## Screenshots
|
||||||
|
|
||||||
|
|
@ -51,81 +50,10 @@ Rewrite of [Sonixd](https://github.com/jeffvli/sonixd).
|
||||||
|
|
||||||
## Getting Started
|
## Getting Started
|
||||||
|
|
||||||
### Desktop (recommended)
|
### Linux Desktop
|
||||||
|
|
||||||
Download the [latest desktop client](https://github.com/antebudimir/feishin/releases). The desktop client is the recommended way to use Feishin. It supports both the MPV and web player backends, as well as includes built-in fetching for lyrics.
|
Download the [latest desktop client](https://github.com/antebudimir/feishin/releases). The desktop client is the recommended way to use Feishin. It supports both the MPV and web player backends, as well as includes built-in fetching for lyrics.
|
||||||
|
|
||||||
#### macOS Notes
|
|
||||||
|
|
||||||
If you're using a device running macOS 12 (Monterey) or higher, [check here](https://github.com/jeffvli/feishin/issues/104#issuecomment-1553914730) for instructions on how to remove the app from quarantine.
|
|
||||||
|
|
||||||
For media keys to work, you will be prompted to allow Feishin to be a Trusted Accessibility Client. After allowing, you will need to restart Feishin for the privacy settings to take effect.
|
|
||||||
|
|
||||||
#### Linux Notes
|
|
||||||
|
|
||||||
We provide a small install script to download the latest `.AppImage`, make it executable, and also download the icons required by Desktop Environments. Finally, it generates a `.desktop` file to add Feishin to your Application Launcher.
|
|
||||||
|
|
||||||
Simply run the installer like this:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
dir=/your/application/directory
|
|
||||||
curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir"
|
|
||||||
```
|
|
||||||
|
|
||||||
The script also has an option to add launch arguments to run Feishin in native Wayland mode. Note that this is experimental in Electron and therefore not officially supported. If you want to use it, run this instead:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
dir=/your/application/directory
|
|
||||||
curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir" wayland-native
|
|
||||||
```
|
|
||||||
|
|
||||||
It also provides a simple uninstall routine, removing the downloaded files:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
dir=/your/application/directory
|
|
||||||
curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir" remove
|
|
||||||
```
|
|
||||||
|
|
||||||
The entry should show up in your Application Launcher immediately. If it does not, simply log out, wait 10 seconds, and log back in. Your Desktop Environment may alternatively provide a way to reload entries.
|
|
||||||
|
|
||||||
### Web and Docker
|
|
||||||
|
|
||||||
Visit [https://feishin.vercel.app](https://feishin.vercel.app) to use the hosted web version of Feishin. The web client only supports the web player backend.
|
|
||||||
|
|
||||||
Feishin is also available as a Docker image. The images are hosted via `ghcr.io` and are available to view [here](https://github.com/jeffvli/feishin/pkgs/container/feishin). You can run the container using the following commands:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Run the latest version
|
|
||||||
docker run --name feishin -p 9180:9180 ghcr.io/jeffvli/feishin:latest
|
|
||||||
|
|
||||||
# Build the image locally
|
|
||||||
docker build -t feishin .
|
|
||||||
docker run --name feishin -p 9180:9180 feishin
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Docker Compose
|
|
||||||
|
|
||||||
To install via Docker Compose use the following snippit. This also works on Portainer.
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
services:
|
|
||||||
feishin:
|
|
||||||
container_name: feishin
|
|
||||||
image: 'ghcr.io/jeffvli/feishin:latest'
|
|
||||||
environment:
|
|
||||||
- SERVER_NAME=jellyfin # pre defined server name
|
|
||||||
- SERVER_LOCK=true # When true AND name/type/url are set, only username/password can be toggled
|
|
||||||
- SERVER_TYPE=jellyfin # navidrome also works
|
|
||||||
- SERVER_URL= # http://address:port
|
|
||||||
- PUID=1000
|
|
||||||
- PGID=1000
|
|
||||||
- UMASK=002
|
|
||||||
- TZ=America/Los_Angeles
|
|
||||||
ports:
|
|
||||||
- 9180:9180
|
|
||||||
restart: unless-stopped
|
|
||||||
```
|
|
||||||
|
|
||||||
### Configuration
|
### Configuration
|
||||||
|
|
||||||
1. Upon startup you will be greeted with a prompt to select the path to your MPV binary. If you do not have MPV installed, you can download it [here](https://mpv.io/installation/) or install it using any package manager supported by your OS. After inputting the path, restart the app.
|
1. Upon startup you will be greeted with a prompt to select the path to your MPV binary. If you do not have MPV installed, you can download it [here](https://mpv.io/installation/) or install it using any package manager supported by your OS. After inputting the path, restart the app.
|
||||||
|
|
@ -207,10 +135,6 @@ This project is built off of [electron-vite](https://github.com/alex8088/electro
|
||||||
- `pnpm run lint:fix` - Lint the project and fix linting errors
|
- `pnpm run lint:fix` - Lint the project and fix linting errors
|
||||||
- `pnpm run i18next` - Generate i18n files
|
- `pnpm run i18next` - Generate i18n files
|
||||||
|
|
||||||
## Translation
|
|
||||||
|
|
||||||
This project uses [Weblate](https://hosted.weblate.org/projects/feishin/) for translations. If you would like to contribute, please visit the link and submit a translation.
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
[GNU General Public License v3.0 ©](https://github.com/jeffvli/feishin/blob/dev/LICENSE)
|
[GNU General Public License v3.0 ©](https://github.com/jeffvli/feishin/blob/dev/LICENSE)
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue