chaulmark/subtitle-merge
1
0
Fork 0
Code Issues 5 Pull requests Projects Releases 1 Packages Wiki Activity Actions
M1/M2/M3 Compatible Subtitle Merger application
12 commits 1 branch 1 tag 11 MiB
Find a file
TheMaddax 436c8132d3 Empty default API key 
Warning message in TranscriptionTask when API key is empty
"Add API Key in Settings" button that opens settings modal
Error message when trying to test empty API key
No "Reset to Default" button for API key
Improved copy functionality with inline success message
Added fade-in animation for the success message
2025-01-28 12:01:49 -06:00
.vscode Initial commit: Video Subtitle Merger 2.0 2024-12-25 16:30:39 -06:00
gemini Empty default API key 2025-01-28 12:01:49 -06:00
public Initial commit: Video Subtitle Merger 2.0 2024-12-25 16:30:39 -06:00
src Empty default API key 2025-01-28 12:01:49 -06:00
src-tauri Empty default API key 2025-01-28 12:01:49 -06:00
.gitignore Initial commit: Video Subtitle Merger 2.0 2024-12-25 16:30:39 -06:00
index.html Initial commit: Video Subtitle Merger 2.0 2024-12-25 16:30:39 -06:00
package.json Fix temp dir for thumbnails 2025-01-27 08:44:42 -06:00
pnpm-lock.yaml Switch from python to go lang for gemini query 2025-01-27 21:56:05 -06:00
postcss.config.js Initial commit: Video Subtitle Merger 2.0 2024-12-25 16:30:39 -06:00
README.md Update README.md 2024-12-26 05:45:04 +00:00
tailwind.config.js Fix temp dir for thumbnails 2025-01-27 08:44:42 -06:00
tsconfig.json Initial commit: Video Subtitle Merger 2.0 2024-12-25 16:30:39 -06:00
tsconfig.node.json Initial commit: Video Subtitle Merger 2.0 2024-12-25 16:30:39 -06:00
vite.config.ts Initial commit: Video Subtitle Merger 2.0 2024-12-25 16:30:39 -06:00

README.md

Video Subtitle Merger 2.0

A desktop application that allows you to merge video files with subtitle files using FFmpeg. Built with Tauri (Rust + React), this application provides a modern, efficient interface for combining videos with subtitles.

Features

  • Merge video files with subtitle files (supports MP4, AVI, MOV, MKV videos and SRT, ASS subtitles)
  • Option to add black bars for subtitles
  • Option to resize videos to 720p resolution
  • Real-time progress tracking
  • Modern, user-friendly interface
  • Native performance with small application size
  • Cross-platform support (currently tested on macOS)

Tech Stack

  • Frontend:

    • React
    • TypeScript
    • Tailwind CSS
    • Vite

  • Backend:

    • Rust
    • Tauri
    • FFmpeg (required dependency)

Prerequisites

Before building the application, ensure you have the following installed:

  • Node.js (v16 or later)
  • Rust (latest stable)
  • FFmpeg
  • pnpm (package manager)
  • Tauri development dependencies

macOS Setup

  1. Install Rust:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  1. Install Node.js and pnpm:
brew install node
npm install -g pnpm
  1. Install FFmpeg:
brew install ffmpeg
  1. Install Tauri development dependencies:
xcode-select --install

Building from Source

  1. Clone the repository:
git clone https://gitea.sigd.net/chaulmark/subtitle-merge.git
cd subtitle-merge
  1. Install dependencies:
pnpm install
  1. Run in development mode:
pnpm tauri dev
  1. Build for production:
pnpm tauri build

The built application will be available in src-tauri/target/release/bundle/.

Usage

  1. Launch the application
  2. You may need to perform the following for MacOS to allow you to run this application:
xattr -cr "/Applications/Video Subtitle Merger 2.0.app"
  1. Select your video file using the "Select Video" button
  2. Select your subtitle file using the "Select Subtitle" button
  3. Choose your preferences:
    • Add black bar for subtitles (recommended for better readability)
    • Resize to 720p resolution (helps with file size)
  4. Click "Merge Video and Subtitle"
  5. Wait for the process to complete
  6. The merged video will be saved in the same directory as the input video

Development

The project structure follows the standard Tauri + React template:

  • /src - React frontend code
  • /src-tauri - Rust backend code
  • /src/components - React components
  • /src/styles - CSS and styling files
  • /src-tauri/src - Rust source files

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

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