Skip to content

Aaryan-dw/ConvertIT

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 ConvertIT - Audio/Video Converter

ConvertIT is a simple web-based media conversion tool built using Flask and FFmpeg.
It allows users to convert audio to video and video to audio with optional image or color backgrounds.


✨ Features

🎧 Audio → Video

  • Convert audio files into video format
  • Add custom image background OR solid color
  • Output formats: MP4, MKV

🎥 Video → Audio

  • Extract audio from video files
  • Output formats: MP3, WAV, AAC

⚙️ General Features

  • Simple and clean UI
  • Fast processing using FFmpeg
  • Supports multiple formats
  • Error handling with logs

🛠️ Tech Stack

  • Backend: Python (Flask)
  • Media Engine: FFmpeg
  • Frontend: HTML, CSS

📋 Requirements

  1. Python 3.7+
  2. FFmpeg installed and added to PATH

✅ Check FFmpeg:

ffmpeg -version

🚀 Installation

1. Clone Repository

git clone https://github.com/your-username/ConvertIT.git
cd ConvertIT

2. Create Virtual Environment

python -m venv .venv
.venv\Scripts\activate   # Windows

3. Install Dependencies

pip install flask werkzeug

▶️ Run the App

python app.py

Open browser:

http://127.0.0.1:5000

📁 Project Structure

ConvertIT/
│── app.py
│── requirements.txt
│── README.md
│── uploads/
│── outputs/
└── templates/
    └── index.html

⚙️ Configuration

You can change settings in app.py:

UPLOAD_FOLDER = "uploads"
OUTPUT_FOLDER = "outputs"

Change video resolution:

"s=1280x720"

🐳 Deployment (Fly.io / Render)

For FFmpeg support (IMPORTANT)

Use Docker:

FROM python:3.11-slim

RUN apt-get update && apt-get install -y ffmpeg

WORKDIR /app
COPY . .

RUN pip install flask werkzeug

EXPOSE 5000

CMD ["python", "app.py"]

Also update Flask:

app.run(host="0.0.0.0", port=5000)

🐛 Troubleshooting

❌ FFmpeg not found

Install FFmpeg and add to PATH.

❌ Output file not created

Check terminal logs (FFmpeg error).

❌ Large file error

Add:

app.config['MAX_CONTENT_LENGTH'] = 500 * 1024 * 1024

🚀 Future Improvements

  • Progress bar
  • Drag & drop upload
  • Cloud storage (S3 / Cloudinary)
  • User authentication
  • Video preview before download

📄 License

MIT License


🙌 Credits


💡 Author

Made by Aaryan Koirala 🚀


---

# 🔥 Why this version is better

✅ Clean (no unnecessary complexity)  
✅ Matches your actual project  
✅ Ready for GitHub + deployment  
✅ Looks professional (for portfolio)

---

# 🚀 Next step

Now run:
```bash
git add README.md
git commit -m "updated readme"
git push

About

Easy to use Media Converter

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors