v0.1.0-alpha.3

0.1.0-alpha.3 (2026-10-22)

Features

• hls: play subtitle files and MP4 text subtitles, and burn in picture subtitles (#26) (62bd007)
• release: support Windows x86_64 with a CI job, a release zip and install docs (#27) (87aded0)
• videos libraries, show evidence in mixed libraries, no code files as videos (#32) (d5e94e1)

Bug Fixes

• catalog: version subfolders, word-named extras, duplicate roots and a no-metadata notice (#22) (c52e4a4)
• heal upgraded catalogs and keep art when the data dir moves (#33) (55a95e8)
• hls: cut VFR MP4 transcodes on a constant-rate grid so every piece starts with an IDR (#34) (0aec75c)
• hls: play Dolby Vision and hev1 MP4s correctly for each client (#19) (ef62d91)
• hls: remux parameter sets, transcode pieces, deinterlacing and transcode concurrency (#23) (2600bc1)
• hls: seamless AAC from laced AC-3/E-AC-3 in Matroska (#25) (2ee5856)
• hls: stop burn-in runs of a subtitle track waiting for an end ffmpeg can drop (#35) (2da7cf0)
• index MP4/MOV files with legacy text, padded boxes, junk or negative timings (#30) (e787ee1)
• names: read Chinese release names, stack A/B parts and keep bilingual titles (#20) (7884b30)
• play ASF, FLV, RealMedia, MPEG-PS and AVI without a packet scan, and name their formats (#31) (9a19887)
• play files behind junctions, classify drives and clean root paths on Windows; bring back roots that answer again (#21) (a6a5245)
• play H.264 Baseline and VP9 without a video transcode, and give idle cache memory back (#29) (3769ba3)
• server: run cleanly on Windows: graceful stops, helper processes, data dir, host allowlist, CJK posters (#24) (43309e2)

v0.1.0-alpha.2

The second pre-release of flux, an open-source media server for personal movie and TV libraries, written in Rust. It fixes two bugs in v0.1.0-alpha.1 and completes the third-party licence notices in the packages.

This is an alpha. Expect bugs and breaking changes between releases, and keep backups of anything you point it at. Read the Feature status and prototype gaps first.

What changed since alpha.1

• flux-server exits promptly on SIGTERM. In a stress test of 2,000 stops, v0.1.0-alpha.1 hung in about 7% of them: it logged flux stopped and then waited until its supervisor killed it (docker stop after 10 s, systemd after 90 s). The catalog was already committed, so no data was at risk.
• Plain-text logs under systemd and Docker. flux now colours its log only when stderr is a terminal, and honours NO_COLOR. journalctl and docker logs no longer show colour codes.
• Complete THIRD_PARTY_LICENSES. It now includes:
  • jemalloc's licence, which v0.1.0-alpha.1 left out;
  • other notices found in crate sources;
  • the web client's notices;
  • the licences of all 36 Go modules in the bundled Tailscale sidecar.
• Release checks. CI now also smoke-tests the Intel macOS package (under Rosetta 2) and the arm64 Docker image. It also fails a release whose binaries need a newer macOS than the one stated below.

Install

Packages are for macOS and Linux:

• macOS, Apple Silicon or Intel: macOS 11 or later. Embedded Tailscale access needs macOS 13 or later.
• Linux, x86_64 or arm64: glibc 2.35 or later.

The steps, including running flux as a service and upgrading from alpha.1, are in docs/INSTALL.md.

• You need ffmpeg and ffprobe. The packages don't include FFmpeg. Install it with your package manager (e.g. brew install ffmpeg), then run flux-server --check.
• Docker: ghcr.io/vibecook-dev/flux:0.1.0-alpha.2, for linux/amd64 and linux/arm64. It bundles jellyfin-ffmpeg; its source is attached below.
• Verify a download: run shasum -a 256 -c --ignore-missing SHA256SUMS. Then check its build-provenance attestation with gh attestation verify flux-0.1.0-alpha.2-<target>.tar.gz --repo vibecook-dev/flux --signer-workflow vibecook-dev/flux/.github/workflows/release.yml.

0.1.0-alpha.2 (2026-10-21)

Bug Fixes

• complete THIRD_PARTY_LICENSES, and colour the log only on a terminal (#13) (d2d766e)
• server: exit after "flux stopped" instead of hanging in the catalog's drop (#17) (b5ff2b6)

v0.1.0-alpha.1

The first pre-release of flux, an open-source media server for personal movie and TV libraries, written in Rust.

This is an alpha. Expect bugs and breaking changes between releases, and keep backups of anything you point it at. Read the Feature status and prototype gaps first.

Install

Packages for macOS (Apple Silicon and Intel; macOS 11+, and embedded Tailscale access needs macOS 13+) and Linux (x86_64 and arm64, glibc 2.35+). The steps, including running flux as a service and upgrading, are in docs/INSTALL.md.

• You need ffmpeg and ffprobe. The packages don't include FFmpeg. Install it with your package manager (e.g. brew install ffmpeg), then run flux-server --check.
• Docker: ghcr.io/vibecook-dev/flux:0.1.0-alpha.1, for linux/amd64 and linux/arm64. It bundles jellyfin-ffmpeg; its source is attached below.
• Verify a download: shasum -a 256 -c --ignore-missing SHA256SUMS. Then check its build-provenance attestation with gh attestation verify flux-0.1.0-alpha.1-<target>.tar.gz --repo vibecook-dev/flux --signer-workflow vibecook-dev/flux/.github/workflows/release.yml.

0.1.0-alpha.1 (2026-10-21)

Features

• initial public release of flux (7af3200)

Bug Fixes

• deps: take truffle-core 0.7.20 from crates.io and bundle its sidecar (#6) (23558e1)
• net: point the missing-sidecar error at release packages, not a dev worktree (#10) (7cd02b2)
• server: find the web client and sidecar next to a symlinked flux-server (#11) (73b6d12)

Third-party notice missing from this release's packages

flux-server includes jemalloc, through the tikv-jemalloc-sys crate. This release's THIRD_PARTY_LICENSES file leaves out jemalloc's licence; v0.1.0-alpha.2 will include it. Here it is in full:

Unless otherwise specified, files in the jemalloc source distribution are
subject to the following license:
--------------------------------------------------------------------------------
Copyright (C) 2002-present Jason Evans <jasone@canonware.com>.
All rights reserved.
Copyright (C) 2007-2012 Mozilla Foundation.  All rights reserved.
Copyright (C) 2009-present Facebook, Inc.  All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice(s),
   this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice(s),
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) ``AS IS'' AND ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
EVENT SHALL THE COPYRIGHT HOLDER(S) BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
--------------------------------------------------------------------------------