Skip to content

Add hardware acceleration #525

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
webysther wants to merge 9 commits into
base: main
Choose a base branch
from
Open

Add hardware acceleration #525

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
f9261fb
feat(docker): add ffmpeg 8 with full hwa
webysther Jan 28, 2026
8fa041a
feat(ffmpeg): support ffmpeg env args and hw codecs
webysther Jan 28, 2026
8fbdd96
More sustainable hwa check
webysther Jan 28, 2026
99c4c4f
Update src/converters/ffmpeg.ts
webysther Jan 28, 2026
c10e4e6
Apply suggestion from @cubic-dev-ai[bot]
webysther Jan 28, 2026
ca8b29c
refactor(ffmpeg): use codec_short variable in h264_qsv case
webysther Jan 28, 2026
c2f4c22
🐛 fix(ffmpeg): use explicit h264_qsv codec for h264_qsv case
webysther Jan 29, 2026
2a2d0e3
Merge branch 'main' into hwa
webysther Jan 29, 2026
d3254e5
Merge branch 'main' into hwa
webysther Feb 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
100 changes: 99 additions & 1 deletion Dockerfile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,59 @@ COPY . .
# ENV NODE_ENV=production
RUN bun run build

# https://github.com/linuxserver/docker-ffmpeg/blob/master/Dockerfile#L968-L1012
FROM lscr.io/linuxserver/ffmpeg:8.0.1 AS buildstage
RUN \
echo "**** arrange files ****" && \
mkdir -p \
/buildout/usr/local/bin \
/buildout/usr/local/etc/fonts \
/buildout/usr/local/lib/libmfx-gen \
/buildout/usr/local/lib/mfx \
/buildout/usr/local/lib/x86_64-linux-gnu/dri \
/buildout/usr/local/share/vulkan \
/buildout/usr/share/fonts \
/buildout/usr/share/libdrm \
/buildout/etc/OpenCL/vendors && \
# changed https://github.com/linuxserver/docker-ffmpeg/blob/master/Dockerfile#L992-L994
cp \
/usr/local/bin/ffmpeg \
/buildout/usr/local/bin && \
cp \
/usr/local/bin/ffprobe \
/buildout/usr/local/bin && \
cp -a \
/usr/local/etc/fonts/* \
/buildout/usr/local/etc/fonts/ && \
cp -a \
/usr/local/lib/lib*so* \
/buildout/usr/local/lib/ && \
cp -a \
/usr/local/lib/libmfx-gen/*.so \
/buildout/usr/local/lib/libmfx-gen/ && \
cp -a \
/usr/local/lib/mfx/*.so \
/buildout/usr/local/lib/mfx/ && \
cp -a \
/usr/local/lib/x86_64-linux-gnu/lib*so* \
/buildout/usr/local/lib/x86_64-linux-gnu/ && \
cp -a \
/usr/local/lib/x86_64-linux-gnu/dri/* \
/buildout/usr/local/lib/x86_64-linux-gnu/dri/ && \
# removed https://github.com/linuxserver/docker-ffmpeg/blob/master/Dockerfile#L992-L994
cp -a \
/usr/share/libdrm/amdgpu.ids \
/buildout/usr/share/libdrm/ && \
cp -a \
/usr/share/fonts/* \
/buildout/usr/share/fonts/ && \
cp -a \
/usr/local/share/vulkan/* \
/buildout/usr/local/share/vulkan/ && \
echo \
'libnvidia-opencl.so.1' > \
/buildout/etc/OpenCL/vendors/nvidia.icd

# copy production dependencies and source code into final image
FROM base AS release

Expand All @@ -50,7 +103,6 @@ RUN apt-get update && apt-get install -y \
dasel \
dcraw \
dvisvgm \
ffmpeg \
ghostscript \
graphicsmagick \
imagemagick-7.q16 \
Expand Down Expand Up @@ -82,6 +134,52 @@ RUN apt-get update && apt-get install -y \
&& pipx install "markitdown[all]" \
&& rm -rf /var/lib/apt/lists/*

COPY --from=buildstage /buildout/ /

ARG DEBIAN_FRONTEND="noninteractive"

# https://github.com/linuxserver/docker-ffmpeg/blob/master/Dockerfile#L1023-L1027
# hardware env
ENV \
LIBVA_DRIVERS_PATH="/usr/local/lib/x86_64-linux-gnu/dri" \
LD_LIBRARY_PATH="/usr/local/lib" \
NVIDIA_DRIVER_CAPABILITIES="compute,video,utility" \
NVIDIA_VISIBLE_DEVICES="all"

# install additional dependencies
RUN apt-get update && apt-get install -y \
# start https://github.com/linuxserver/docker-ffmpeg/blob/master/Dockerfile#L1033-L1058
libasound2t64 \
libedit2 \
libelf1 \
libexpat1 \
libglib2.0-0 \
libgomp1 \
libllvm18 \
libpciaccess0 \
libv4l-0 \
libwayland-client0 \
libx11-6 \
libx11-xcb1 \
libxcb-dri2-0 \
libxcb-dri3-0 \
libxcb-present0 \
libxcb-randr0 \
libxcb-shape0 \
libxcb-shm0 \
libxcb-sync1 \
libxcb-xfixes0 \
libxcb1 \
libxext6 \
libxfixes3 \
libxshmfence1 \
libxml2 \
ocl-icd-libopencl1 && \
echo "**** quick test ffmpeg ****" && \
ldd /usr/local/bin/ffmpeg && \
/usr/local/bin/ffmpeg -version
# finish https://github.com/linuxserver/docker-ffmpeg/blob/master/Dockerfile#L1033-L1058

# Add pipx bin directory to PATH
ENV PATH="/root/.local/bin:${PATH}"

Expand Down
41 changes: 35 additions & 6 deletions src/converters/ffmpeg.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -708,10 +708,26 @@ export async function convert(
message = "Done: resized to 256x256";
}

// Parse FFMPEG_ARGS environment variable into array
var ffmpegArgs = process.env.FFMPEG_ARGS ? process.env.FFMPEG_ARGS.split(/\s+/) : [];
const ffmpegOutputArgs = process.env.FFMPEG_OUTPUT_ARGS
? process.env.FFMPEG_OUTPUT_ARGS.split(/\s+/)
: [];

// Check for hardware acceleration flag
const has_hwa = process.env.FFMPEG_ARGS?.includes('-hwaccel');

// Determine location in array index
const loc_hwa = ffmpegArgs.indexOf('-hwaccel');

// Get the hardware acceleration type if present
// qsv, cuda, etc.
const which_hwa = has_hwa ? ffmpegArgs[loc_hwa+1] : "";

if (convertTo.split(".").length > 1) {
// Support av1.mkv and av1.mp4 and h265.mp4 etc.
const split = convertTo.split(".");
const codec_short = split[0];
const codec_short = has_hwa ? split[0]+"_"+which_hwa : split[0];

switch (codec_short) {
case "av1":
Expand All @@ -726,14 +742,27 @@ export async function convert(
case "h266":
extraArgs.push("-c:v", "libx266");
break;
case "h264_qsv":
extraArgs.push("-c:v", "h264_qsv");
break;
case "h265_qsv":
extraArgs.push("-c:v", "hevc_qsv");
break;
case "h264_cuda":
extraArgs.push("-c:v", "h264_nvenc");
break;
case "h265_cuda":
extraArgs.push("-c:v", "hevc_nvenc");
break;
}
} else if(has_hwa){
// If hardware acceleration is specified but no codec override,
// remove from args
ffmpegArgs = ffmpegArgs.filter((_, i) => i !== loc_hwa && i !== loc_hwa + 1);
}

// Parse FFMPEG_ARGS environment variable into array
const ffmpegArgs = process.env.FFMPEG_ARGS ? process.env.FFMPEG_ARGS.split(/\s+/) : [];
const ffmpegOutputArgs = process.env.FFMPEG_OUTPUT_ARGS
? process.env.FFMPEG_OUTPUT_ARGS.split(/\s+/)
: [];
// Debug: print the full ffmpeg command
console.log(`ffmpeg ${ffmpegArgs} -i filePath ${ffmpegOutputArgs} ${extraArgs} ${targetPath}`)

return new Promise((resolve, reject) => {
execFile(
Expand Down
Loading