To ensure your videos stream perfectly without buffering, freezing, or dropping offline, they must be formatted to exact technical specifications before uploading to your playlist. Our WebTV Hosting servers require a uniform 720p format to seamlessly transition from one video to the next without crashing the player.
Please use the following exact settings when exporting or converting your video files.
Required Video & Audio Specifications #
Video Settings #
- Container: MP4 (
.mp4) - Video Codec: H.264 (x264)
- Resolution: 1280×720Crucial: If your video is a different aspect ratio (like a vertical smartphone video or a widescreen movie), you must add black bars/letterboxing to pad it out to exactly 1280×720.
- Framerate: 30 FPS (Strictly Constant Framerate, not Peak/Variable)
- Quality / Bitrate: Constant Quality (CRF/CQ) set to 23, with a strictly capped Maximum Bitrate of 2500 kbps.
- Keyframe Interval (GOP): Exactly every 60 frames (2 seconds).
- Color Space (Pixel Format): 8-bit YUV 4:2:0 (
yuv420p) - Profile / Level: Main / 4.1
Audio Settings #
- Audio Codec: AAC
- Bitrate: 128 kbps
- Sample Rate: 48000 Hz (48 kHz)
Strict Filename Rules #
Web server playlists will fail if they read invalid characters in a file path. Your filenames must only contain uppercase/lowercase letters, numbers, underscores (_), and hyphens (-).
Do not use spaces, ampersands (&), parentheses, brackets, apostrophes, exclamation points, or any other special symbols.
- ❌ Bad:
My Promo Video (Final!).mp4 - ❌ Bad:
Big_&_Rich_Live_Show'.mp4 - ✅ Good:
My_Promo_Video_Final.mp4 - ✅ Good:
Big_and_Rich_Live_Show.mp4
Short on Time? Let Us Encode Your Files For You! #
If you have a large library of files, or if configuring desktop encoder settings feels overwhelming, let our team handle it for you.
We offer an on-demand Media Optimization Service for our current WebTV clients. You simply upload your raw video files, and we will run them through our enterprise servers to fix the resolutions, inject strict keyframes, clean up illegal characters, and hand you back 100% compliant, playlist-ready .mp4 files.
- Simple Pay-As-You-Go Pricing: Only $9.99 for the first 5 GB of source files, then $1.00 per extra GB.
- Save Hours of Rendering Time: Free up your local computer and let our servers do the work.
- 100% Stream Guarantee: Zero buffering, zero player crashes, and seamless video transitions.
Guide 1: How to Encode Using Shutter Encoder (Recommended) #
Shutter Encoder is a free, professional tool built on FFmpeg that handles our playlist padding and layout constraints perfectly.
- Download and install Shutter Encoder.
- Drag and drop your video files into the main window.
- Under Choose function, select
H.264. - On the right panel under Bitrates, click the
VBRbutton until it toggles toCQ(Constant Quality), and set the slider value to23. - Open the Audio settings panel, ensure the codec is
AACand change the bitrate to128. - Open the Image scale panel, check the box, select
1280x720, and chooseLetterboxin the adjacent dropdown. (This automatically adds black bars if your video isn’t natively 16:9). - Open the Advanced features panel:
- Check Conform by, select
Drop/duplicate frames, and choose30 i/s. - Check Force profile and select
Mainto4.1. - Check Colorspace and select
YUV 4:2:0. - Check GOP and type
60into the box. - Check Add custom parameters and paste this exact text block:Plaintext
-maxrate 2500k -bufsize 5000k -sc_threshold 0 -keyint_min 60
- Check Conform by, select
- Click Start function at the bottom to process your files.
Guide 2: How to Encode Using HandBrake #
HandBrake is an open-source alternative, but you must manually configure it so it does not automatically crop out black bars to “save space.”
- Download and install HandBrake.
- Open your file and go straight to the Dimensions tab.
- Set Resolution Limit to
Customand type1280x720. - Set Cropping to
Customand make sure Top, Bottom, Left, and Right are all exactly0. - Check the Pad or Fill option to ensure the “Display Size” metric at the bottom reads exactly
1280x720.
- Set Resolution Limit to
- Go to the Video tab:
- Select Video Encoder:
H.264 (x264). - Set Framerate (FPS):
30and click the radio button forConstant Framerate. - Set Constant Quality:
23 RF. - In the Advanced Options text area at the bottom of the tab, paste this exact parameter string:Plaintext
vbv-maxrate=2500:vbv-bufsize=5000:keyint=60:min-keyint=60:scenecut=0
- Select Video Encoder:
- Go to the Audio tab:
- Set Codec:
AAC - Set Bitrate:
128 - Set Mixdown:
Stereo - Set Samplerate:
48
- Set Codec:
- Choose your destination file directory and click Start Encode.