test jellyfin plugin, would be nice

2026-08-22 22:00:28 +02:00
parent 7d6405c776
commit 4baee3fafe
23 changed files with 1713 additions and 1 deletions
@@ -0,0 +1,63 @@
+# Personal Recordings (Jellyfin plugin)
+
+Tracks which Jellyfin user scheduled a Live TV recording and moves completed files into `{TargetRoot}/{Username}/` (default `/recordings/Bram`).
+
+Jellyfin core does not store timer ownership. This plugin captures the authenticated user on `TimerCreated` / `SeriesTimerCreated` (via `HttpContext`) and later moves completed recordings.
+
+## Requirements
+
+- Jellyfin **10.11.x** (ABI `10.11.0.0`, `net9.0`)
+- Live TV recordings enabled
+- Writable target root (e.g. mount `/recordings` into the Jellyfin container)
+
+## Install
+
+### Catalog (Gitea)
+
+1. Build/release via tag (see below), or wait for CI
+2. In Jellyfin: **Dashboard → Plugins → Repositories → +**
+3. Repository URL (raw catalog):
+
+```text
+https://<your-gitea>/<owner>/<repo>/raw/branch/<default>/Jellyfin/manifest.json
+```
+
+4. Catalog → install **Personal Recordings** → restart Jellyfin
+
+### Manual
+
+```bash
+dotnet build -c Release
+# copy Jellyfin.Plugin.PersonalRecordings/bin/Release/net9.0/Jellyfin.Plugin.PersonalRecordings.dll
+# into <jellyfin-data>/plugins/PersonalRecordings/
+```
+
+Restart Jellyfin.
+
+## Configuration
+
+| Setting | Default | Meaning |
+|---|---|---|
+| Enabled | true | Master switch |
+| Target root path | `/recordings` | Files go to `{path}/{Username}/` |
+| Poll interval | 60 | Seconds between completion checks |
+| Dry run | false | Log only, no file moves |
+
+## Release (monorepo CI)
+
+```bash
+git tag jellyfin/jellyfin-plugin-personal-recordings/v1.0.0
+git push origin jellyfin/jellyfin-plugin-personal-recordings/v1.0.0
+```
+
+Workflow: [`.gitea/workflows/release_jellyfin_plugin.yml`](../../.gitea/workflows/release_jellyfin_plugin.yml)
+
+## New plugins under `Jellyfin/`
+
+Use **Actions → Scaffold Jellyfin plugin** (`scaffold_jellyfin_plugin.yml`) with a slug like `jellyfin-plugin-myfeature`. That creates boilerplate from `Jellyfin/_template/` and registers the plugin in `Jellyfin/manifest.json`.
+
+## Notes
+
+- Series child timers inherit ownership from the series timer when there is no HTTP user.
+- Moves run only when timer status is **Completed**.
+- Sidecar files (`*.nfo`, images with the same basename) are moved best-effort.