<p align="center">
<img src="images/logo_small.png" alt="Logo" width="250">
</p>
<h1 align="center">Video Smartcut</h1>
This tool is an open-source CLI companion to [Smart Media Cutter](https://smartmediacutter.com).
`smartcut` can cut video files in many different formats and codecs with only minimal recoding around the cutpoints (a.k.a. "smart cut").
This means that you can cut even long video files in seconds!
In contrast, [Smart Media Cutter](https://smartmediacutter.com) is fully-featured linear video editor with a lot more features like: Easy to use GUI, Transcript based editing (edit videos like text documents), Automatic silence cutting, Export timeline to editors like Resolve & Premiere and a generous free tier.
## Demo
<p align="center">
<a href=https://youtu.be/_OBDNVxydB4><img src="images/yt_thumbnail.png" alt="Logo" width="400"></a>
</p>
## Open Sourced Features
- **Efficient Cutting**: `smartcut` only recodes around the cutpoints, preserving the majority of the original video quality.
- **Flexible Input**: Supports a wide range of video/audio formats and codecs.
- **Flexible cutting**: Allows for both "keep" and "cut" operations based on specified input times.
- **Audio Export**: Includes all audio tracks by default with nearly lossless passthrough.
## Installation
Get built binaries for Windows and Linux from [releases](https://github.com/skeskinen/smartcut/releases).
To install from source:
```
# Clone this repository:
git clone https://github.com/skeskinen/smartcut.git
cd smartcut
# Create python virtual environment:
python -m venv .venv
source .venv/bin/activate
# Install the required dependencies:
pip install -r requirements.txt
# Run:
python ./smartcut input.mp4 output.mp4 --keep 10,20,40,50
```
## Usage
The CLI requires the input and output file paths as positional arguments. You can specify the segments to keep or cut using the `--keep` or `--cut` options.
### Basic Commands
- **Keep specific segments**:
`smartcut.exe input.mp4 output.mp4 --keep 10,20,40,50`
This keeps the segments from 10s to 20s and from 40s to 50s.
- **Cut specific segments**:
`smartcut.exe input.mp4 output.mp4 --cut 30,40,01:00,01:10`
This cuts out the segments from 30s to 40s and from 1m to 1m10s, keeping the rest.
- **Various shorthands**:
```bash
smartcut input.mp4 output.mp4 -k 10,20,40,50 # -k for --keep
smartcut input.mp4 output.mp4 -c 30,35 # -c for --cut
# Video start end keywords: s/start and e/end
smartcut input.mp4 output.mp4 -k start,30,01:00,end
smartcut input.mp4 output.mp4 -k s,30,60,e
# Negative timestamps for counting from end of file
smartcut input.mp4 output.mp4 -c "-5,end" # Cut last 5 seconds
smartcut input.mp4 output.mp4 -k 10,-10 # Keep 10s to 10s from end
smartcut input.mp4 output.mp4 -k 0,-1:30 # Keep all but last 1m30s
```
- **Specify log level**:
`smartcut.exe input.mp4 output.mp4 --keep 10,20 --log-level info`
### Audio Export
By default, all audio tracks are included with passthrough codec settings. This can be adjusted by modifying the `AudioExportInfo` in the script if needed.
## Contributing
Contributions are welcome! All the code will be licensed under MIT license.
Any changes have to work with the closed-source GUI app as well, so please coordinate with me if you want to make significant changes. You can find me on [discord](https://discord.gg/uYGkyfzU4c) most of the time.
## Testing
We have ok test coverage for various video and audio formats. Video tests check that pixel values are ~unchanged. In audio testing it's harder to check if the output is the same as input, but we try our best by checking the correlation of input&output as well as absolute diff.
Some of the tests depend on components in the GUI app that are not open-source. These tests are disabled.
Some commands to run different subsets of tests:
```bash
# Test synthetic H.264 tests only
python smartcut_tests.py --category h264
# Test only real-world H.264 videos
python smartcut_tests.py --category real_world_h264
# Test all real-world videos (all codecs)
python smartcut_tests.py --category real_world
# See all available categories
python smartcut_tests.py --list-categories
```
Normal test run looks like this:
```
Skipping smc tests
test_h264_cut_on_keyframes: PASS
test_h264_smart_cut: PASS
test_h264_24_fps_long: PASS
test_h264_1080p: PASS
test_h264_multiple_cuts: PASS
test_h264_profile_baseline: PASS
test_h264_profile_main: PASS
test_h264_profile_high: PASS
test_h264_profile_high10: PASS
test_h264_profile_high422: PASS
test_h264_profile_high444: PASS
test_mp4_cut_on_keyframe: PASS
test_mp4_smart_cut: PASS
test_mp4_to_mkv_smart_cut: PASS
test_mkv_to_mp4_smart_cut: PASS
test_vp9_smart_cut: PASS
test_vp9_profile_1: PASS
test_av1_smart_cut: PASS
test_avi_smart_cut: PASS
test_flv_smart_cut: PASS
test_mov_smart_cut: PASS
test_wmv_smart_cut: PASS
test_mpg_cut_on_keyframes: PASS
test_mpg_smart_cut: PASS
test_m2ts_mpeg2_smart_cut: PASS
test_m2ts_h264_smart_cut: PASS
test_ts_smart_cut: PASS
test_night_sky: PASS
test_night_sky_to_mkv: PASS
test_sunset: PASS
test_h265_cut_on_keyframes: PASS
test_h265_smart_cut: PASS
test_h265_smart_cut_large: PASS
test_mp4_h265_smart_cut: PASS
test_vertical_transform: PASS
x265 [warning]: Source height < 720p; disabling lookahead-slices
x265 [warning]: Source height < 720p; disabling lookahead-slices
test_video_recode_codec_override: PASS
test_vorbis_passthru: PASS
test_mkv_with_video_and_audio_passthru: PASS
test_mp3_passthru: PASS
test_seeking: PASS
Tests ran in 153.6s
```
## Acknowledgements
* This project is part of [Smart Media Cutter](https://smartmediacutter.com)
* We use [PyAV](https://github.com/PyAV-Org/PyAV) to interface with [ffmpeg](https://www.ffmpeg.org/) internals in a pythonic way
* [avcut](https://github.com/anyc/avcut) is one of better smartcut implementations and their code was useful in understanding some of the nuances
## Other projects
* [lossless-cut](https://github.com/mifi/lossless-cut) has an experimental smartcut mode. Being an experimental feature, it's not really supported. [Link to discussion](https://github.com/mifi/lossless-cut/issues/126)
* [VidCutter](https://github.com/ozmartian/vidcutter) also has an experimental smartcut mode.
* [This shell script github gist](https://gist.github.com/fernandoherreradelasheras/5eca67f4200f1a7cc8281747da08496e) inspired the lossless-cut implementation of smartcutting.
* [VideoReDo](https://www.videohelp.com/software/VideoReDo) was a popular closed source frame accurate video trimming tool. It is no longer supported.
* [SolveigMM Video Splitter](https://www.solveigmm.com/en/products/video-splitter/) and [TMPGEnc MPEG Smart Renderer](https://tmpgenc.pegasys-inc.com/en/product/tmsr6.html) are 2 other commercial smartcutting tools. I have no experience with these. [Here's one review](https://github.com/mifi/lossless-cut/issues/126#issuecomment-2035823788)
* [mp3splt](https://mp3splt.sourceforge.net/mp3splt_page/home.php) does lossless cutting of mp3, vorbis and other audio formats
* [mp3DirectCut](https://mpesch3.de/) is a proprietary audio lossless cutting tool. This one supports mp3 and aac.
* [Avidemux](https://avidemux.sourceforge.net/) used to have a mode called [SmartCopy](https://www.avidemux.org/admWiki/doku.php?id=using:cutting#intra_frames_and_smartcopy) but according to [this forum post](https://avidemux.org/smif/index.php?topic=16372.0) it was removed in avidemux 2.6 and current version only supports cutting on keyframes (at least I think so).
* [Machete](https://www.machetesoft.com/) Quick and light lossless video cutting tool. Not free, but has a 14-day trial version.
## Version History
### 1.3
* Update to PyAV 15.0
* Fixed some critical issues in h264 and h265 smartcutting
* A lot more tests with real world videos
* Improve command line time parameter handling
* Preserve disposition data when cutting (forced subtitles, etc.) #14
### 1.2
* [#11](https://github.com/skeskinen/smartcut/pull/11) Allow frame number input instead of time input, by snelg
Starting from this version the Windows binaries are unsigned. This means that you'll probably get a security warning about running unsigned code. If this bothers you, you can either use older versions or run the software from source code.
### 1.1
* Cut subtitle tracks
* Add support for MPEG-2 cutting and more container formats (.flv, .mov, .wmv, .avi)
* Add timecode format hh:mm:ss to the command line interface
### 1.0
* Initial opensource release
* Frame accurate smart cutting of most modern video codecs (h264, h265, vp9, av1)
Raw data
{
"_id": null,
"home_page": null,
"name": "smartcut",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "Santtu Keskinen <santtu.keskinen@gmail.com>",
"keywords": "video, cutting, editing, ffmpeg, smart-cut, lossless, frame-accurate, cli, video-processing",
"author": null,
"author_email": "Santtu Keskinen <santtu.keskinen@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/34/d3/8b2b363425feb7a4b06986f69ad294d4c65e637b0702831873ec8471ffdd/smartcut-1.3.0.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\"images/logo_small.png\" alt=\"Logo\" width=\"250\">\n</p>\n\n<h1 align=\"center\">Video Smartcut</h1>\n\n\n\nThis tool is an open-source CLI companion to [Smart Media Cutter](https://smartmediacutter.com).\n\n`smartcut` can cut video files in many different formats and codecs with only minimal recoding around the cutpoints (a.k.a. \"smart cut\").\n\nThis means that you can cut even long video files in seconds!\n\nIn contrast, [Smart Media Cutter](https://smartmediacutter.com) is fully-featured linear video editor with a lot more features like: Easy to use GUI, Transcript based editing (edit videos like text documents), Automatic silence cutting, Export timeline to editors like Resolve & Premiere and a generous free tier.\n\n## Demo\n<p align=\"center\">\n <a href=https://youtu.be/_OBDNVxydB4><img src=\"images/yt_thumbnail.png\" alt=\"Logo\" width=\"400\"></a>\n</p>\n\n## Open Sourced Features\n\n- **Efficient Cutting**: `smartcut` only recodes around the cutpoints, preserving the majority of the original video quality.\n- **Flexible Input**: Supports a wide range of video/audio formats and codecs.\n- **Flexible cutting**: Allows for both \"keep\" and \"cut\" operations based on specified input times.\n- **Audio Export**: Includes all audio tracks by default with nearly lossless passthrough.\n\n## Installation\n\nGet built binaries for Windows and Linux from [releases](https://github.com/skeskinen/smartcut/releases).\n\nTo install from source:\n```\n# Clone this repository:\ngit clone https://github.com/skeskinen/smartcut.git\ncd smartcut\n# Create python virtual environment:\npython -m venv .venv\nsource .venv/bin/activate\n# Install the required dependencies:\npip install -r requirements.txt\n# Run:\npython ./smartcut input.mp4 output.mp4 --keep 10,20,40,50\n```\n\n## Usage\n\nThe CLI requires the input and output file paths as positional arguments. You can specify the segments to keep or cut using the `--keep` or `--cut` options.\n\n### Basic Commands\n\n- **Keep specific segments**:\n\n `smartcut.exe input.mp4 output.mp4 --keep 10,20,40,50`\n\n This keeps the segments from 10s to 20s and from 40s to 50s.\n\n- **Cut specific segments**:\n\n `smartcut.exe input.mp4 output.mp4 --cut 30,40,01:00,01:10`\n\n This cuts out the segments from 30s to 40s and from 1m to 1m10s, keeping the rest.\n\n- **Various shorthands**:\n```bash\n smartcut input.mp4 output.mp4 -k 10,20,40,50 # -k for --keep\n smartcut input.mp4 output.mp4 -c 30,35 # -c for --cut\n\n # Video start end keywords: s/start and e/end\n smartcut input.mp4 output.mp4 -k start,30,01:00,end\n smartcut input.mp4 output.mp4 -k s,30,60,e\n\n # Negative timestamps for counting from end of file\n smartcut input.mp4 output.mp4 -c \"-5,end\" # Cut last 5 seconds\n smartcut input.mp4 output.mp4 -k 10,-10 # Keep 10s to 10s from end\n smartcut input.mp4 output.mp4 -k 0,-1:30 # Keep all but last 1m30s\n```\n\n- **Specify log level**:\n\n `smartcut.exe input.mp4 output.mp4 --keep 10,20 --log-level info`\n\n### Audio Export\n\nBy default, all audio tracks are included with passthrough codec settings. This can be adjusted by modifying the `AudioExportInfo` in the script if needed.\n\n## Contributing\n\nContributions are welcome! All the code will be licensed under MIT license.\n\nAny changes have to work with the closed-source GUI app as well, so please coordinate with me if you want to make significant changes. You can find me on [discord](https://discord.gg/uYGkyfzU4c) most of the time.\n\n## Testing\n\nWe have ok test coverage for various video and audio formats. Video tests check that pixel values are ~unchanged. In audio testing it's harder to check if the output is the same as input, but we try our best by checking the correlation of input&output as well as absolute diff.\n\nSome of the tests depend on components in the GUI app that are not open-source. These tests are disabled.\n\nSome commands to run different subsets of tests:\n```bash\n # Test synthetic H.264 tests only\n python smartcut_tests.py --category h264\n\n # Test only real-world H.264 videos\n python smartcut_tests.py --category real_world_h264\n\n # Test all real-world videos (all codecs)\n python smartcut_tests.py --category real_world\n\n # See all available categories\n python smartcut_tests.py --list-categories\n```\n\n\nNormal test run looks like this:\n```\nSkipping smc tests\ntest_h264_cut_on_keyframes: PASS\ntest_h264_smart_cut: PASS\ntest_h264_24_fps_long: PASS\ntest_h264_1080p: PASS\ntest_h264_multiple_cuts: PASS\ntest_h264_profile_baseline: PASS\ntest_h264_profile_main: PASS\ntest_h264_profile_high: PASS\ntest_h264_profile_high10: PASS\ntest_h264_profile_high422: PASS\ntest_h264_profile_high444: PASS\ntest_mp4_cut_on_keyframe: PASS\ntest_mp4_smart_cut: PASS\ntest_mp4_to_mkv_smart_cut: PASS\ntest_mkv_to_mp4_smart_cut: PASS\ntest_vp9_smart_cut: PASS\ntest_vp9_profile_1: PASS\ntest_av1_smart_cut: PASS\ntest_avi_smart_cut: PASS\ntest_flv_smart_cut: PASS\ntest_mov_smart_cut: PASS\ntest_wmv_smart_cut: PASS\ntest_mpg_cut_on_keyframes: PASS\ntest_mpg_smart_cut: PASS\ntest_m2ts_mpeg2_smart_cut: PASS\ntest_m2ts_h264_smart_cut: PASS\ntest_ts_smart_cut: PASS\ntest_night_sky: PASS\ntest_night_sky_to_mkv: PASS\ntest_sunset: PASS\ntest_h265_cut_on_keyframes: PASS\ntest_h265_smart_cut: PASS\ntest_h265_smart_cut_large: PASS\ntest_mp4_h265_smart_cut: PASS\ntest_vertical_transform: PASS\nx265 [warning]: Source height < 720p; disabling lookahead-slices\nx265 [warning]: Source height < 720p; disabling lookahead-slices\ntest_video_recode_codec_override: PASS\ntest_vorbis_passthru: PASS\ntest_mkv_with_video_and_audio_passthru: PASS\ntest_mp3_passthru: PASS\ntest_seeking: PASS\nTests ran in 153.6s\n```\n\n## Acknowledgements\n\n* This project is part of [Smart Media Cutter](https://smartmediacutter.com)\n* We use [PyAV](https://github.com/PyAV-Org/PyAV) to interface with [ffmpeg](https://www.ffmpeg.org/) internals in a pythonic way\n* [avcut](https://github.com/anyc/avcut) is one of better smartcut implementations and their code was useful in understanding some of the nuances\n\n\n## Other projects\n\n* [lossless-cut](https://github.com/mifi/lossless-cut) has an experimental smartcut mode. Being an experimental feature, it's not really supported. [Link to discussion](https://github.com/mifi/lossless-cut/issues/126)\n* [VidCutter](https://github.com/ozmartian/vidcutter) also has an experimental smartcut mode.\n* [This shell script github gist](https://gist.github.com/fernandoherreradelasheras/5eca67f4200f1a7cc8281747da08496e) inspired the lossless-cut implementation of smartcutting.\n* [VideoReDo](https://www.videohelp.com/software/VideoReDo) was a popular closed source frame accurate video trimming tool. It is no longer supported.\n* [SolveigMM Video Splitter](https://www.solveigmm.com/en/products/video-splitter/) and [TMPGEnc MPEG Smart Renderer](https://tmpgenc.pegasys-inc.com/en/product/tmsr6.html) are 2 other commercial smartcutting tools. I have no experience with these. [Here's one review](https://github.com/mifi/lossless-cut/issues/126#issuecomment-2035823788)\n* [mp3splt](https://mp3splt.sourceforge.net/mp3splt_page/home.php) does lossless cutting of mp3, vorbis and other audio formats\n* [mp3DirectCut](https://mpesch3.de/) is a proprietary audio lossless cutting tool. This one supports mp3 and aac.\n* [Avidemux](https://avidemux.sourceforge.net/) used to have a mode called [SmartCopy](https://www.avidemux.org/admWiki/doku.php?id=using:cutting#intra_frames_and_smartcopy) but according to [this forum post](https://avidemux.org/smif/index.php?topic=16372.0) it was removed in avidemux 2.6 and current version only supports cutting on keyframes (at least I think so).\n* [Machete](https://www.machetesoft.com/) Quick and light lossless video cutting tool. Not free, but has a 14-day trial version.\n\n## Version History\n\n### 1.3\n* Update to PyAV 15.0\n* Fixed some critical issues in h264 and h265 smartcutting\n* A lot more tests with real world videos\n* Improve command line time parameter handling\n* Preserve disposition data when cutting (forced subtitles, etc.) #14\n\n### 1.2\n* [#11](https://github.com/skeskinen/smartcut/pull/11) Allow frame number input instead of time input, by snelg\n\nStarting from this version the Windows binaries are unsigned. This means that you'll probably get a security warning about running unsigned code. If this bothers you, you can either use older versions or run the software from source code.\n\n### 1.1\n* Cut subtitle tracks\n* Add support for MPEG-2 cutting and more container formats (.flv, .mov, .wmv, .avi)\n* Add timecode format hh:mm:ss to the command line interface\n\n### 1.0\n* Initial opensource release\n* Frame accurate smart cutting of most modern video codecs (h264, h265, vp9, av1)\n",
"bugtrack_url": null,
"license": null,
"summary": "CLI tool for efficient video cutting with minimal recoding",
"version": "1.3.0",
"project_urls": {
"Bug Tracker": "https://github.com/skeskinen/smartcut/issues",
"Changelog": "https://github.com/skeskinen/smartcut/blob/main/README.md#version-history",
"Commercial GUI": "https://smartmediacutter.com",
"Documentation": "https://github.com/skeskinen/smartcut/blob/main/README.md",
"Homepage": "https://github.com/skeskinen/smartcut",
"Repository": "https://github.com/skeskinen/smartcut.git"
},
"split_keywords": [
"video",
" cutting",
" editing",
" ffmpeg",
" smart-cut",
" lossless",
" frame-accurate",
" cli",
" video-processing"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "17c57566050e180e0af03d8f4d5f2824978ffb06da430b9567287dfafede5af9",
"md5": "4ea7d810f15bccf0fb40ac0ace33fd38",
"sha256": "8651c4637dfb4f2eddcd04db3ba220384864e002a9662a151cbab3ec69617d51"
},
"downloads": -1,
"filename": "smartcut-1.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4ea7d810f15bccf0fb40ac0ace33fd38",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 22612,
"upload_time": "2025-08-28T15:43:30",
"upload_time_iso_8601": "2025-08-28T15:43:30.927880Z",
"url": "https://files.pythonhosted.org/packages/17/c5/7566050e180e0af03d8f4d5f2824978ffb06da430b9567287dfafede5af9/smartcut-1.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "34d38b2b363425feb7a4b06986f69ad294d4c65e637b0702831873ec8471ffdd",
"md5": "eadfc5a0ccf1304e5dba6a8a34c21859",
"sha256": "7c7082e0fdc33787496a037dea173d221036cb54bac7310c68727f6fe426e62d"
},
"downloads": -1,
"filename": "smartcut-1.3.0.tar.gz",
"has_sig": false,
"md5_digest": "eadfc5a0ccf1304e5dba6a8a34c21859",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 25261,
"upload_time": "2025-08-28T15:43:32",
"upload_time_iso_8601": "2025-08-28T15:43:32.664470Z",
"url": "https://files.pythonhosted.org/packages/34/d3/8b2b363425feb7a4b06986f69ad294d4c65e637b0702831873ec8471ffdd/smartcut-1.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-28 15:43:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "skeskinen",
"github_project": "smartcut",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "numpy",
"specs": []
},
{
"name": "av",
"specs": [
[
"==",
"15.0"
]
]
},
{
"name": "tqdm",
"specs": []
}
],
"lcname": "smartcut"
}
JSON
