Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/neurospeech/ff-lambda-container
FFmpeg AWS Lambda Container
https://github.com/neurospeech/ff-lambda-container
aws-lambda container ffmpeg lambda-container video
Last synced: about 2 months ago
JSON representation
FFmpeg AWS Lambda Container
- Host: GitHub
- URL: https://github.com/neurospeech/ff-lambda-container
- Owner: neurospeech
- License: mit
- Created: 2023-02-01T12:11:01.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-03T10:13:21.000Z (about 1 year ago)
- Last Synced: 2024-08-06T23:29:19.301Z (5 months ago)
- Topics: aws-lambda, container, ffmpeg, lambda-container, video
- Language: TypeScript
- Homepage:
- Size: 344 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FFmpeg AWS Lambda Container
1. This container image will allow you to execute custom commands against ffmpeg.
2. Many encoding API contains too many parameters and various combinations, making it very difficult to customize.
3. Since we an execute custom arguments against ffmpeg, we can practically customize it in any way we want it.
# Installation
1. Create a container based Lambda and choose container created by `Dockerfile` in this project.
2. Allocate maximum memory available, that is 10GB RAM. And use `-threads 10` for optimum performance. If you want to choose lesser memory, use same number of threads as memory. e.g. `-threads 8` for 8GB RAM.
3. Set timeout to 5 minutes, you can set up to 15 minutes as well.
4. In typical `10GB Memory` configuration, 10 minutes of HD 720p video will take up to 3 minutes. This is the sample `https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4` used for testing.
# Usage
Invoke Lambda to execute custom against `ffmpeg`. To execute lambda you have to use `aws sdk` and send following payloads.
# Payload Parameters
```typescript
interface IPayload {
/**
* Path of javascript file to execute relative to `/dist` folder.
*/
rawPath: string;
body: {
/**
* Command that will be executed against ffmpeg. Please note, all `input*.*` keys specified in body will downloaded locally and
* the path will be replaced from the command. And after the command is executed, output file will be uploaded to value of key `output.*`.
*/
command: string;
/**
* You can specify input keys inside inputs key. Such as `input0.mp4` or `input1.mp3`.
* The value must be the url from where the video will be downloaded.
* 1. Secure URL is preferred. In case of S3 or Blob, you must specify complete signed url.
* 2. Input file key must have file extension.
*/
"inputs": {
[key: string]: string;
};
/** Signed URL of S3 or Blob URI to upload file
* 1. Output file key must have file extension.
*/
"output.*": string;
"thumbnailTimes": IThumbnailTime[];
}
}
interface IThumbnailTime {
/** Time at which thumbnail should be taken */
name: double;
/** Signed URL of S3 or Blob URI to upload file*/
url: string;
}
```
# Examples
## Replace Audio
```json
{
"rawPath": "/custom",
"body": {
"inputs": {
"input0.mp4": "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
"input1.mp3": "https://samplemp3.com/download/sample.mp3",
},
"output.mp4": "https://blob.core.windows.com/account/container/blob.mp4?signing.....",
"command": "-i input0.mp4 -i input1.mp3 -preset fast -threads 10 -codec:a aac -b:a 128k -codec:v libx264 -pix_fmt yuv420p -b:v 2500k -minrate 1500k -maxrate 4000k -bufsize 5000k -vf scale=-1:720 -movflags +faststart -map 0:v:0 -map 1:a:0 output.mp4"
}
}
```
## Convert to WebM
```json
{
"rawPath": "/custom",
"body": {
"inputs": {
"input0.mp4": "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
}
"output.webm": "https://blob.core.windows.com/account/container/blob.webm?signing.....",
"command": "-i input0.mp4 -threads 10 libvpx-vp9 -crf 30 -b:v 0 -b:a 128k -c:a libopus output.webm"
}
}
```