VdoKit

VdoKit is a simple Java GUI-based FFMPEG wrapper.
It allows users to perform common video operations like format conversion and caption embedding using an easy Swing interface.

---

📌 Table of Contents

• ✨ Features
• 🛠 Requirements
• 📥 Installation
• ▶️ Run
• 📂 Project Structure
• 🙏 Credits
• 📜 License
• 👨‍💻 Author

---

✨ Features

✅ Video Format Conversion

• Convert videos into different formats (mp4, mkv, webm, avi, etc.)
• Simple file selection system
• Output file is automatically generated

✅ Caption Embedding

Supports both:

🔹 Soft Embedding (Subtitle Track)

• Adds subtitle file as a subtitle track
• Subtitles can be turned ON/OFF in media players

🔹 Hard Embedding (Burn Subtitles)

• Permanently burns subtitles into the video

✅ Video Scaling

• Optional scaling feature using FFmpeg scale filter
• Includes predefined resolutions (1920x1080, 1280x720, etc.)
• Scaling option can be enabled/disabled with a checkbox

✅ Progress Panel

• Shows progress panel while FFmpeg process is running
• Prevents UI freezing using SwingWorker

---

🛠 Requirements

• Java 17+ (Recommended)
• FFmpeg (Required)
  • FFmpeg must be installed on the system
  • FFmpeg executable must be accessible from the system PATH

---

📥 Installation

1. Install FFmpeg

Install FFmpeg on your operating system.

• Windows:

  • Download FFmpeg from the official website: https://ffmpeg.org/download.html
  • Add the FFmpeg bin directory to your system PATH

• Linux:

  • Install FFmpeg using your package manager

Example: sudo apt install ffmpeg

2. Verify Installation

• Open a terminal and run: ffmpeg -version
  • If FFmpeg is installed correctly, version information will be displayed.

---

▶️ Run

• Windows

  • Run: scripts/build.bat

• Linux

  • Run: bash chmod +x scripts/run.sh ./scripts/run.sh

---

📂 Project Structure

src
├── main
│   └── java
│       └── dev
│           └── vdokit
│               ├── core
│               │   └── ProcessRunner.java
│               ├── platform
│               │   └── PlatformDetector.java
│               ├── request
│               │   ├── CaptionRequest.java
│               │   └── FormatRequest.java
│               ├── ui
│               │   ├── CaptionPanel.java
│               │   ├── FormatPanel.java
│               │   ├── MainFrame.java
│               │   ├── MainPanel.java
│               │   └── ProgressPanel.java
│               └── VdoKitApp.java
└── resources
      └── icons

---

🙏 Credits

This project uses the FFmpeg multimedia framework.
FFmpeg is developed and maintained by the FFmpeg team.
Official website: https://ffmpeg.org/

---

📜 License

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

---

👨‍💻 Author

Developed by its-mohitkumar-7