MP4 to MP3 Converter Actor

[![Apify](https://img.shields.io/badge/apify-actor-green.svg)](https://apify.com)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

This Apify actor converts MP4 files to high-quality MP3 format. It extracts audio tracks from video files and processes them efficiently.

## Features

- **Batch Conversion**: Convert multiple MP4 files simultaneously
- **Customizable Quality**: Support for various output bitrates (64kbps, 128kbps, 320kbps)
- **Concurrent Processing**: Handles multiple files in parallel for faster execution
- **Apify Dataset Storage**: Converted MP3 files and processing logs saved directly to Apify dataset
- **Error Handling**: Detailed reports for successes, failures, and errors per file
- **Optional Cleanup**: Delete original MP4 files after successful conversion
- **Secure Downloads**: Supports HTTPS URLs and handles authentication if provided

## How to Use

### Input Schema

| Property | Type | Description | Default | Required |
|----------|------|-------------|---------|----------|
| `inputUrls` | array | List of MP4 file URLs to convert | `[]` | Yes |
| `outputQuality` | enum | Output MP3 quality: `low` (64kbps), `medium` (128kbps), `high` (320kbps) | `medium` | No |
| `deleteOriginal` | boolean | Delete original MP4 files after conversion | `false` | No |
| `maxConcurrency` | integer | Maximum concurrent downloads/conversions (1-10) | `3` | No |

### Outputs

- **Dataset**: Contains:
  - Converted MP3 files (as binary blobs)
  - JSON report with details: `{ "url": "...", "mp3Url": "...", "status": "success/error", "duration": "..." }`
- **Logs**: Real-time console logs for monitoring progress

## Example Input

```json
{
  "inputUrls": [
    "https://example.com/video1.mp4",
    "https://example.com/video2.mp4",
    "https://example.com/video3.mp4"
  ],
  "outputQuality": "high",
  "deleteOriginal": false,
  "maxConcurrency": 5
}

## Example Output Report (JSON)

```json
[
  {
    "originalUrl": "https://example.com/video1.mp4",
    "mp3File": "video1.mp3",
    "bitrate": "320kbps",
    "duration": "120s",
    "status": "success",
    "size": "4500KB"
  },
  {
    "originalUrl": "https://example.com/video2.mp4",
    "status": "error",
    "error": "Invalid MP4 format"
  }
]

## Running Locally

1. Clone/Fork this actor repository
2. Install dependencies: `pip install -r requirements.txt`
3. Run: `apify run`
4. Or use Apify CLI: `apify call [actor-id] --input input.json`

## Deployment

- Deploy to Apify platform via [Apify Console](https://console.apify.com)
- Build minutes: ~1 min per 10 files
- Memory: 1GB recommended

## Limitations

- Only supports MP4 input (H.264/AAC typically)
- Max file size: 100MB per file
- No video editing/subtitle extraction

## Troubleshooting

- **Download fails**: Check URL accessibility and CORS
- **Conversion errors**: Ensure audio track exists in MP4
- **High memory**: Reduce `maxConcurrency`

## Development

Fork this repo and contribute! See [CONTRIBUTING.md](CONTRIBUTING.md).

Uses:
- `ffmpeg` for conversion
- `requests` for downloads
- Apify SDK for storage

## License

MIT License - see [LICENSE](LICENSE) file.

---
*Built with ❤️ for Apify platform*