https://github.com/giochem/covert-video
https://github.com/giochem/covert-video
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/giochem/covert-video
- Owner: giochem
- License: mit
- Created: 2025-01-04T10:43:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-04T10:50:07.000Z (over 1 year ago)
- Last Synced: 2025-02-24T12:17:48.545Z (over 1 year ago)
- Language: JavaScript
- Size: 1.74 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Video Streaming Service
## Introduction
A high-performance video streaming service that supports adaptive bitrate streaming with device-specific optimizations. The service converts uploaded videos into HLS (HTTP Live Streaming) format, supporting multiple quality levels and device configurations.
## Technical Presentation
For a detailed technical overview of this project, please refer to my comprehensive presentation:
[Introduction to Video Segmentation and Adaptive Bitrate Streaming](./docs/Introduction%20to%20Video%20Segmentation%20and%20Adaptive%20Bitrate%20Streaming.pdf)
## System Architecture
```mermaid
graph TD
A[Client] --> B[Express Server]
B --> C[File Upload/Multer]
C --> D[Storage]
B --> E[Video Processing]
E --> F[FFmpeg]
F --> G[HLS Segmentation]
G --> H[Quality Variants]
H --> I[720p Segments]
H --> J[360p Segments]
B --> K[Stream Delivery]
K --> L[HLS Playback]
```
## Usage Examples
### 1. Video Upload Interface
_Video upload interface showing supported formats and upload progress_
### 2. Video Library
_Available videos with streaming options and quality selection_
### 3. Video Segmentation Process
_HLS segmentation process with multiple quality variants_
## Implementation Details
### Core Features
- Multi-device support (desktop/mobile)
- Adaptive bitrate streaming (720p, 360p)
- HLS segmentation with device-specific configurations
- Automatic video quality optimization
- Support for MP4 and MKV formats
### Technical Architecture
```
src/
├── segments/ # HLS segments and playlists
│ ├── video1/
│ │ ├── desktop/
│ │ │ ├── 720p/
│ │ │ └── 360p/
│ │ └── mobile/
│ │ ├── 720p/
│ │ └── 360p/
│ └── video2/
├── uploads/ # Original video files
└── segment.js # Video processing logic
```
### API Endpoints
- `POST /upload` - Upload video files
- `GET /api/videos` - List all available videos
- `GET /segments/{videoName}/{device}/master.m3u8` - Access HLS streams
- `GET /uploads/{filename}` - Access original videos
### Video Processing Configuration
- Desktop: 1920x1080 max resolution, 120s segments
- Mobile: 1280x720 max resolution, 60s segments
- Quality Levels:
- 720p (2800kbps)
- 360p (800kbps)
## Video Processing Flow
```mermaid
sequenceDiagram
participant C as Client
participant S as Server
participant F as FFmpeg
participant ST as Storage
C->>S: Upload Video
S->>ST: Save Original
S->>F: Process Video
F->>F: Generate HLS Segments
F->>ST: Store Segments
F->>S: Processing Complete
S->>C: Return Stream URL
C->>S: Request Stream
S->>C: Deliver HLS Manifest
C->>S: Request Segments
S->>C: Stream Video
```
## Getting Started
```bash
# Install dependencies
npm install
# Start the server
npm start
# Development mode
npm run dev
```
## API Flow
```mermaid
flowchart LR
A[Upload Video] --> B[Process Video]
B --> C{Quality Variants}
C --> D[720p Processing]
C --> E[360p Processing]
D --> F[Generate HLS]
E --> F
F --> G[Create Master Playlist]
G --> H[Stream Ready]
```
## Summary
This service provides enterprise-grade video streaming capabilities with device-aware optimizations and adaptive bitrate streaming. It's built using Node.js, Express, and FFmpeg, offering reliable video processing and efficient content delivery through HLS protocol.
## Technologies
- Node.js & Express
- FFmpeg for video processing
- HLS.js for playback
- Multer for file uploads
- fs-extra for enhanced file operations