Compare commits

..

No commits in common. "main" and "0.2" have entirely different histories.
main ... 0.2

2 changed files with 5 additions and 92 deletions

View file

@ -16,7 +16,7 @@ jobs:
direction: upload direction: upload
url: https://git.h2-invent.com url: https://git.h2-invent.com
repo: meetling/livekit-uploader repo: meetling/livekit-uploader
tag: ${{ vars.LIVEKIT_UPLOADER_MAJOR_VERSION }}.${{ github.run_number }} tag: 0.${{ github.run_number }}
token: ${{ secrets.GITHUB_TOKEN }} token: ${{ secrets.GITHUB_TOKEN }}
docker-build: docker-build:
runs-on: host runs-on: host
@ -30,10 +30,10 @@ jobs:
uses: docker/login-action@v3 uses: docker/login-action@v3
with: with:
registry: git.h2-invent.com registry: git.h2-invent.com
username: ${{ secrets.FORGEJO_ACTION_PACKAGE_RW_USER }} username: ${{ secrets.DOCKER_REGISTRY_USERNAME }}
password: ${{ secrets.FORGEJO_ACTION_PACKAGE_RW_KEY }} password: ${{ secrets.DOCKER_REGISTRY_TOKEN }}
- name: Build and push - name: Build and push
uses: docker/build-push-action@v6 uses: docker/build-push-action@v6
with: with:
push: true push: true
tags: git.h2-invent.com/meetling/livekit-uploader:${{ vars.LIVEKIT_UPLOADER_MAJOR_VERSION }}.${{ github.run_number }},git.h2-invent.com/meetling/livekit-uploader:latest tags: git.h2-invent.com/meetling/livekit-uploader:0.${{ github.run_number }},git.h2-invent.com/meetling/livekit-uploader:latest

View file

@ -1,89 +1,2 @@
# Meetling Livekit Recording Uploader # Livekit-Uploader
This containerized utility monitors a directory for new `.mp4` files, splits them into chunks, and uploads each chunk to a specified endpoint. It is intended for use with the Meetling Livekit recording system.
---
## 📦 Features
- 📁 Watches the `/out` directory for new `.mp4` files
- ✂️ Splits files into configurable chunk sizes
- 📤 Uploads chunks via HTTP with bearer token authorization
- 🐳 Lightweight Alpine-based Docker image
---
## ⚙️ Environment Variables
| Variable | Default | Description |
|---------------|-------------------------------------------|--------------------------------------------|
| `CHUNK_SIZE` | `1048576` (1 MiB) | Size of each chunk in bytes |
| `UPLOAD_URL` | `http://localhost:8000/recording/upload` | Upload endpoint URL |
| `AUTH_TOKEN` | `verySecretToken` | Bearer token for authentication |
---
## 🚀 Usage
### 1. Build the Docker image
```sh
docker build -t meetling-uploader --build-arg VERSION=1.0.0 .
```
### 2. Run the container
```sh
docker run -v /your/output/directory:/out meetling-uploader
```
> Replace `/your/output/directory` with the directory containing your `.mp4` recordings.
---
## 🔄 Upload Process
Once a `.mp4` file is completely written to `/out`, the script:
1. Verifies the file exists.
2. Calculates file size.
3. Splits the file into chunks based on `CHUNK_SIZE`.
4. Uploads each chunk using `curl`.
Each upload includes the following multipart form fields:
- `recording_id`: Filename without `.mp4`
- `chunk_index`: Index of the chunk (starting from 0)
- `total_chunks`: Total number of chunks
- `file`: The actual chunk
---
## 🐳 Dockerfile Overview
The image uses `alpine:3.20` and installs:
- `inotify-tools` (for file system event watching)
- `curl` (for HTTP requests)
- `coreutils` (for `stat` and `dd` utilities)
The script is located at `/inotify.sh` and is executed when the container starts.
It runs as the non-privileged user `nobody` for security.
---
## 📝 License
MIT License
---
## 👨‍💻 Maintainers
**H2 invent GmbH**
📧 [support@h2-invent.com](mailto:support@h2-invent.com)
🌐 [https://meetling.de](https://meetling.de)
---
> **Note:** Ensure your backend server supports chunked uploads and correctly assembles the file.