A modern web application for managing audio and subtitle tracks within video files (MKV, MP4, and more). Upload a video, view all its tracks, and edit them: rename, reorder, add, remove, change language, adjust sync, convert formats, all from your browser.
Most video files downloaded from the internet come packed with dozens of audio and subtitle tracks in languages you will never use. Media players like Windows Media Player pick tracks unpredictably when there are too many options, and sometimes files come with barely any subtitles at all, making it impossible for non-English speakers to watch.
Tools like MKVToolNix exist and are powerful, but they are not exactly beginner-friendly. Other solutions are either outdated, overly complex, or paid. Track Manager was built to be a simple, visual, completely local alternative that anyone can use.
- View all tracks with codec, language, bitrate, and more
- Rename tracks with inline editing
- Change language from a dropdown selector
- Set default track for audio and subtitles
- Disable tracks so they are truly invisible to media players (with undo)
- Set forced flag on subtitle tracks
- Adjust sync/delay to fix audio or subtitle timing offset
- Reorder tracks with drag and drop
- Add tracks by importing external audio or subtitle files
- Remove tracks with undo support
- Bulk operations to select, enable, disable, or remove multiple tracks at once
- Subtitle preview showing the first lines of subtitle text
- Format conversion to remux between MKV and MP4 (no re-encoding)
- Custom export filename to rename the file on download
- Dark/light theme with persistent preference
- Operation history showing a log of all changes in the current session
- Keyboard shortcuts including Ctrl+Z (undo), Ctrl+A (select all), Delete (remove selected)
- Responsive design that works on desktop and mobile
- Python 3.12+
- Node.js 18+
- FFmpeg
- MKVToolNix (for MKV-specific features)
Quick way (Windows): Double-click start.bat. It installs dependencies, starts both servers, and opens your browser.
Manual way:
# Clone the repository
git clone https://github.com/Cabacadosinformaticos/Track-Manager.git
cd Track-Manager
# Backend
cd backend
pip install -r requirements.txt
python -m uvicorn main:app --port 8000
# Frontend (new terminal)
cd frontend
npm install
npm run devOpen http://localhost:5173 in your browser.
For detailed instructions (troubleshooting, Linux/macOS, etc.), see QUICKSTART.md.
| Layer | Technology |
|---|---|
| Frontend | React 19, TypeScript, Vite, Tailwind CSS v4, Framer Motion, dnd-kit, Lucide Icons |
| Backend | Python 3.12, FastAPI, Uvicorn |
| Tools | FFmpeg (MP4/general), MKVToolNix (MKV-specific) |
- Quick Start for detailed setup instructions and troubleshooting
- Features for the complete feature list with descriptions
- Architecture for system design, data flow, and service layers
- API Reference for all backend endpoints documented
- Development Guide for setup, project structure, and how to contribute
- Journey for the story behind the project and the progress diary
MIT License. See LICENSE for details.