Universal Video To S3 Uploader

Why v3.0.1?

v3.0.1 improves filename handling:

1. Clean filenames - Removes all punctuation and emojis
2. Better S3 compatibility - Avoids issues with special characters
3. Improved readability - Clean, readable filenames without clutter

What's New:

• ✅ S3 Multipart Upload for All Files: v2.0.0 uses S3 multipart upload for all file sizes
• ✅ Memory Optimization: Chunked reading to avoid memory overflow
• ✅ Error Recovery: Automatic retry mechanism for failed uploads
• ✅ Smart Chunk Sizing: Automatically adjusts chunk size based on file size
• ✅ Performance Improvements: Better progress tracking and speed calculation
• ✅ Fixed Help System: Proper help information display

Breaking Changes:

• ❌ NOT backward compatible: v2.0.0 is a complete rewrite
• ❌ Old scripts removed: All v1.x scripts have been replaced
• ❌ New API: Uses S3 multipart upload for all files, not just large ones

Why v2.0.0?

v2.0.0 fixes critical issues in v1.x:

1. Fixed help system - Proper --help display
2. Consistent API - Always uses multipart upload
3. Better error handling - Improved error messages
4. Cleaner codebase - Removed compatibility layers

Features

• One-command workflow: Download YouTube video → Upload to S3 → Get access URL
• S3-compatible: Works with Cloudflare R2, AWS S3, MinIO, and any S3-compatible storage
• Automatic cleanup: Removes local files after successful upload
• Progress tracking: Real-time upload progress and speed calculation
• Secure by default: Uses your own S3 credentials, no external dependencies
• Flexible configuration: Multiple bucket support, custom paths, metadata
• Smart upload method: Automatically uses S3 Multipart Upload for large files (>50MB)
• Memory efficient: Chunked reading to avoid memory overflow
• Error recovery: Retry mechanism for failed uploads

Prerequisites

1. S3-compatible storage (Cloudflare R2, AWS S3, MinIO, etc.)
2. S3 credentials (Access Key ID and Secret Access Key)
3. Bucket created with appropriate permissions

Quick Start

1. Install the skill

clawhub install youtube-s3-uploader

2. Configure your S3 storage

Create ~/.youtube-s3-uploader.yml:

# Default bucket to use