Video Processor Settings
What This Page Does
This page is your control center for how videos are processed and displayed on your site. You can control video quality, create thumbnails, add watermarks, set up advertising, and customize the video player experience. Think of it as the settings page that determines everything about how videos look and work for your visitors.
[Screenshot: page-overview]
How to Get Here
Navigate to Admin Panel > Videos > Processor Settings
Understanding the Page
When you first open this page, you'll see a status dashboard at the top showing how many videos are currently being processed, how many are waiting in the queue, and if there are any issues. Below that, you'll find five tabs that organize all the settings.
Status Dashboard
At the top of the page, you'll see four boxes showing:
- Processor Status - Whether the video processor is running or idle
- Active Jobs - Videos currently being processed right now
- Pending Jobs - Videos waiting to be processed
- Failed Jobs - Videos that had errors in the last 24 hours
The Five Tabs
The page is organized into five main sections:
- Processing Settings - Controls video quality, thumbnails, and how videos are converted
- Pre-Roll & Post-Roll - Videos that play before or after your content
- Video Overlays - Watermarks that are permanently added to your videos
- Video Player - How the video player looks and works on your site
- Video Player Ads - Advertising settings and options
Common Tasks
How to Adjust Video Quality Settings
The quality settings determine how your videos look and how much storage they use.
- Click the Processing Settings tab at the top.
- Scroll down to find Video Conversion Settings.
- Adjust the Max Video Bitrate - higher numbers mean better quality but larger files (5000 is a good balance).
- Set Max Audio Bitrate - 192 is usually perfect for most videos.
- Scroll to the bottom and click Save Settings.
- Click Yes when asked to confirm.
How to Enable High-Quality Adaptive Streaming
Adaptive streaming automatically adjusts video quality based on your viewer's internet speed.
- Go to the Processing Settings tab.
- Scroll down to HLS Adaptive Streaming Settings.
- Check the box next to Enable HLS Adaptive Streaming.
- Set Minimum Source Height to 720 (this only enables streaming for HD videos).
- In the Active HLS Resolutions box, enter which qualities you want: type
hd,high,medium,lowfor all options. - Click Save Settings at the bottom.
How to Set Up Thumbnail Generation
Thumbnails are the preview images visitors see when browsing videos.
- Open the Processing Settings tab.
- Find the Thumbnail Generation Settings section.
- Set Thumbnail Count to how many preview images you want per video (5-10 is good).
- Adjust Thumbnail Width and Thumbnail Height if needed (320x180 works for most sites).
- Set Poster Width and Poster Height - this is the main preview image (1280x720 is standard HD).
- Check Enable Animated Preview to create GIF previews.
- Check Generate Video Sprites to enable timeline preview when hovering.
- Click Save Settings.
How to Choose Thumbnail File Formats
You can generate thumbnails in JPG format, modern WebP format, or both.
- In the Processing Settings tab, scroll to Thumbnail Image Format Settings.
- In the Thumbnail Formats box, type one of these:
- Type
jpgfor universal compatibility - Type
webpfor smaller file sizes - Type
bothto generate both formats
- Click Save Settings.
How to Configure Animated GIF Previews
Animated GIFs give visitors a quick preview when hovering over thumbnails.
- Go to the Processing Settings tab.
- Scroll to Animated GIF Settings.
- Set Animated GIF Duration to how long the preview should be (3-5 seconds works well).
- For a preview that shows clips from throughout the video:
- Check Use Segmented Animated GIF
- Set Animated GIF Segments to 3-5
- Set Animated GIF Start Offset to skip intro sections (10 seconds is typical)
- Click Save Settings.
How to Add a Video That Plays Before Your Content
Pre-roll videos play before every video on your site - perfect for intros, warnings, or advertisements.
- Click the Pre-Roll & Post-Roll tab.
- Under Upload New Pre-Roll Video, click Choose File.
- Select an MP4 video from your computer.
- Leave Activate immediately checked if you want it to start working right away.
- Click Upload Pre-Roll Video.
The pre-roll will now appear at the beginning of all newly processed videos. Videos that were already processed won't change.
How to Remove Pre-Roll or Post-Roll Videos
- Go to the Pre-Roll & Post-Roll tab.
- Find the video you want to remove under Current Pre-Roll Video or Current Post-Roll Video.
- Click the Delete button.
- Click Yes, Delete to confirm.
New videos will no longer include the pre-roll or post-roll. Existing videos keep it until they're reprocessed.
How to Add a Watermark to All Videos
Video overlays are watermarks that get permanently added to your videos during processing.
- Go to the Video Overlays tab.
- Choose whether you want to add an image or text watermark.
- For a text watermark:
- Type a name in Overlay Name (like "Copyright Notice")
- Choose a Position from the dropdown (bottom-right is common)
- Type your watermark text in Text Content
- Choose a Font Color (white works on most videos)
- Adjust Font Size (18-24 is readable but not intrusive)
- Check Enable Text Shadow to make it easier to read
- Set Opacity to 0.5-0.8 (lower numbers make it more transparent)
- For an image watermark:
- Type a name in Overlay Name (like "Logo Watermark")
- Click Choose File under Upload Image and select a PNG file
- Choose a Position from the dropdown
- Set Opacity to 0.5-0.8
- Leave Activate immediately checked.
- Click Create Overlay.
How to Add Player Branding
Player branding is different from video overlays - it's a logo or text that appears on top of the video player, not burned into the video file.
- Click the Video Player tab.
- Scroll down to Video Watermark / Branding.
- Check Enable Watermark.
- Choose Text or Image from the dropdown.
- For text branding:
- Type your brand name in Watermark Text
- Choose a Text Color
- Select a Font Family
- Adjust Font Size (14-20 works well)
- For image branding:
- Type your logo URL in Image URL (must be a PNG file with transparency)
- Choose where it appears using the Position dropdown.
- Set Opacity (0.3-0.5 is subtle but visible).
- Check Fade on Hover to make it less intrusive.
- Click Save Watermark Settings.
How to Limit How Many Videos Users Can Watch
You can set daily and monthly limits to encourage users to register or upgrade.
- Go to the Video Player tab.
- Scroll down to Video View Limits & Access Control.
- Set limits for free users:
- Free Daily Limit - how many videos per day (try 5)
- Free Monthly Limit - how many videos per month (try 50)
- Set limits for premium members:
- Premium Daily Limit - try 20
- Premium Monthly Limit - try 200
- Click Save View Limits.
How to Customize the Upgrade Message
When users hit their view limit, they see a popup message. You can customize what it says and how it looks.
- In the Video Player tab, scroll to Upgrade Prompt Customization.
- For free users, edit:
- Title - the heading (like "Daily Limit Reached")
- Message - the body text (you can use
{views_used}and{limit}to show numbers) - Background Color - the popup color (you can use gradients)
- Do the same for premium users.
- Customize the buttons:
- Register Button - for free users to create an account
- VIP Button - to upgrade to premium
- Set the text, colors, and URLs for each button
- Click Save Customization.
How to Change the Video Player Sidebar
The sidebar shows related videos next to the player. You can control what it looks like.
- Go to the Video Player tab.
- Scroll to Playlist & Sidebar UI Customization.
- Adjust thumbnail sizes:
- Thumbnail Width - try 120 pixels
- Thumbnail Height - try 68 pixels
- Choose colors:
- Background Color - the sidebar background
- Item Hover Color - what happens when you hover
- Selected Gradient Start/End - the currently playing video
- Customize the duration badges (the time labels on thumbnails).
- Adjust the scrollbar colors to match your site.
- Set Sidebar Width (300-400 pixels works well).
- Click Save Playlist UI Settings.
How to Set Up Video Advertising
You can show video ads before, during, or after your videos.
- Click the Video Player Ads tab.
- Check Enable Video Ads at the top.
- Enter your VAST Tag URL - you get this from your advertising provider.
- Under Ad Placement, check which types of ads you want:
- Enable Pre-Roll - ads before the video starts
- Enable Mid-Roll - ads during the video
- Enable Post-Roll - ads after the video ends
- If you enabled mid-roll, set when it appears:
- Use Mid-Roll Time to show it at a specific second
- Or use Mid-Roll Percentage to show it at 25%, 50%, etc.
- Set Skip Button Delay to how many seconds before viewers can skip (5 is standard).
- Click Save Ad Settings.
How to Test Your Video Processing Settings
After changing settings, it's important to test that everything works.
- Upload a test video through Admin Panel > Videos > Upload Video.
- Wait for it to process (check the status dashboard at the top of this page).
- Once it shows "Active Jobs: 0", go view the video on your site.
- Check that:
- Thumbnails generated correctly
- Video plays smoothly
- Quality options appear (if you enabled adaptive streaming)
- Watermarks appear in the correct position
- Any ads or overlays work as expected
- If something doesn't work, return to this page and adjust the settings.
Understanding Player Features
The Video Player tab includes a section called Player Features & Mode Configuration. This lets you turn features on or off separately for the public site (Frontend) and the admin panel (Backend).
新用户提示
- 简单开始:不要马上启用每个功能. 从基本的缩略图生成和视频质量开始,然后根据需要添加功能.
- 先用短视频测试: 使用30秒的测试视频来验证您的设置工作,然后处理长视频库.
- 监视器存储:可适应流和多缩略图格式使用更多的存储. 注意您的服务器磁盘空间 。
- 节节使用预滚动:长的预卷视频让用户恼火. 保持在10秒以内,否则让用户跳过.
- 水印放置事项:右下角最不侵扰. 避免中心位置阻碍动作
- 逐步设定视图限制:开始慷慨(每天10-20个)并基于用户行为进行调整.
解决问题
视频没有被处理
你看到的东西: 你上传了一段视频,但是它永远停留在"Pending"状态下.
如何修补:
- 请检查date=中的日期值 (帮助) 本页面上方的状态仪表板. 如果上面写有"Idle"或显示0个活动任务,处理器可能不会运行.
- 联系您的主机提供者或服务器管理员 - 它们需要启用视频处理系统 。
- 如果"失败的工作"在增加,处理设置存在问题. 尝试降低质量设置或损坏 HLS 。
拇指没出现
你看到的东西: 视频处理成功但没有缩略图图像.
如何修补:
- 转到 处理设置 选项卡并滚动到 缩略图生成设置。 。 。 。
- 确保 缩略图数 设置为至少 5(不是 0) 。
- 检查 启用动画预览 和 生成视频Sprites 如果您想要这些特性, 请选中 。
- 点击 保存设置 并尝试上传新的测试视频。
视频质量差或模糊
你看到的东西: 处理过的视频看起来比你上传的原始文件更糟糕.
如何修补:
- 打开 处理设置 选项卡。
- 滚动至 视频转换设置。 。 。 。
- 增加 最大视频比特率 给8000或10000。
- 滚动至 MP4 编码设置。 。 。 。
- 变动 MP4 通用报告格式质量 改为20或21(更低的数字=质量更佳)。
- 点击 保存设置。 。 。 。
现有视频不会改进——只有新上传的视频才会使用新设置.
水印没有出现在视频上
你看到的东西: 你创造了个水印,但视频上没有显示
如何修补:
- 转到 视频重叠 选项卡。
- 在底部的列表中找到您的水印 。
- 检查是否 状态 说"主动" - 如果它说"不主动",点击 启动。 。 。 。
- 注意:水印只出现在新处理的视频上. 旧视频不会有水印 除非你重新处理它们。
玩家品牌没有显示
你看到的东西: 你设置了玩家品牌,但看视频时看不到.
如何修补:
- 转到 视频播放器 选项卡。
- 滚动至 视频水印/品牌。 。 。 。
- 确保 启用水印 选中。
- 滚动至 玩家特性配置( M)。 。 。 。
- 查找 视频水印 在特性列表中,并确保检查前端复选框。
- 点击 保存特性设置。 。 。 。
视频广告没有播放
你看到的东西: 你配置了广告,但是在视频之前没有出现
如何修补:
- 点击 视频播放器广告 选项卡。
- 校验 启用视频广告 在顶端检查。
- 确定你已经进入 VAST 标记 URL 从你的广告供应商。
- 检查 启用预滚 选定于 临时安置。 。 。 。
- 尝试使用页面底部显示的测试 VAST 标记来验证系统的工作.
- 记住:广告只工作于您服务器上的视频,而不是来自其他站点的嵌入式视频.
视图限制无效
你看到的东西: 用户可以观看无限视频,尽管你设定了限制.
如何修补:
- 转到 视频播放器 选项卡并滚动到 视频视图限制和访问控制。 。 。 。
- 确保限制不设为0(零表示无限).
- 如果您看到缺少数据库表的消息,可能需要联系您的开发者或主机提供者来启用此功能.
- 记住:VIP用户,主持人,以及管理员无论这些设置如何,总是可以观看无限的视频.
上传按钮不起作用
你看到的东西: 当尝试上传预卷视频,字体,或水印图像时,无事可做.
如何修补:
- 请检查access-date=中的日期值 (帮助) 页面上方是否有写有"Demo Mode"的横幅——如果是的话,上传功能被禁用来防止更改.
- 确保您的文件为正确的类型 :
- 前/后卷:必须是MP4、MOV、AVI或WebM
- 水印图像:必须是PNG或GIF
- 字体: 必须是 TTF 或 OTF
- 如果您的文件很大, 请尝试一个较小的文件 。
适应性流线不起作用
你看到的东西: 您启用了 HLS 适应性流化, 但视频不提供质量选择 。
如何修补:
- 转到 处理设置 寻找 HLS 适应流设置。 。 。 。
- 检查 启用 HLS 适应流 打开。
- 看着 最小源高 - 如果这个设定为1080, 只有完整的HD视频会得到适应性流。 下至720分,以收录HD视频.
- 确保 活动 HLS 决议 包含至少两个品质,如
high,medium。 。 。 。 - 尝试上传一款新的HD视频(至少720p或1080p)进行测试.
相关页面
This guide was created to help you use your video processor settings without needing technical knowledge. If you encounter problems not covered here, contact your site administrator or support team.