MediaFlow

A modern YouTube media converter with support for MP3 and MP4 formats

---

MediaFlow is a media management system with separate API and client components.

Prerequisites

• Docker
• Docker Compose
• Git

Getting Started

1. Clone the repository with submodules:

git clone --recursive https://github.com/pointedsec/MediaFlow.git

2. Navigate to the project directory:

cd MediaFlow

3. Modify the docker-compose.yml file with the following environment variables:

 environment:
      PORT: 3000
      JWT_SECRET: "REPLACE WITH A SAME LENGTH JWT SECRET OR USE THE DEFAULT USED IN THE ORIGINAL FILE"
      GOOGLE_CLOUD_API_KEY: "YOUR_GOOGLE_CLOUD_API_KEY"

4. Modify the ./client/.env file with your local/public IP Address (remember, the API have to be reachable from the public to expose this to the internet, so do your port forwarding okay!)

VITE_API_URL = "http://192.168.1.111:3000/api/"

5. Start the application using Docker Compose:

docker compose up --build -d

This will start the following services:

• API (Backend) - Available at http://localhost:3000
• Client (Frontend) - Available at http://localhost:5173

Development

To stop the services

docker compose down

To view logs:

docker compose logs -f

Project Structure

MediaFlow/
├── api/          # Backend API service
├── client/       # Frontend client service
└── docker-compose.yml

Contributing

• Fork the repository (Or api/client repository)
• Create your feature branch ( git checkout -b feature/amazing-feature )
• Commit your changes ( git commit -m 'Add some amazing feature' )
• Push to the branch ( git push origin feature/amazing-feature )
• Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.