A professional full-stack video upload and streaming platform built with React and Node.js. Upload large video files, automatically generate thumbnails, convert to multiple resolutions, and stream with a custom video player.
- Upload videos up to 5GB with real-time progress tracking
- Automatic multi-resolution conversion (360p to 4K)
- Auto-generated thumbnails from your videos
- Custom video player with speed control, resolution switching, fullscreen
- Modern, responsive UI with beautiful animations
- Real-time processing status updates
- Node.js (v14+)
- npm
- FFmpeg (installation guide)
# Install backend dependencies
npm install
# Install frontend dependencies
cd frontend
npm install
cd ..Terminal 1 - Backend:
PORT=9876 npm run devTerminal 2 - Frontend:
cd frontend
npm startOpen http://localhost:3000 in your browser.
Backend: Node.js, Express, Multer, FFmpeg
Frontend: React 18, Axios, React Icons
Video Processing: FFmpeg with fluent-ffmpeg
- Upload: Click "Choose Video File", add title/description, and upload
- Processing: Wait for automatic thumbnail generation and multi-resolution conversion
- Play: Click any video thumbnail to open the custom player
- Controls:
- Space - Play/Pause
- F - Fullscreen
- M - Mute/Unmute
- Arrows - Seek 5 seconds
Default port: 9876 (backend) and 3000 (frontend)
To change ports, create a .env file:
PORT=9876
NODE_ENV=development
FFmpeg not found?
Install FFmpeg: brew install ffmpeg (Mac) or see docs
Port already in use?
Change port in .env or kill the process: lsof -ti:9876 | xargs kill -9
Videos not processing?
Check backend console for errors and verify FFmpeg installation: ffmpeg -version
Video Platform Assignment/
├── backend/
│ ├── server.js # Express server
│ ├── routes/ # API endpoints
│ ├── utils/ # Video processing
│ └── uploads/ # Video storage
└── frontend/
└── src/
├── App.js # Main component
└── components/ # React components
For detailed documentation, see DOCUMENTATION.md:
- API Reference
- Configuration Options
- Troubleshooting Guide
- Architecture & Design Decisions
- Development Notes
- In-memory storage for simplicity (use database for production)
- Local file storage (use cloud storage for production)
- Immediate processing (use queue system for production)
- Smart resolution conversion - only generates up to source quality
- User authentication
- Cloud storage (AWS S3)
- Video editing features
- Search & filtering
- Playlist creation
- HLS/DASH adaptive streaming
This project was built with the help of Claude 4 Sonnet AI through Cursor IDE, demonstrating modern AI-assisted development workflows.
Built with React, Node.js, and FFmpeg














