update readme

This commit is contained in:
Pavel 2024-05-25 21:50:34 +03:00
parent aa6681a64d
commit a9e21891c5

View File

@ -1,3 +1,32 @@
# atranscoder-rpc # atranscoder-rpc
Audio transcoder with simple HTTP API. Work in progress, nothing is implemented yet... Audio transcoder with simple HTTP API. Work in progress.
# What works
Transcoding:
1. `cargo run`
2. Upload file for transcoding:
```bash
curl --location 'http://localhost:8090/enqueue' \
--form 'file=@"/home/user/Music/test.mp3"' \
--form 'format="adts"' \
--form 'codec="aac"' \
--form 'bitRate="64000"' \
--form 'maxBitRate="64000"' \
--form 'sampleRate="8000"' \
--form 'channelLayout="mono"' \
--form 'uploadUrl="http://127.0.0.1:8909/upload"'
```
3. You will receive JSON response with job ID. The transcoding result will be saved into `/tmp/{job_id}.out.atranscoder`
# Roadmap
- [ ] Implement acceptable error handling.
- [ ] Restart threads in case of panic.
- [ ] Remove old conversion results and input files every Nth hours.
- [ ] Remove input file after transcoding it.
- [ ] Implement file upload to `uploadUrl` (if `Content-Type: application/json` then conversion was not successful and body contains an error info).
- [ ] Remove transcoding result after uploading it to the `uploadUrl`.
- [ ] (Optional) Make `uploadUrl` optional and allow the client to download the file on-demand.
- [ ] Docker image for `amd64` and `aarch64`.
- [ ] Tests!