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:

1. Processing Settings - Controls video quality, thumbnails, and how videos are converted
2. Pre-Roll & Post-Roll - Videos that play before or after your content
3. Video Overlays - Watermarks that are permanently added to your videos
4. Video Player - How the video player looks and works on your site
5. 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.

1. Click the Processing Settings tab at the top.
2. Scroll down to find Video Conversion Settings.
3. Adjust the Max Video Bitrate - higher numbers mean better quality but larger files (5000 is a good balance).
4. Set Max Audio Bitrate - 192 is usually perfect for most videos.
5. Scroll to the bottom and click Save Settings.
6. 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.

1. Go to the Processing Settings tab.
2. Scroll down to HLS Adaptive Streaming Settings.
3. Check the box next to Enable HLS Adaptive Streaming.
4. Set Minimum Source Height to 720 (this only enables streaming for HD videos).
5. In the Active HLS Resolutions box, enter which qualities you want: type hd,high,medium,low for all options.
6. Click Save Settings at the bottom.

How to Set Up Thumbnail Generation

Thumbnails are the preview images visitors see when browsing videos.

1. Open the Processing Settings tab.
2. Find the Thumbnail Generation Settings section.
3. Set Thumbnail Count to how many preview images you want per video (5-10 is good).
4. Adjust Thumbnail Width and Thumbnail Height if needed (320x180 works for most sites).
5. Set Poster Width and Poster Height - this is the main preview image (1280x720 is standard HD).
6. Check Enable Animated Preview to create GIF previews.
7. Check Generate Video Sprites to enable timeline preview when hovering.
8. Click Save Settings.

How to Choose Thumbnail File Formats

You can generate thumbnails in JPG format, modern WebP format, or both.

1. In the Processing Settings tab, scroll to Thumbnail Image Format Settings.
2. In the Thumbnail Formats box, type one of these:

• Type jpg for universal compatibility
• Type webp for smaller file sizes
• Type both to generate both formats

1. Click Save Settings.

How to Configure Animated GIF Previews

Animated GIFs give visitors a quick preview when hovering over thumbnails.

1. Go to the Processing Settings tab.
2. Scroll to Animated GIF Settings.
3. Set Animated GIF Duration to how long the preview should be (3-5 seconds works well).
4. 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)

1. 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.

1. Click the Pre-Roll & Post-Roll tab.
2. Under Upload New Pre-Roll Video, click Choose File.
3. Select an MP4 video from your computer.
4. Leave Activate immediately checked if you want it to start working right away.
5. 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

1. Go to the Pre-Roll & Post-Roll tab.
2. Find the video you want to remove under Current Pre-Roll Video or Current Post-Roll Video.
3. Click the Delete button.
4. 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.

1. Go to the Video Overlays tab.
2. Choose whether you want to add an image or text watermark.
3. 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)

1. 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

1. Leave Activate immediately checked.
2. 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.

1. Click the Video Player tab.
2. Scroll down to Video Watermark / Branding.
3. Check Enable Watermark.
4. Choose Text or Image from the dropdown.
5. 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)

1. For image branding:

• Type your logo URL in Image URL (must be a PNG file with transparency)

1. Choose where it appears using the Position dropdown.
2. Set Opacity (0.3-0.5 is subtle but visible).
3. Check Fade on Hover to make it less intrusive.
4. 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.

1. Go to the Video Player tab.
2. Scroll down to Video View Limits & Access Control.
3. 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)

1. Set limits for premium members:

• Premium Daily Limit - try 20
• Premium Monthly Limit - try 200

1. 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.

1. In the Video Player tab, scroll to Upgrade Prompt Customization.
2. 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)

1. Do the same for premium users.
2. 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

1. 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.

1. Go to the Video Player tab.
2. Scroll to Playlist & Sidebar UI Customization.
3. Adjust thumbnail sizes:

• Thumbnail Width - try 120 pixels
• Thumbnail Height - try 68 pixels

1. Choose colors:

• Background Color - the sidebar background
• Item Hover Color - what happens when you hover
• Selected Gradient Start/End - the currently playing video

1. Customize the duration badges (the time labels on thumbnails).
2. Adjust the scrollbar colors to match your site.
3. Set Sidebar Width (300-400 pixels works well).
4. Click Save Playlist UI Settings.

How to Set Up Video Advertising

You can show video ads before, during, or after your videos.

1. Click the Video Player Ads tab.
2. Check Enable Video Ads at the top.
3. Enter your VAST Tag URL - you get this from your advertising provider.
4. 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

