Using it

Images and video

A video saved as one picture per frame looks the sharpest and most colorful, and needs nothing extra on the server.

  1. Upload the video at ezgif.com/video-to-png, set the frame rate to 20, then convert.
  2. Download the frames as a ZIP and drop it into videos/ as promo.zip. There is no need to unzip it.
  3. For sound, also drop the original promo.mp4 next to it. The frames supply the picture and the MP4 supplies the sound.

If you made the video yourself, export a PNG or image sequence from your editor at 20 fps into a folder such as videos/promo/. Number the files with leading zeros (frame_0001.png, frame_0002.png) because frames play in file-name order. If the video is not 20 fps, add an fps.txt containing just the number.

Also works#

  • .mp4 .webm .mov .mkv .avi: a little softer, because they are compressed.
  • .gif: 256 colors, so it is the least sharp.
  • To give a GIF or a frame folder sound, add an audio file with the same name, for example promo.gif plus promo.mp3. A .ogg, .mp3 or .wav next to a video also replaces the video's own sound.

After adding files, run /ha pack rebuild. Only new or changed files are converted. The pack is rebuilt and sent to everyone online, and players re-download it only when it actually changed. The rebuild also runs on server start and on /ha reload. Use /ha video list to see converted videos with their resolution, fps and audio.

No ffmpeg, but you want sound?

Give the video a mono .ogg of the same name (in Audacity: File, Export, OGG, mono). Stereo plays, but it does not fade with distance.

A HOW-TO-ADD-VIDEOS.txt guide is written into the videos/ folder. While media converts, admins with hyperads.admin see a live progress bar above the hotbar (admin-progress-bar).