Video conversion
Setting up FFmpeg, choosing resolutions and file size, the live conversion queue, keeping disk space free and moving files to an FTP file server.
With FFmpeg on the server, every upload is encoded into the resolutions you choose and gets a thumbnail and seek-bar pictures. Without FFmpeg, videos play as they were uploaded. Everything here is on Admin → Media & FFmpeg.
Setting up FFmpeg
The site needs both ffmpeg and ffprobe, and PHP must be allowed to start a program (proc_open, exec or shell_exec). The FFmpeg card says what it found:
- Found both tools - with the version lines. You are ready.
- Could not run ffmpeg / ffprobe - type the full paths into Path to ffmpeg and Path to ffprobe. On most cPanel servers they are
/usr/bin/ffmpegand/usr/bin/ffprobe. Leave them empty when the tools are on the system PATH. - This server does not let PHP start another program - no conversion is possible; ask your host to allow one of those functions, or upload MP4 files only.
Then tick Convert uploads automatically (it is off on a new install) and Save.
Resolutions to make
Tick the sizes under Resolutions to make: 2160p (4K), 1440p (2K), 1080p (Full HD), 720p (HD), 480p, 360p and 240p. A new install makes 720p, 480p and 360p. A video is never made bigger than it arrived: a 480p upload only produces 480p and below. Each size is saved next to the original as name_720p.mp4.
A package can cap this with Highest resolution made, and Converted first puts its members' uploads at the front of the queue (Admin → Packages).
File size
| Mode | What you get |
|---|---|
| Fastest - bigger files | For a slow server with a long queue. Files come out somewhat bigger. |
| Balanced (recommended) | Quick and still small. A size the upload already is, at a low enough bitrate, is copied in seconds instead of encoded again. |
| Small files | Every size encoded afresh for the smallest file; two to three times as long as Balanced. |
| Smallest files | Slowest, and noticeably softer in busy scenes. For a site short of disk or bandwidth. |
Every mode keeps the resolution. Each size has a bitrate ceiling (1080p about 4 Mbit/s, 720p 2.2, 480p 1.1, 360p 0.65), never above the upload's own. Extra audio tracks and subtitles are left out; an encode that would come out bigger than the original is replaced by a copy of it. Fine-tune the quality moves every size sharper or softer.
The other switches
| Setting | What it does |
|---|---|
| Start straight away | Starts a background worker as soon as an upload lands, instead of waiting for cron. Needs Path to php (for background jobs) when php is not in the usual place. |
| Take a thumbnail | Grabs a frame when the uploader chose no picture. Thumbnail second: -1 takes the frame a tenth of the way in. |
| Pictures on the seek bar | Makes a strip of small frames (uploads/storyboards/), so resting the pointer on the seek bar shows that moment. |
| Keep the original file | Off deletes the original once the sizes are made. Saves disk, but the original quality is gone for good. |
| Carry on after a stop | Encodes in short pieces, so a restart or time limit does not start the video over. |
| Do not encode what is already small | Copies an H.264 upload that is already lean for its size. Used by Fastest and Balanced. |
| Give way to the website | Runs FFmpeg at low priority, so pages stay quick. |
| While people are on the site, conversion may use | On shared hosting: the share of time the encoder may run while pages are being opened (Half is recommended). Not used on Windows or where PHP cannot signal a program; the page says so. |
| Quick things first | Thumbnail and seek-bar pictures first, then the sizes smallest first, so a video plays early. |
| Frame rate | 30 frames a second at 480p and below. |
| Processor cores | 0 lets FFmpeg decide; 1 or 2 on shared hosting. |
| Keep free on the disk (MB) | Default 300. With less free, conversion waits instead of filling the disk, and the admin bell says so. |
| Jobs per run | How many conversions one worker does before it stops. |
The queue
The card Conversion, live at the top refreshes itself: what is converting now (size, progress, time left), what is up next, what failed and why, and what finished lately. Beside each job: Stop, To the front, Remove, Try again or Convert again. Above the lists:
- Start converting now - starts a worker in the background.
- Convert one here - one job inside this page; fine for a short clip.
- Queue everything that is missing - adds the missing sizes of older or migrated videos. A video whose file is not on this server is skipped.
- Try every failed one again, Read missing lengths, Clear finished.
Admin → Videos has the same thing for chosen videos: the bulk action Make the missing resolutions. Members see the state in their Studio (Processing..., Waiting to process, Processing failed).
Keeping the queue moving
The one cron line from Admin → Cron jobs runs the Video conversion job every two minutes (see Scheduled jobs). The Media page says so too, and keeps only a web address with a key (Make a new key replaces it) for a host that runs nothing but web addresses and wants the encoder on a line of its own; with the main cron line in place you do not need it.
Where the files are kept
Since 1.19.0 the FTP file server is part of the Storage & FTP Upload plugin, which also keeps the files on SFTP, Amazon S3 and S3-compatible stores, Google Drive or another disk - see Storage & FTP Upload. A site that used the file server before finds the plugin switched on after the update, with the same settings. The Media page shows where the files are kept and links to it.
The original of a new upload is sent to the store only when all its sizes are made.