Video Queue

Overview

The Video Queue Visualizer is an interactive queue management interface for the ComusThumbz video processing system. It provides a visual, column-based view of the processing queue organized by priority levels, allowing administrators to monitor job status, adjust priorities, and cancel jobs in real-time. The interface features drag-and-drop priority adjustment and auto-refreshes every 15 seconds.

Location: Navigate to this page via Admin Panel → Videos → Queue Visualizer or access directly via ct/admin/videoqueuevisualizer.php

[Screenshot: video-queue-visualizer-main]

Getting to This Page

1. Navigate to Admin Panel → Videos
2. Click Queue Visualizer link
3. Alternatively, access from the Video Processing Dashboard via "Queue Visualizer" button
4. Direct access via ct/admin/videoqueuevisualizer.php

System Requirements

PHP Requirements

Required PHP Extensions

Required PHP Functions

Folder Permissions

Network Requirements

Features & UI Elements

Page Header

[Screenshot: video-queue-visualizer-header]

Queue Statistics Bar

[Screenshot: video-queue-visualizer-stats]

Processor Settings Display

[Screenshot: video-queue-visualizer-settings]

Navigation Buttons

[Screenshot: video-queue-visualizer-navigation]

Auto-Refresh Indicator

[Screenshot: video-queue-visualizer-auto-refresh]

Queue Columns

[Screenshot: video-queue-visualizer-columns]

The queue is displayed in four columns:

Job Cards

[Screenshot: video-queue-visualizer-job-card]

Each job is displayed as a card with:

Job Type Colors:

Priority Modal

[Screenshot: video-queue-visualizer-priority-modal]

When clicking "Priority" button on a job card:

Bulk Actions

[Screenshot: video-queue-visualizer-bulk-actions]

Priority System

Priority Levels

Priority Impact

1. Jobs with higher priority are picked up first by the processor
2. Within same priority, older jobs are processed first (FIFO)
3. Processing jobs are not affected by priority changes
4. New videos get default priority from settings

Step-by-Step Usage

Viewing Queue Status

1. Navigate to Admin Panel → Videos → Queue Visualizer
2. View four columns showing jobs by priority/status
3. Check stats bar for overall queue health
4. Review processor settings in sidebar

Changing Job Priority

1. Find the job card in one of the columns
2. Click Priority button (sliders icon)
3. Priority modal opens
4. Drag slider to desired priority (1-10)
5. Click Save
6. Job moves to appropriate column

Cancelling a Single Job

1. Find the job card
2. Click Cancel button (X icon)
3. Confirm cancellation in dialog
4. Job status changes to "cancelled"
5. Job card disappears from queue

Bulk Cancelling Jobs

1. Check "Select All" in column header OR
2. Click individual job checkboxes
3. Click "Cancel Selected" button
4. Confirm bulk cancellation
5. All selected jobs cancelled

Monitoring Processing

1. Watch "Currently Processing" column
2. Jobs show processing duration
3. Completed jobs disappear automatically
4. Failed jobs show error indicator

AJAX Actions

The visualizer uses POST requests with CSRF protection:

Cancel action uses videodashboardapi.php:

Job Status Flow

[pending] → [processing] → [completed]
    ↓           ↓
    └→ [cancelled]  [failed] → (retry) → [pending]
                         ↓
                    (max attempts) → stays [failed]

Auto-Refresh Behavior

Troubleshooting

Common Issues

Cause: No pending jobs or filter mismatch
Solution:

1. Check if jobs exist: SELECT COUNT(*) FROM tblVideoProcessingJobs WHERE status = 'pending'
2. Verify database connection
3. Refresh the page

Cause: CSRF token expired or database error
Solution:

1. Refresh page to get new CSRF token
2. Check browser console for errors
3. Verify database write permissions

Cause: Processor crashed or job timed out
Solution:

1. Check if videoprocessor.php is running
2. Wait for timeout (per settings)
3. Jobs will auto-reset or fail after timeout
4. Manual reset:

