Help & Documentation

Video Optimizer User Guide

← Back to App

Quick Start Guide

Get started with video optimization in 3 simple steps:

  1. Upload Your Video
    • Drag and drop your video file onto the upload area
    • Or click the upload area to browse your files
    • Supported formats: MP4, MOV, AVI, MKV, WEBM, FLV, WMV, M4V
    • Maximum file size: 500MB
  2. Configure Platform & Aspect Ratio
    • Select your target platform (TikTok, Meta, YouTube, etc.)
    • Choose the aspect ratio (9:16 vertical, 16:9 horizontal, 1:1 square)
    • The app will auto-detect these from your filename if it matches the naming convention
  3. Convert & Download
    • Click "Convert Video" to optimize
    • Compare the original and optimized videos side-by-side
    • Download the optimized version

Smart Detection (Filename Patterns)

The app can automatically detect the platform and aspect ratio from your filename. Use these patterns:

Platform Patterns

_tiktok_ → TikTok

_meta_ or _facebook_ or _instagram_ → Meta (Facebook & Instagram)

_pinterest_ → Pinterest

_snapchat_ or _snap_ → Snapchat

_youtube_ → YouTube

_youtube_ctv_ → YouTube Connected TV

_amazon_prime_ → Amazon Prime Video

_amazon_freevee_ or _freevee_ → Amazon Freevee

Aspect Ratio Patterns

_16x9_ or _16:9_ or _horizontal_ → 16:9 (Landscape)

_9x16_ or _9:16_ or _vertical_ → 9:16 (Portrait)

_1x1_ or _1:1_ or _square_ → 1:1 (Square)

_4x5_ or _4:5_ → 4:5

_2x3_ or _2:3_ → 2:3

Example Filenames

summer_campaign_tiktok_9x16.mp4 → Auto-detects TikTok + 9:16

product_launch_meta_1x1.mov → Auto-detects Meta + 1:1

tutorial_youtube_16x9.mp4 → Auto-detects YouTube + 16:9

Supported Platforms

The Video Optimizer supports 21 platform configurations across 8 major social media platforms:

TikTok

Codec: H264

Ratios: 9:16, 1:1

Meta (FB/IG)

Codec: H264

Ratios: 9:16, 1:1, 16:9, 4:5

Pinterest

Codec: H264

Ratios: 2:3, 1:1, 9:16, 16:9

Snapchat

Codec: H264

Ratios: 9:16, 16:9

YouTube

Codec: H264

Ratios: 16:9, 9:16, 1:1

YouTube CTV

Codec: H264

Ratios: 16:9

Amazon Prime

Codec: H264

Ratios: 16:9, 1:1

Amazon Freevee

Codec: H264

Ratios: 16:9, 1:1

Admin Panel Access

All authenticated users have access to the admin panel where you can:

  • View Platform Specifications: See all configured platforms and their settings
  • Add New Platforms: Create custom platform configurations
  • Edit Existing Platforms: Modify codec, bitrate, resolution for any platform
  • Delete Platforms: Remove platforms you no longer need
  • Export/Import Specifications: Backup or share platform configurations as JSON
  • Manage Naming Conventions: Add or edit filename detection patterns
  • Reset to Factory Defaults: Restore original platform configurations

Tip: Access the admin panel by clicking the "Admin Panel" button in the navigation or by going to /admin.html

Troubleshooting

Video Upload Issues

Problem: "File size exceeds maximum allowed"

Solution: The maximum file size is 500MB. Compress your video before uploading or use a smaller file.

Problem: "File type not allowed"

Solution: Only video formats are supported: MP4, MOV, AVI, MKV, WEBM, FLV, WMV, M4V. Convert your video to a supported format.

Conversion Errors

Problem: Conversion fails or takes too long

Solution: This may be due to video complexity or server load. Try:

  • Using a shorter video
  • Using a lower resolution source file
  • Trying again after a few minutes

Playback Issues

Problem: Videos don't play in comparison view

Solution: Your browser may not support the video codec. Try using a modern browser like Chrome, Firefox, or Edge.

Authentication Issues

Problem: "Unauthorized: You are not authorized to access this application"

Solution: Your Microsoft account is not part of the authorized organization. Contact your administrator.

Frequently Asked Questions

What video formats can I upload?

MP4, MOV, AVI, MKV, WEBM, FLV, WMV, and M4V files up to 500MB.

How long are my videos stored on the server?

Videos are automatically deleted after 24 hours to save server space.

Can I download the original video after optimization?

Yes! Both the original and optimized videos are available for download in the comparison view.

What's the difference between platforms?

Each platform has specific codec, bitrate, and resolution requirements for optimal performance. The app automatically applies the correct settings.

Can I customize bitrate settings?

Yes! Use the "Custom Bitrate" field in the configuration section to override the platform default.

Do I need an account to use this tool?

Yes, you need to sign in with your Microsoft account to access the application.

Who can access the admin panel?

All authenticated users have access to the admin panel.

Can I add my own platform configurations?

Yes! Use the admin panel to add custom platforms with specific codec and quality settings.

Technical Details

Codec Settings

  • H.264 (libx264): Preset: medium, CRF: 23, Profile: main
  • H.265 (libx265): Preset: medium, CRF: 28
  • VP9 (libvpx-vp9): Deadline: good, CPU-used: 2, Row-mt: 1

Audio Settings

  • Mobile platforms: AAC codec at 128kbps
  • CTV platforms: AAC codec at 192kbps
  • VP9 videos: Opus codec at 128-192kbps

File Retention

Uploaded and converted files are automatically deleted after the configured retention period (default: 24 hours) to prevent server storage exhaustion.

Conversion Logging

All conversions are logged with metadata including user, platform, aspect ratio, file sizes, conversion duration, and status for audit and analytics purposes.

Need More Help?

If you're experiencing issues not covered in this guide, please contact your system administrator or technical support team.