You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: readme.md
+9-14
Original file line number
Diff line number
Diff line change
@@ -39,8 +39,8 @@
39
39
40
40
Players Supported:
41
41
* Plex
42
-
* Jellyfin (experimental)
43
-
* Emby (no support or testing)
42
+
* Jellyfin (no support given, but tested)
43
+
* Emby (may work due to jellyfin support, no support given and not tested)
44
44
45
45
Main features:
46
46
* Load/unload BEQ profiles automatically, without user action and the correct codec detected
@@ -56,18 +56,13 @@ Other cool stuff:
56
56
* Dry run and notification modes to verify BEQ profiles without actually loading them
57
57
* Built in support for Home Assistant and Minidsp
58
58
59
-
> ℹ Jellyfin support is coming soon®
60
-
61
-
62
-
This application is primarily focused on Plex and HomeAssistant but I plan on adding support for other sources in the future.
63
-
64
59
## Setup
65
60
> ⚠️ ⚠️ *Warning: You should really set a compressor on your minidsp for safety as outlined in the [BEQ forum post](https://www.avsforum.com/threads/bass-eq-for-filtered-movies.2995212/). I am not responsible for any damage* ⚠️ ⚠️
66
61
### Prerequisites
67
62
> ℹ It is assumed you have the following tools working. Refer to their respective guides for installation help.
68
63
* MQTT Broker (Optional)
69
64
* Home Assistant (Optional)
70
-
* Plex or Jellyfin (still experimental)
65
+
* Plex or Jellyfin
71
66
* ezBEQ
72
67
* Minidsp (other DSPs may work but I have not tested them. If ezBEQ supports it, it should be work)
73
68
@@ -99,11 +94,12 @@ You must use the [official Jellyfin Webhooks plugin](https://github.com/jellyfin
99
94
2) Add http://(your-server-ip):9999/jellyfinwebhook as the url
100
95
3) Types:
101
96
* PlaybackStart
102
-
* PlaybackProgress (needed for pause)
103
97
* PlaybackStopped
104
98
4) You can optionally add a user filter
105
99
5) Item types: Movies, Episodes
106
100
101
+
*note: playbackProgress is not supported because it is way too buggy and unreliable*
102
+
107
103
Configure the webhook in whatever way you want but it *must* include the following and in this order:
108
104
109
105
```json
@@ -245,13 +241,10 @@ mode: queued
245
241
max: 10
246
242
```
247
243
248
-
249
244
### Handlers
250
245
`/plexwebhook`
251
-
This endpoint is where you should tell Plex to send webhooks to. It automatically processes them. No further action is needed. This handler does most of the work - Loading BEQ, lights, volume, etc
252
246
253
247
`/jellyfin`
254
-
Coming soon
255
248
256
249
`/minidspwebhook`
257
250
This endpoint accepts commands used by minidsp-rs which are performed by EZbeq. Here is how to trigger it with Home Assistant
@@ -281,7 +274,7 @@ One use case is to mute the subs at night. You can use the time integration to t
281
274
### Config
282
275
The only supported way to configure this is via the web UI. You can dump the current config via the `/config` endpoint.
283
276
284
-
### Authentication
277
+
### Plex Authentication
285
278
You must whitelist your server IP in "List of IP addresses and networks that are allowed without auth"
286
279
287
280
Why? Plex refuses to implement client to server authentication and you must go through their auth servers. I may eventually implement their auth flow but it is not a priority.
@@ -305,10 +298,12 @@ If enabled, it will also send a notification to Home Assistant via Notify so you
305
298
For safety, the application tries to unload the profile when it loads up each time in case it crashed or was killed previously, and will unload before playing anything so it doesn't start playing something with the wrong profile.
306
299
307
300
### Matching
308
-
The application will search the catalog and match based on codec (Atmos, DTS-X, etc), title, year, and edition. I have tested with multiple titles and everything matched as expected.
301
+
The application will search the catalog and match based on codec (Atmos, DTS-X, etc), title, year, TMDB, and edition. I have tested with multiple titles and everything matched as expected.
309
302
310
303
> ⚠️ *If you get an incorrect match, please open a github issue with the full log output and expected codec and title*
311
304
305
+
Jellyfin may have some issues matching as I have found it will sometimes just not return a TMDB. This has nothing to do with me. Jellyfin is generally just quite buggy. There is a configuration option that you should probably enable in the Jellyfin section which lets you skip TMDB matching. It will instead use the title name which could be prone to false negatives.
306
+
312
307
### Editions
313
308
314
309
This application will do its best to match editions. It will look for one of the following:
0 commit comments