1. 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.

1. Set Skip Button Delay to how many seconds before viewers can skip (5 is standard).
2. Click Save Ad Settings.

How to Test Your Video Processing Settings

After changing settings, it's important to test that everything works.

1. Upload a test video through Admin Panel > Videos > Upload Video.
2. Wait for it to process (check the status dashboard at the top of this page).
3. Once it shows "Active Jobs: 0", go view the video on your site.
4. 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

1. 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).

Tips for New Users

Troubleshooting

Videos aren't being processed

What you see: You upload a video but it stays stuck with "Pending" status forever.

How to fix it:

1. Check the status dashboard at the top of this page. If it says "Idle" or shows 0 active jobs, the processor might not be running.
2. Contact your hosting provider or server administrator - they need to enable the video processing system.
3. If "Failed Jobs" is increasing, there's a problem with the processing settings. Try reducing quality settings or disabling HLS.

Thumbnails aren't showing up

What you see: Videos process successfully but have no thumbnail images.

How to fix it:

1. Go to the Processing Settings tab and scroll to Thumbnail Generation Settings.
2. Make sure Thumbnail Count is set to at least 5 (not 0).
3. Check that Enable Animated Preview and Generate Video Sprites are checked if you want those features.
4. Click Save Settings and try uploading a new test video.

Video quality is poor or blurry

What you see: Processed videos look worse than the original files you uploaded.

How to fix it:

1. Open the Processing Settings tab.
2. Scroll to Video Conversion Settings.
3. Increase Max Video Bitrate to 8000 or 10000.
4. Scroll to MP4 Encoding Settings.
5. Change MP4 CRF Quality to 20 or 21 (lower numbers = better quality).
6. Click Save Settings.

Existing videos won't improve - only newly uploaded videos will use the new settings.

Watermarks aren't appearing on videos

What you see: You created a watermark but it doesn't show up on videos.

How to fix it:

1. Go to the Video Overlays tab.
2. Find your watermark in the list at the bottom.
3. Check if the Status says "Active" - if it says "Inactive", click Activate.
4. Note that watermarks only appear on newly processed videos. Old videos won't have the watermark unless you reprocess them.

Player branding isn't showing

What you see: You set up player branding but don't see it when watching videos.

How to fix it:

1. Go to the Video Player tab.
2. Scroll to Video Watermark / Branding.
3. Make sure Enable Watermark is checked.
4. Scroll up to Player Features & Mode Configuration.
5. Find Video Watermark in the features list and make sure the Frontend checkbox is checked.
6. Click Save Feature Settings.

Video ads aren't playing

What you see: You configured ads but they don't appear before videos.

How to fix it:

1. Click the Video Player Ads tab.
2. Verify Enable Video Ads is checked at the top.
3. Make sure you've entered a VAST Tag URL from your ad provider.
4. Check that Enable Pre-Roll is selected under Ad Placement.
5. Try using one of the test VAST tags shown at the bottom of the page to verify the system works.
6. Remember: ads only work with videos hosted on your server, not embedded videos from other sites.

View limits aren't working

What you see: Users can watch unlimited videos even though you set limits.

How to fix it:

1. Go to the Video Player tab and scroll to Video View Limits & Access Control.
2. Make sure the limits aren't set to 0 (zero means unlimited).
3. If you see a message about a missing database table, you may need to contact your developer or hosting provider to enable this feature.
4. Remember: VIP users, moderators, and admins can always watch unlimited videos regardless of these settings.

Upload buttons don't work

What you see: When you try to upload a pre-roll video, font, or watermark image, nothing happens.

How to fix it:

1. Check if there's a banner at the top of the page that says "Demo Mode" - if so, uploads are disabled to prevent changes.
2. Make sure your file is the correct type:

• Pre/post-roll: must be MP4, MOV, AVI, or WebM
• Watermark images: must be PNG or GIF
• Fonts: must be TTF or OTF

1. Try a smaller file if yours is very large.

Adaptive streaming isn't working

What you see: You enabled HLS adaptive streaming but videos don't offer quality selection.

How to fix it:

1. Go to Processing Settings and find HLS Adaptive Streaming Settings.
2. Check that Enable HLS Adaptive Streaming is turned on.
3. Look at Minimum Source Height - if this is set to 1080, only Full HD videos will get adaptive streaming. Lower it to 720 to include HD videos.
4. Make sure Active HLS Resolutions contains at least two qualities, like high,medium.
5. Try uploading a new HD video (at least 720p or 1080p) to test.

Related Pages

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.