alan/linux-jellyfin-hotcache
1
0
Fork 0
Code Issues Pull requests Projects Releases 4 Packages Wiki Activity Actions
4 releases 4 tags
  • v1.0.0 c6a846a1df

    v1.0.0 Stable

    alan released this 2026-09-27 00:13:07 +00:00 | 21 commits to main since this release

    Signed by alan
    SSH key fingerprint: SHA256:yvtkLe2vkdG0Y1CCxra56JR6gjOJFURf52LUTVpWqPw

    Jellyfin Hotcache 1.0.0

    First formal release of Jellyfin Hotcache.

    Jellyfin Hotcache maintains a local hot cache of frequently accessed Jellyfin media while preserving the original Jellyfin library paths.

    Highlights

    • Playback-aware media promotion and demotion
    • PostgreSQL and SQLite playback-history support
    • Active-stream protection
    • Preserved source originals with symlink-based cache routing
    • Per-category cache limits for video and music
    • Manifest tracking and orphan detection
    • Single-run locking
    • Fail-closed Jellyfin session and playback-history checks
    • Read-only --check preflight mode
    • Environment-based secret handling
    • Debian package with systemd service and timer
    • GPL-3.0-or-later

    Validation

    This release was qualified with:

    • 22 passing regression tests
    • PostgreSQL 18 integration testing
    • Clean Debian package build
    • Clean Lintian result
    • Production migration from the previous manual installation
    • Successful production cache population
    • Post-run integrity check: CHECK: PASS (0 warnings)

    Installation

    Install the Debian package:

    sudo apt install ./jellyfin-hotcache_1.0.0-1_all.deb

    Create the operator-owned configuration:

    sudo cp /usr/share/jellyfin-hotcache/config.yml.example \
    /etc/jellyfin-hotcache/config.yml

sudo chmod 0600 /etc/jellyfin-hotcache/config.yml

    Secrets may be placed in:

    /etc/jellyfin-hotcache/environment

    Before enabling scheduled operation:

    sudo jellyfin-hotcache --check

    The package intentionally does not enable or start the timer automatically.

    After configuration and a successful preflight check, enable the timer with:

    sudo systemctl enable --now jellyfin-hotcache.timer

    Release identity

    Tag:

    v1.0.0

    Commit:

    c6a846a1df853f987048e905237e7422f30a0140

    Tree:

    7874e5063792ef48c6a14546e7e50777fe63ed7d

    Debian package:

    jellyfin-hotcache_1.0.0-1_all.deb

    SHA256:

    cc28b75d8d4472ae1b6f51cdad07048203a7e48364223d69e4f2f755b8f57d90

    Release assets

    • jellyfin-hotcache_1.0.0-1_all.deb
    • jellyfin-hotcache_1.0.0-1_amd64.buildinfo
    • jellyfin-hotcache-1.0.0-RELEASE-MANIFEST.txt
    • jellyfin-hotcache-1.0.0-SHA256SUMS
    Downloads