Find people who are watching your plex content from multiple devices / locations simultaniously.
License and readme updates
+17
-10
+17
-10
README.md
+17
-10
README.md
···
11
11
12
12
Private IPs (192.168.x, 10.x, etc.) are treated as the same network, so multiple devices at home won't trigger false positives.
13
13
14
-
## Setup
14
+
## Prerequisites
15
+
16
+
- Python 3.10+
17
+
- [Tautulli](https://tautulli.com/) with API access enabled
18
+
- The `requests` Python package
15
19
16
-
Requires [Nix](https://nixos.org/) with flakes enabled, or Python 3 with `requests`.
20
+
### Install dependencies
17
21
18
22
```bash
19
-
# With nix + direnv (recommended)
20
-
cd plex-simul-finder
21
-
direnv allow
23
+
pip install requests
24
+
```
22
25
23
-
# Or manually
24
-
nix develop
25
-
```
26
+
### Configure
26
27
27
-
Set your Tautulli connection in `.envrc` or export directly:
28
+
Set your Tautulli connection via environment variables or pass them as flags:
28
29
29
30
```bash
30
31
export TAUTULLI_HOST="tautulli.example.com"
31
32
export TAUTULLI_API_KEY="your-api-key"
32
33
```
34
+
35
+
You can find your API key in Tautulli under **Settings > Web Interface > API Key**.
33
36
34
37
## Usage
35
38
···
71
74
72
75
## License
73
76
74
-
[The Unlicense](https://unlicense.org/) — public domain. Do whatever you want with it.
77
+
[GPL-3.0](https://www.gnu.org/licenses/gpl-3.0.html)
78
+
79
+
---
80
+
81
+
> **Nix users:** A `flake.nix` is included. If you use [direnv](https://direnv.net/), just `direnv allow` and everything (Python + dependencies) is set up automatically. Otherwise `nix develop` drops you into a shell with everything you need.