UPDATE tblVideoProcessingJobs

SET status = 'pending', processingstartedat = NULL

WHERE status = 'processing'

AND processingstartedat < DATESUB(NOW(), INTERVAL 1 HOUR);

Cause: processorenabled setting is false
Solution:

1. Navigate to Settings
2. Enable processor
3. Or set via SQL:

UPDATE tblVideoSettings SET settingvalue = '1' WHERE settingkey = 'processorenabled';

Performance Tips

Color Reference

Column Headers

Job Cards

Priority Badges

Translatable Strings

The following strings should be added to backendtranslations.md:

videoqueuevisualizertitle = "Video Processing Queue Visualizer"
videoqueuevisualizerbreadcrumb = "Queue Visualizer"
videoqueuevisualizersubtitle = "Visual queue management with priority columns"
videoqueuevisualizerbacktodashboard = "Back to Dashboard"
videoqueuevisualizersettings = "Settings"
videoqueuevisualizerrefresh = "Refresh"
videoqueuevisualizerautorefresh = "Auto-refresh"
videoqueuevisualizertotalpending = "Total Pending"
videoqueuevisualizerprocessing = "Processing"
videoqueuevisualizercompleted24h = "Completed (24h)"
videoqueuevisualizerfailed = "Failed"
videoqueuevisualizermaxconcurrent = "Max Concurrent"
videoqueuevisualizertimeout = "Timeout"
videoqueuevisualizerprocessorstatus = "Processor Status"
videoqueuevisualizerdefaultpriority = "Default Priority"
videoqueuevisualizerenabled = "Enabled"
videoqueuevisualizerdisabled = "Disabled"
videoqueuevisualizercurrentlyprocessing = "Currently Processing"
videoqueuevisualizerhighpriority = "High Priority"
videoqueuevisualizermediumpriority = "Medium Priority"
videoqueuevisualizerlowpriority = "Low Priority"
videoqueuevisualizerpriority = "Priority"
videoqueuevisualizercancel = "Cancel"
videoqueuevisualizerselectall = "Select All"
videoqueuevisualizercancelselected = "Cancel Selected"
videoqueuevisualizersetpriority = "Set Priority"
videoqueuevisualizercurrentpriority = "Current Priority"
videoqueuevisualizernewpriority = "New Priority"
videoqueuevisualizersave = "Save"
videoqueuevisualizercancelbtn = "Cancel"
videoqueuevisualizerlow = "Low"
videoqueuevisualizermedium = "Medium"
videoqueuevisualizerhigh = "High"
videoqueuevisualizerwaittime = "Wait"
videoqueuevisualizerattempts = "Attempts"
videoqueuevisualizernojobs = "No jobs in this column"
videoqueuevisualizerjobtypesextract = "Extract Metadata"
videoqueuevisualizerjobtypestranscode = "Transcode"
videoqueuevisualizerjobtypesthumbnails = "Thumbnails"
videoqueuevisualizerjobtypessprites = "Sprites"
videoqueuevisualizerjobtypespreview = "Preview"
videoqueuevisualizerjobtypesgif = "GIF"
videoqueuevisualizerjobtypescontact = "Contact Sheet"
videoqueuevisualizerjobtypescdn = "CDN Upload"
videoqueuevisualizerjobtypescleanup = "Cleanup"
videoqueuevisualizerconfirmcancel = "Are you sure you want to cancel this job?"
videoqueuevisualizerconfirmbulkcancel = "Cancel {count} selected jobs?"
videoqueuevisualizerpriorityupdated = "Priority updated successfully"
videoqueuevisualizerjobcancelled = "Job cancelled"
videoqueuevisualizererrorupdate = "Error updating priority"
videoqueuevisualizererrorcancel = "Error cancelling job"

Version History

Related Documentation

• Video Processor Dashboard - Dashboard overview
• Video Processor Settings - Processor configuration
• Video Upload System - Upload workflow
• Storage Server System - CDN and storage