---
license: other
license_name: salman-alfarisi-proprietary-license-v1.0
license_link: LICENSE
---
---

# 🎬 Free Video Converter (Gradio + FFmpeg)

A lightweight Gradio web app to convert **video ⇄ video** and **video/audio ⇄ audio** locally using FFmpeg.
Upload a file, pick a target format, watch the progress pop-up, then download the result—fast and simple.


---

## 📑 Table of Contents

1. [Features](#features)
2. [Project Structure](#project-structure)
3. [Prerequisites](#prerequisites)
4. [Installation](#installation)
5. [Running Locally](#running-locally)
6. [Usage](#usage)
7. [Settings (CRF & Preset)](#settings-crf--preset)
8. [Deploy to Hugging Face](#deploy-to-hugging-face)
9. [Troubleshooting](#troubleshooting)
10. [Contributing](#contributing)
11. [License](#license)
12. [Author & Credits](#author--credits)

---

## ✨ Features

* **Many Formats, One Click**

  * **Video targets:** `mp4`, `avi`, `flv`, `mov`, `wmv`, `mkv`, `webm`
  * **Audio targets:** `mp3`, `wav`, `flac`, `ogg`, `m4a`, `aac`, `wma`

* **Smart Targeting**
  Input format is automatically hidden from the target list; defaults to **mp4** (video) or **mp3** (audio).

* **Language Switcher (🇮🇩 / 🇺🇸)**
  Toggle Indonesian/English texts on the fly.

* **Progress Pop-up & UI Lock**
  A “Converting… please wait.” modal appears, and all controls are disabled until the job is done.

* **One-click Download**
  A green **Download result** button appears once conversion finishes.

* **CPU-friendly**
  Optimized defaults for 2 vCPU (e.g., Hugging Face Spaces), with Gradio queue limits pre-tuned.

* **Local / Offline**
  Runs entirely on your machine/Space; no third-party upload.

<p align="center">
  <img src="demo.png" alt="Demo Screenshot" width="780">
</p>

---

## 📁 Project Structure

```
videoconverter/
├── videoconverter.py         # Gradio app (ID/EN, progress modal, downloader)
├── requirements.txt          # Python deps (e.g., gradio)
├── apt.txt                   # System deps for Spaces (ffmpeg)
├── LICENSE                   # "All Rights Reserved"
├── README.md
└── .gitignore
```

> **Note:** The app expects `ffmpeg` to be available on the system (also installs via `apt.txt` on Spaces).

---

## ⚙️ Prerequisites

* **Python 3.10+**
* **FFmpeg** (includes `ffmpeg` and `ffprobe`)
* `git` & a terminal

Install FFmpeg locally:

**Ubuntu/Debian**

```bash
sudo apt update && sudo apt install -y ffmpeg
```

**macOS (Homebrew)**

```bash
brew install ffmpeg
```

**Windows (winget)**

```powershell
winget install Gyan.FFmpeg
```

---

## 🔧 Installation

1. Clone this repository:

```bash
git clone https://github.com/salmanalfarisi11/video-converter.git
cd video-converter
```

2. Create and activate a virtual environment:

```bash
python -m venv .venv
# Linux/macOS
source .venv/bin/activate
# Windows
.venv\Scripts\activate
```

3. Install Python dependencies:

```bash
pip install -r requirements.txt
```

---

## 🚀 Running Locally

Start the app:

```bash
python videoconverter.py
```

* Default URL: [http://127.0.0.1:7860](http://127.0.0.1:7860)
* Want a temporary public link? Set `share=True` in `demo.launch(...)`.

---

## 🎯 Usage

1. **Upload** a video or audio file.
2. **Choose a target** format (to video / to audio).
3. (Optional) Set **CRF** and **Ultra fast preset**.
4. Click **Convert**. A modal “Converting…” appears and the UI is locked.
5. When done, click the **Download result** button to save your file.

---

## ⚙️ Settings (CRF & Preset)

* **CRF H.264 (lower = better quality)**

  * Applies to H.264 outputs (e.g., **mp4**, **mov**).
  * Typical range: **18–28**.
  * **Lower CRF → higher quality & bigger file**, conversion a bit slower.
  * **Higher CRF → smaller file**, conversion faster.

* **Ultra fast preset (ultrafast)**

  * Uses `-preset ultrafast` for **libx264** to speed up CPU encoding at the cost of larger files.
  * Uncheck it if you prefer better compression (smaller size) with **slower** conversion.

---

## ☁️ Deploy to Hugging Face

1. Create a **New Space** → **Gradio** → (Public or Private).

2. Upload these files:

   * `videoconverter.py`
   * `requirements.txt` (e.g., `gradio==5.32.1`)
   * `apt.txt` with:

     ```
     ffmpeg
     ```
   * `README.md`, `LICENSE`, `.gitignore` (optional but recommended)

3. In **README.md**, you can add HF metadata front-matter (optional):

```yaml
---
title: Free Video Converter
emoji: 🎬
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 5.32.1
app_file: videoconverter.py
license: other   # proprietary
pinned: false
---
```

The Space will build and run automatically.

---

## 🛠️ Troubleshooting

* **“FFmpeg not found”**
  Ensure `ffmpeg` is installed and on your PATH (`ffmpeg -version`). On Spaces, keep `ffmpeg` inside `apt.txt`.

* **Conversion is slow**

  * Enable **Ultra fast preset**.
  * Use a **higher CRF** for H.264.
  * Prefer **mp4**/**mp3** which are typically faster on CPU.

* **Out of storage** (Spaces with small disks)

  * Delete large outputs frequently.
  * Reduce file sizes using higher CRF or lower bitrates.

---

## 🤝 Contributing

Bug reports, suggestions, or PRs are welcome (even though the code is proprietary, you can propose changes via issues/patches if the repo is public).

---

## 📄 License

**All Rights Reserved** — see [LICENSE](LICENSE).
You may **not** copy, modify, redistribute, or use this software without explicit permission from the copyright holder.

---

## 🖋️ Author & Credits

Developed by **[Salman Alfarisi](https://github.com/salmanalfarisi11)** © 2025

* GitHub: [salmanalfarisi11](https://github.com/salmanalfarisi11)
* LinkedIn: [salmanalfarisi11](https://linkedin.com/in/salmanalfarisi11)
* Instagram: [faris.salman111](https://instagram.com/faris.salman111)

Built with ❤️ using **Gradio** and **FFmpeg**.
If this project helps you, please ⭐ the repo!