* feat(transcode): decode and scale on the GPU for VA-API transcodes
When the selected encoder is h264_vaapi, decode with -hwaccel vaapi and
scale with scale_vaapi so frames stay in GPU memory, instead of decoding
and scaling on the CPU and hwupload-ing before the encoder. On a Haswell
iGPU this makes 4K proxy/HLS renditions 3-5x faster.
Fallback order: GPU decode + VA-API encode -> software decode + VA-API
encode (previous behavior) -> libx264. Watermark overlays, HDR sources
and rotated sources skip GPU decode: ffmpeg cannot auto-insert its
rotation filter on hardware frames, so rotated input would otherwise come
out sideways instead of failing. SHUMAI_VAAPI_HW_DECODE=false disables it.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* docs(transcode): document VA-API GPU decoding and SHUMAI_VAAPI_HW_DECODE
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
* refactor(transcode): generic hardware decode config, stall watchdog, reuse probed rotation
Follow-ups from comparing with Immich and Jellyfin:
- Replace the VA-API-specific helpers with a per-encoder HW_DECODE_CONFIGS
table (input args, output args, GPU scale filter) and build the MP4 and
HLS input/filter graph in one shared method so the paths cannot drift.
Only h264_vaapi has an entry; other backends can be added once tested on
real hardware. The opt-out is now SHUMAI_HW_DECODE=false.
- Kill a GPU-decode attempt with SIGKILL when its output stops growing for
SHUMAI_HW_DECODE_STALL_TIMEOUT (default 120s) and fall back, since some
VA-API driver failures hang ffmpeg instead of exiting (immich#31933).
- Add -noautoscale on the GPU-decode path so a mid-stream decoder reinit
(e.g. 1080 -> 1088) cannot auto-insert a software scaler into the GPU
graph (jellyfin#17133).
- Pass the rotation already probed into MediaMetadata through the workflow
and activities as sourceRotation; ffprobe only runs when it is missing.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
* fix(transcode): avoid selecting attached picture streams for video transcoding
Filter out attached picture streams (disposition.attached_pic) during video probing and stream selection, matching Immich's default and bitrate selection strategy. Forward explicit primary video and audio stream indices to FFmpeg pipelines to prevent picking embedded cover art or thumbnail streams.
* fix(transcode): skip poster and sprite generation for audio-only assets and add multi-stream e2e tests
* test(workflow): scope pixel format to h264 stream and use yuvj420p for mjpeg cover art
* feat(transcode): add HDR output proxy support
* fix(transcode): auto-detect MoltenVK Vulkan ICD on macOS for libplacebo filters
* fix(transcode): split filter in generateSprite to ensure poster uses tone-mapped stream
* docs(changelog): update docs/changelog.mdx and ignore in prettier
* fix(transcode): respect video rotation metadata to preserve display aspect ratio
* fix(webui): render native video with hardware EDR acceleration instead of 2D canvas
* fix(webui): show HDR label on mobile video control bar
* fix(share): preserve hdr flag on watermarked video transcodes
* fix(webui): differentiate HDR download options in video player
* fix(transcode): handle Dolby Vision Profile 5 via standard HDR pipeline without libplacebo
* fix(transcode): prepend setparams filter to prevent zscale colorspace path error for DV P5
* refactor(transcode): simplify HDR proxies to always produce HDR without SDR setting
* fix(transcode): preserve trashed status during background jobs and handle permanent purge
* fix(workflow): clear heartbeat and add info logs on task cancellation
* fix(transcode): terminate media processes and guard task activities on cancellation
- Pass AbortSignal to ffmpeg and pdftoppm child processes in transcodeService to terminate processes on task cancellation
- Add local task AbortController context and cancellation guards in executeActivity to prevent subsequent workflow activities
- Forward taskId and cancellation signals in transcode, screenshot, and PDF activities
- Use updateMany instead of update in task activities to eliminate Prisma P2025 errors on purged task records
* fix(workflow): allow cleanup activities in finally blocks during task cancellation
Remove blanket cancellation check in executeActivity so that workflows can execute cleanup and failure handling activities in catch and finally blocks upon cancellation, while relying on AbortSignal in active activities to abort execution.
* docs(changelog): improve user friendliness of changelog entries and formatting example
* docs(agents): update changelog guidelines to emphasize end-user friendly descriptions
* fix(transcode): handle queued cancellation and delete races in media workflow
* feat(premiere-uxp): use native Bun bundler and build script instead of Vite
* feat(premiere-uxp): switch FileListView to use Search API consistent with WebUI
* feat(premiere-uxp): add on-demand jpeg preview conversion for uxp compatibility
* feat(premiere-uxp): integrate spectrum web components (swc)
* fix(premiere-uxp): align swc packages with 0.37.0 and fix auth layout
* feat(premiere-uxp): use horizontal 2-column card view for projects and files
* style(premiere-uxp): enlarge file preview by 20% and add row padding
* fix(premiere-uxp): prevent card squishing and overflow with large item counts
* fix(premiere-uxp): change host in manifest to single object
* docs(premiere-uxp): add AGENTS.md with SWC preferences and UXP layout rules
* feat(premiere-uxp): integrate spectrum web components across plugin views
* fix(premiere-uxp): remove breadcrumb icons and use slash separator
* feat(premiere-uxp): add collapsible folder and file sections with infinite scroll
* feat(premiere-uxp): update file card layout with right column info and clean preview
* fix(premiere-uxp): use raw text for file card details and fix black icons
* style(premiere-uxp): use contain object-fit and black background for file card preview
* fix(premiere-uxp): refine header logo, sticky title bars, circular badges, and controls
* fix(premiere-uxp): replace stroke icons with spectrum workflow icons
* fix(premiere-uxp): switch icon buttons to swc sp-button with icon-only and slot=icon
* fix(premiere-uxp): vertically center endpoint text in header
* feat(premiere-uxp): add asset and proxy import support into Premiere Pro
- Implement context menu on file cards with left-click, right-click, and more action button triggers
- Support raw file import for non-video assets and video assets
- Support video proxy submenu listing ready transcode resolutions
- Add UXP native file picker save dialog and binary download orchestration
- Call Premiere Pro project.importFiles API to import downloaded assets into active project
- Add non-blocking toast notification banner for progress and status reporting
- Add unit tests for premiere host service and import orchestration
* fix(premiere-uxp): anchor import menu directly to file card using sp-action-menu
- Replace custom fixed-position ContextMenu with native SWC sp-action-menu
- Anchor menu directly to the triggered file card rather than the top-left window corner
- Support programmatic opening on file card click/contextmenu via imperative handle
- Support video submenu with Original and ready proxy options inside sp-action-menu
- Lazy load video proxies on menu open or hover
- Clean up obsolete fixed-position styles and unused backdrop overlays
* fix(premiere-uxp): align SWC packages to 0.37.0 and guard custom element registry
- Downgrade action-menu and menu SWC packages to 0.37.0 to match the rest of the workspace
- Eliminate duplicate icons-ui and sp-icon-chevron100 customElements.define calls
- Add polyfill guard to customElements.define to prevent duplicate registration errors during UXP reload
* fix(premiere-uxp): polyfill window.matchMedia for Adobe UXP
- Add window.matchMedia polyfill in polyfills.ts
- Satisfies SWC MatchMediaController used by ActionMenu and PickerBase in UXP
- Prevents TypeError when opening files page
* feat(premiere-uxp): replace context menu with card download action and video import dialog
* fix(premiere-uxp): resolve download url before save, pass null targetBin, and center download icon
* fix(premiere-uxp): resolve raw download url via download-url endpoint with fallback
* feat(premiere-uxp): use native folder picker and auto-increment conflict suffixes
* feat(premiere-uxp): add sequence linking, comment-marker sync, and navigation tabs
- Add sequence-to-asset linking with persistent project metadata storage
- Support one-way comment-to-marker timeline synchronization
- Add two-tab navigation (Sequences and Browse) using Spectrum buttons
- Add LinkSequenceDialog, SequencesView, and autoSyncService background engine
- Enforce Spectrum Workflow Icons and UXP layout rules
* feat(premiere-uxp): refine UI layouts, card interactions, and search box activation
* fix(premiere-uxp): set compact fixed width for file list search box
* fix(premiere-uxp): ensure search box click activation across full width in UXP
* fix(premiere-uxp): revert search box hacks and restore simple default sp-search layout
* feat(premiere-uxp): sync non-timestamped comments as markers at time 0
* feat(premiere-uxp): change link icon to unlink when asset is linked in file card
* fix(premiere-uxp): sync linked sequences between host project and browse view
* feat(premiere-uxp): remove synced markers on sequence unlink matching Frame.io
* fix(premiere-uxp): ensure reliable marker GUID capture, normalization, and fallback on unlink
* fix(premiere-uxp): use official Shumai logo for plugin manifest icons
* fix(premiere-uxp): use official PNG icons for manifest and plugin entrypoints
* refactor(premiere-uxp): use single 114x114 icon for plugin and panel
* feat(premiere-uxp): show file version in file list page file card
* build(premiere-uxp): check in built ccx package and update packaging configuration
* fix(premiere-uxp): address code review findings for media conversion, marker sync, and link scoping
- Reset hasJpegCover on project cover update and hasJpegPreview on asset media transcode
- Only advance synced comment metadata after confirmed marker transaction
- Normalize GUID keys and lookups in AutoSyncService map
- Restrict cached sequence link lookups to project-specific keys and prevent cross-project leakage on empty sequences
- Update built CCX distribution package
* feat(transcode): optimize video operations using ffmpeg http range requests
* fix(transcode): preserve non-retryable errors and ensure mapConcurrent settles on rejection
* feat(transcode): add hardware-accelerated video transcoding support
* feat(transcode): use encoder quality modes and source-capped maxrate for video transcode
* fix(transcode): scale max bitrate for downsampled preview framerates
* fix(transcode): propagate videoBitRate in getMediaInfoActivity and update auto description
* feat(transcode): add Gotenberg support for Office, HTML, CSV, and Markdown PDF proxies
* fix(transcode): use Gotenberg chromium markdown endpoint with index.html wrapper for markdown conversion
* test(transcode): add complete unit test coverage for HTML, CSV landscape/portrait, TXT, and Gotenberg fallback branches
* fix(gotenberg): force .md extension for Gotenberg markdown conversion endpoint compatibility
* refactor(gotenberg): standardize basic auth environment variables on GOTENBERG_BASIC_AUTH_USERNAME and GOTENBERG_BASIC_AUTH_PASSWORD
* test(e2e): add real Gotenberg testcontainers workflow E2E test for docx, pptx, and xlsx
* docs: add Gotenberg document PDF conversion documentation and update features in README
* docs(gotenberg): add Docker quickstart commands and remove obsolete GOTENBERG_USERNAME note
* feat(webui): remove original-file display fallbacks, use proxies only
WebUI now never uses the raw original file for display. All viewers
(image, video, compare, pdf) render exclusively from transcoded proxies;
when no proxy exists the viewer shows an unavailable placeholder instead
of falling back to media.original.
- getBestTranscode: drop the isRaw fallback candidates
- video-viewer / compare-video-pane: remove the synthetic 'Original'
resolution entry and the original.downloadUrl hasMedia gate
- image-viewer / compare-image-pane: remove original.downloadUrl default
- pdf-viewer: require pdfTranscode.url (no original fallback)
- download menus (video-control-bar, breadcrumb-nav): use
media.original.key for the 'Original' download option instead of the
isRaw transcode marker entry
Backend:
- transcode-video workflow no longer pushes the isRaw:true marker entry
into videoTranscodes (it pointed at the original file key)
- remove media.original.downloadUrl from the DTO, asset service mapping,
MediaInfo DB type, and transcode workflows/activities (it was only
consumed by the removed display fallbacks; downloads already use key
via the download-url endpoints)
Tests/fixtures updated; docs updated to state the proxy-only display
policy.
* refactor: remove isRaw field via data migration, clean legacy media JSON
Add a Prisma data migration that cleans legacy media JSONB on both
assets and watermark_files:
- drop the raw-original marker entries (isRaw: true) from
videoTranscodes / imageTranscodes — they pointed at the original file
key and were only used by the removed display fallbacks / download
menus, which now use media.original.key directly
- strip the isRaw field from remaining transcode entries
- drop original.downloadUrl (removed from the AssetInfo DTO)
The migration is generated via prisma migrate dev --create-only and
applied automatically by migrate deploy in production. It is guarded by
a test (packages/db/src/clean-media-migration.test.ts) that seeds legacy
media JSON, runs the migration SQL, and asserts the transform on both
tables.
With the data cleaned, remove the isRaw field entirely from the codebase:
- DTO schemas + ImageTranscode/VideoTranscode interfaces
- PrismaJson MediaInfo transcode types
- watermark activity isRaw skip (and its test), watermark proxy mapping,
agent-embedding transcode selection, webui transcode filters, and all
test fixtures
AGENTS.md: clarify that the no-manual-migration rule applies to DDL;
data migrations (pure SQL transforms, no schema change) are allowed
inside a --create-only generated migration and must be tested.
- Store uploaded files as files/{ulid}/{original-name} instead of files/{ulid}/raw
- Store transcoded videos as {stem}-{resolution}.mp4 (e.g. foo-720p.mp4)
- Store transcoded images as {stem}-{width}p.webp (e.g. foo-1920p.webp)
- Add download?: boolean param to presign - only sets Content-Disposition: attachment when true
- Local storage handler only sets Content-Disposition when ?download=1 query param is present
- Add POST /api/files/download-url endpoint for key-based single file downloads
- Uses ResourceType.Asset for permission check
- Validates key belongs to the asset's storage directory
- Fix existing download-links API to pass download: true to presign
- Fix breadcrumb navbar download: video shows resolution submenu, others download directly
- Fix video player download: calls download-url API, shows correct file type label
- Remove filename query param hack from presign URLs
- Add sanitizeFilename() and stemFromKey() utility helpers
- Add key field to VideoTranscode DTO interface
Splits monolithic workflow workers into four decoupled workspaces under the Bun workspaces monorepo:
- @shumai/workflow-core containing the core execution engine and utilities.
- @shumai/agent containing agent-specific logic, workflows, and activities.
- @shumai/transcode containing transcoding workflows, transcoder, and transcode activities.
- @shumai/worker-db containing database activities.
Introduces a dynamic workflow and activity registration pattern on LocalExecutor to eliminate circular dependencies. Updates worker bootstrapping and test suites to cleanly leverage generic workspace modules.