FFmpeg API

This is a simple HTTP server that uses FFmpeg to convert audio files from OGG format to MP3/WAV format. The server listens on port 8080 and provides an endpoint to upload OGG files and send back the converted file as a response.

Requirements

• Rust installed on your system
• FFmpeg installed on your system

Using the Docker image

You can use the Github Container Registry to pull the Docker image:

docker pull ghcr.io/max-lt/ffmpeg-api:latest

Then, run the container:

docker run -p 8080:8080 ghcr.io/max-lt/ffmpeg-api:latest

Installation

1. Ensure you have Rust installed on your system. You can check the Rust installation guide for detailed instructions.

2. Clone this repository:

   git clone https://github.com/max-lt/ffmpeg-api.git
   

3. Change to the repository directory:

   cd ffmpeg-api
   

Usage

1. Start the server by running:

   cargo run
   

   The server will start and listen on port 8080.

2. To convert an OGG file, send a POST request to the /ogg-to-mp3 or /ogg-to-wav endpoint with the OGG file as the request body. The response will contain the converted file.

   For example, you can use curl to test the server:

   curl -X POST -H "Content-Type: audio/ogg" --data-binary "@sample.oga" http://localhost:8080/ogg-to-mp3 --output sample.mp3
   

   Replace sample.oga with the path to your OGG file, and sample.mp3 with the desired output file name.

License

This project is licensed under the MIT License.