Jon Staab
34 lines
621 B
Markdown
34 lines
621 B
Markdown
# Video Thumbnail Service
|
|
|
|
A lightweight microservice that generates video thumbnails by extracting a frame using ffmpeg.
|
|
|
|
## Requirements
|
|
|
|
- Node.js 18+
|
|
- ffmpeg installed on the system
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
npm install
|
|
npm start
|
|
```
|
|
|
|
The service runs on port 3100 by default. Set the `PORT` environment variable to change it.
|
|
|
|
## Usage
|
|
|
|
```
|
|
GET /thumbnail?url=https://example.com/video.mp4
|
|
```
|
|
|
|
Returns a JPEG image of the first frame (at 1 second).
|
|
|
|
## Configuration
|
|
|
|
Set `VITE_THUMBNAIL_URL` in the Flotilla `.env` file to the deployed service URL:
|
|
|
|
```
|
|
VITE_THUMBNAIL_URL=https://your-thumbnail-service.example.com
|
|
```
|