Video Support

PicPeak supports uploading and displaying videos alongside photos in event galleries.

Supported formats

Enabling video

Video is off by default: the Allowed File Types list ships as jpg,jpeg,png,webp. Add the video extensions you want to accept, for example:

jpg,jpeg,png,webp,mp4,mov,webm

That single list governs the admin upload screen, the admin chunked-upload API and guest uploads. Until the extensions are added, the upload screen hides video files in its picker and the chunked API answers 400 File type not allowed — the MIME type a request declares does not override the list.

Upload limits

• Per-file cap: Max Video Size (MB) in General settings (default 500 MB), separate from the photo cap. Raise it, and the reverse-proxy body limit below, for long recordings.
• Large files go through the admin chunked-upload API (10 MB chunks, resumable per chunk) — see Photos API.

Thumbnail generation

Video thumbnails are automatically extracted from the first few seconds of each video using FFmpeg. FFmpeg is bundled via npm (@ffmpeg-installer/ffmpeg) --- no system installation is required.

Resource requirements

Reverse proxy configuration

If using Nginx as a reverse proxy, increase the body size limit and timeouts:

client_max_body_size 10G;
proxy_read_timeout 3600;
proxy_send_timeout 3600;

Without these settings, large video uploads will be rejected by the proxy before reaching PicPeak.