Cigym is a Python-based tool designed to automate the creation of high-quality, cinematic gym edits. It allows users to generate dynamic edits with synced music, transitions, and animated text overlays, all with minimal manual intervention.
Note that the video quality only looks worse because it is displayed as a GIF for the purpose this README.
-
Automatic Clipping The most important parts of an audio are detected and used as markers to clip together videos.
-
Animated Text Effects The lyrics of any sound are automatically detected and shown in the video at their desired timestamps with the following effects:
- 50+ font styles
- Rapidly changing text
- Text behind a person
-
Filter Application A custom Ffmpeg command is run to turn any video into a more cinematic experience by colour grading, changing brightness, etc. fading, and volume adjustments
-
GUI Support
Interactive interface to:- Preview edits in real-time
- Adjust text style and timestamps
- Automatic text snapping for a clean editing experience
- Python 3.10+
- FFmpeg installed and added to your system PATH
- Clone this repository:
git clone https://github.com/yourusername/gym-video-editor.git
cd gym-video-editor- Ensure FFmpeg is installed and accessible from your terminal
- Install all the dependencies
pip install -r requirements.txt- Launch the GUI:
python gui.py- For any custom changes/scripting (i.e. manually changing highlight locations), locate the
combine.pyfile and run themanual_highlight_processing()function. - The finished result will be located in
/io_filesas the most recentoutput_subtitles*.mp4.
- Developer: Lucas Jin
- Libraries & Tools:
- FFmpeg – video/audio processing
- PySide6 – GUI framework
- NumPy – audio and video analysis
- SciPy – highlight detection & waveform analxysis
- Robust Video Matting - model to remove background
- Cross-platform: Works on Windows, macOS, and Linux
- Customization: All text styles, transitions, and audio settings are configurable via GUI or script parameters