@livekit/av 7.1.500

package/NOTICE

@@ -0,0 +1,35 @@
+@livekit/av
+Copyright LiveKit, Inc.
+
+The meta package (`@livekit/av`) containing this file is licensed under the Apache License, Version 2.0.
+The FFmpeg binaries distributed via `@livekit/av-<platform>-<arch>` platform packages are licensed separately (see below).
+
+------------------------------------------------------------------------------
+FFmpeg (bundled binary, contained in @livekit/av-<platform>-<arch> packages)
+------------------------------------------------------------------------------
+
+These prebuilt FFmpeg binaries are built by LiveKit from unmodified upstream
+FFmpeg sources using the build recipe in `av/scripts/build-ffmpeg.sh` in the
+livekit/agents-private repository and are licensed under the GNU Lesser General
+Public License, version 2.1 or later (LGPL-2.1-or-later).
+
+The binaries are configured WITHOUT `--enable-gpl` and WITHOUT
+`--enable-nonfree` (no GPL-only components such as libx264/libx265 are
+included). The only external codec library linked is libopus, which is
+distributed under the 3-clause BSD license.
+
+The build is further restricted to an explicit allowlist of royalty-free audio
+codecs (PCM, MP3, FLAC, Vorbis, Opus, ALAC). Patent-encumbered codecs such as
+AAC, AC-3, E-AC-3 and DTS are intentionally excluded, as are all video codecs.
+
+Written offer / corresponding source (LGPL §6):
+  - FFmpeg source:  https://ffmpeg.org/releases/  (the exact `ffmpeg-<version>`
+    tarball pinned in `av/scripts/build-ffmpeg.sh`)
+  - libopus source: https://downloads.xiph.org/releases/opus/
+  - Build scripts:  `av/scripts/build-ffmpeg.sh` in livekit/agents-private
+
+FFmpeg is a trademark of Fabrice Bellard, originator of the FFmpeg project.
+See https://www.ffmpeg.org/legal.html for FFmpeg's license and legal notes.
+
+To use your own FFmpeg binary instead of the bundled one, set the
+`LIVEKIT_FFMPEG_PATH` environment variable to its path.

package/README.md

@@ -0,0 +1,19 @@
+# @livekit/av
+
+Prebuilt, minimal, LGPL-licensed FFmpeg binaries used by
+[LiveKit Agents](https://github.com/livekit/agents-js) for audio en/decoding.
+
+> **Internal use.** This package exists solely to support `@livekit/agents`. It is a
+> stripped-down, audio-only FFmpeg build (no video, no network, royalty-free codecs only)
+> and its API and contents may change without notice. Do not depend on it directly.
+
+Installing `@livekit/av` pulls in exactly one platform package
+(`@livekit/av-<platform>-<arch>`) via `optionalDependencies` with `os`/`cpu` filters.
+`getFfmpegPath()` returns the absolute path of the binary, or `undefined` when no platform
+package matches (e.g. musl-based distros) — callers fall back to `ffmpeg` on `PATH`.
+
+Versioning mirrors FFmpeg: npm `MAJOR.MINOR.(PATCH*100 + REV)`, so `7.1.500` is FFmpeg
+7.1.5 (build revision 0) and `7.1.501` is a rebuild of the same FFmpeg.
+
+The binaries are LGPL v2.1+ (see `NOTICE`); the JS resolver in this package is Apache-2.0.
+Build recipe: `av/scripts/build-ffmpeg.sh` in this repository.

package/index.d.ts

@@ -0,0 +1,9 @@
+// SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Absolute path of the bundled ffmpeg binary for the current platform, or `undefined`
+ * when the platform is unsupported or the matching `@livekit/av-*` package is not installed.
+ */
+export function getFfmpegPath(): string | undefined;

package/index.js

@@ -0,0 +1,26 @@
+// SPDX-FileCopyrightText: 2026 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+'use strict';
+const path = require('node:path');
+
+const SUPPORTED = new Set(['darwin-arm64', 'darwin-x64', 'linux-x64', 'linux-arm64', 'win32-x64']);
+
+/**
+ * Absolute path of the bundled ffmpeg binary for the current platform, or `undefined`
+ * when the platform is unsupported or the matching `@livekit/av-*` package is not
+ * installed (e.g. musl libc, or `--no-optional` installs).
+ */
+function getFfmpegPath() {
+  const target = `${process.platform}-${process.arch}`;
+  if (!SUPPORTED.has(target)) return undefined;
+  const bin = process.platform === 'win32' ? 'ffmpeg.exe' : 'ffmpeg';
+  try {
+    const pkgJson = require.resolve(`@livekit/av-${target}/package.json`);
+    return path.join(path.dirname(pkgJson), bin);
+  } catch {
+    return undefined;
+  }
+}
+
+module.exports = { getFfmpegPath };

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@livekit/av",
+  "version": "7.1.500",
+  "description": "Prebuilt minimal FFmpeg for LiveKit Agents audio en/decoding. For internal use; no stability guarantees.",
+  "license": "Apache-2.0",
+  "author": "LiveKit",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "NOTICE"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/livekit/agents-private.git",
+    "directory": "av/node"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "optionalDependencies": {
+    "@livekit/av-darwin-arm64": "7.1.500",
+    "@livekit/av-darwin-x64": "7.1.500",
+    "@livekit/av-linux-x64": "7.1.500",
+    "@livekit/av-linux-arm64": "7.1.500",
+    "@livekit/av-win32-x64": "7.1.500"
+  }
+}