dangeroustech / dangeroustech/StreamDL
feat(qsv): document and expose Intel /dev/dri device passthrough
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 19
- Forks
- 0
- Avg merge
- 29m
- Merged PRs (30d)
- 1
Description
Goal
Opt-in Docker Compose / docs so operators can pass /dev/dri (Intel Quick Sync / VAAPI render node) into the StreamDL client container.
Context
Parent epic: #452
This is Phase 1 of Quick Sync support. Device passthrough alone does not enable QSV with the current mwader/static-ffmpeg client image — that lands in #608. This issue only makes the ops surface honest and ready.
Scope
- Extend
docker-compose.yml.examplewith a commented, opt-indevices:(+ optionalgroup_addforvideo/render) on the client service - README: host prerequisites (
/dev/dri/renderD*), finding GIDs, PUID/PGID interaction, and clear note that a QSV-capable FFmpeg is still required (#608) - No Dockerfile / default behavior change
Out of scope
- QSV-capable FFmpeg image (#608)
- First-class
FFMPEG_HWACCELknobs (#609) - NVIDIA / AMD
Depends on
- None (first slice of #452)
Blocks
- #608
- #609
Acceptance
- Compose example documents opt-in
/dev/dripassthrough - README covers host setup and limitations with static FFmpeg
- Default install path unchanged (no required devices)
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading docker-compose.yml.example and the README sections covering container setup and hardware requirements. Document an opt-in /dev/dri passthrough with optional video/render group access, host prerequisites, GID and PUID/PGID considerations, and the static FFmpeg limitation. Done means the default install remains unchanged and all three acceptance points are covered.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, docker-compose
- Domain
- devops, documentation, infrastructure
- Issue type
- Feature
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 78/100