1
0
mirror of https://github.com/mifi/lossless-cut.git synced 2024-11-22 10:22:31 +01:00
lossless-cut/README.md

89 lines
5.9 KiB
Markdown
Raw Normal View History

2018-10-01 01:32:51 +02:00
# LosslessCut 🎥 [![Travis](https://img.shields.io/travis/mifi/lossless-cut.svg)](https://travis-ci.org/mifi/lossless-cut) [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/mifino)
2016-10-30 11:57:12 +01:00
2018-09-15 17:12:43 +02:00
Simple and ultra fast cross platform tool for lossless trimming/cutting of video and audio files. Great for saving space by rough cutting your large video files taken from a video camera, GoPro, drone, etc. It lets you quickly extract the good parts from your videos and discard many gigabytes of data without doing a slow re-encode and thereby losing quality. It extremely fast because it does an almost direct data copy. It uses the awesome ffmpeg (included) for doing the grunt work.
2019-01-28 23:35:46 +01:00
![Demo](https://github.com/mifi/gifs/raw/master/2019-01-28-lossless-cut.gif)
2016-10-30 11:57:12 +01:00
2018-02-18 16:25:38 +01:00
## Features
- Lossless cutting of common video and audio formats
2019-01-31 20:24:49 +01:00
- Lossless re-merge of selected segments (for cutting out commercials etc.)
2019-01-29 00:09:55 +01:00
- Lossless merge of arbitrary files (with identical codecs)
- Lossless extracting of all data streams from a file (video, audio, subtitle, ++)
2018-02-18 16:25:38 +01:00
- Take full-resolution snapshots from videos in JPEG/PNG format
2018-06-06 22:20:41 +02:00
- Manual input range of cutpoints
- Can include more than 2 streams or remove audio track (optional)
2019-01-29 00:09:55 +01:00
- Apply a timecode offset
2019-01-28 12:49:26 +01:00
- Change rotation/orientation metadata in videos. Great for rotating phone videos that come out the wrong way without actually re-encoding the video.
2018-02-18 16:25:38 +01:00
2016-10-30 11:57:12 +01:00
## Installing / running
- Download [latest LosslessCut from releases](https://github.com/mifi/lossless-cut/releases)
- Run LosslessCut app/exe
2019-01-28 23:11:58 +01:00
- On macOS, to open LosslessCut.app, Right Click > Open to bypass the security warning.
2016-10-30 11:57:12 +01:00
2018-02-18 16:25:38 +01:00
## Supported platforms
2019-01-28 23:11:58 +01:00
- macOS
2016-11-05 21:43:03 +01:00
- Windows (64/32bit)
- Linux (64/32bit, not tested)
2018-02-18 16:25:38 +01:00
## Supported formats
2016-11-06 16:55:37 +01:00
2018-05-22 23:32:54 +02:00
Since LosslessCut is based on Chromium and uses the HTML5 video player, not all ffmpeg supported formats will be supported directly.
2016-11-06 16:55:37 +01:00
The following formats/codecs should generally work: MP4, MOV, WebM, MKV, OGG, WAV, MP3, AAC, H264, Theora, VP8, VP9
For more information about supported formats / codecs, see https://www.chromium.org/audio-video.
2018-05-22 23:32:54 +02:00
2019-01-28 12:49:26 +01:00
Unsupported files can now be remuxed (fast) or encoded (slow) to a friendly format/codec from the `File` menu. A processed version of the file will then be opened in the player. The cut operation will still be performed using the original file as input, so it will be lossless. This allows for potentially opening any file that ffmpeg is able to decode.
2018-05-22 23:32:54 +02:00
2016-11-06 16:55:37 +01:00
2018-02-18 16:25:38 +01:00
## Typical workflow
2016-10-31 16:40:35 +01:00
- Drag drop a video file into player to load or use <kbd></kbd>/<kbd>CTRL</kbd>+<kbd>O</kbd>.
2019-01-31 20:27:05 +01:00
- Press <kbd>SPACE</kbd> to play/pause or <kbd></kbd><kbd></kbd>, <kbd>,</kbd><kbd>.</kbd> to seek back/forth
- Select the cut start and end time. Press <kbd>I</kbd> to select the start time, <kbd>O</kbd> to select the end time for the cut.
2019-01-31 20:24:09 +01:00
- If you want to cut more segments out of the video, press <kbd>+</kbd> or the `c+` button to add another segment, then select the next segment with <kbd>I</kbd>/<kbd>O</kbd>.
- If you want to re-merge all the selected segments after cutting, toggle the button `nm` (no merge) to `am` (auto merge). This is useful for *cutting away* certain parts of a video (by selecting everything except the parts not needed.)
- If you want to export to a certain dir, press the custom output dir button (default: input file dir)
- If you want to override orientation metadata, press the rotation button
2018-09-25 00:43:42 +02:00
- Press the scissors button (or <kbd>E</kbd>) to export the slice
- Press the camera button (or <kbd>C</kbd>) to take a snapshot
2019-01-31 20:24:09 +01:00
- If you want to move the original file to trash, press the trash button
2016-10-31 16:40:35 +01:00
2019-01-31 20:24:09 +01:00
Note: The original video files will not be modified. Instead it creates a lossless export in the same directory as the original file with from/to timestamps. Note that the cut is currently not precise around the cutpoints, so video before/after the nearest keyframe will be lost. EXIF data is preserved.
2016-10-30 11:57:12 +01:00
2018-02-18 16:25:38 +01:00
## Keyboard shortcuts
2017-01-28 22:25:27 +01:00
Press <kbd>h</kbd> To show/hide list of shortcuts
2016-10-30 11:57:12 +01:00
2019-03-03 16:28:59 +01:00
## Known issues & limitations
2019-05-06 20:22:52 +02:00
- **Cutting times are not accurate and will be "rounded" to the nearest keyframe.** In the future I plan on showing keyframes in the timecale, and eventually implement a "smart cut" feature that re-encodes the part before the keyframe. See #126
2019-03-03 16:20:06 +01:00
- H265 is not yet supported natively. You need to convert to friendly codec from the menu, see #88
2019-05-06 20:15:18 +02:00
- If you have trouble cutting, try toggling the button `kc` *(kc cut)* to `nc` *(normal cut)*. Also try to toggle `all` (all streams) to `ps` (primary streams). See discussion in [#13](https://github.com/mifi/lossless-cut/pull/13). GoPro 6/7 seems to require `nc`. `all` (all streams) seems to cause wrong length in GoPro footage (see [#146](https://github.com/mifi/lossless-cut/issues/146) [#121](https://github.com/mifi/lossless-cut/issues/121))
2017-01-30 13:24:05 +01:00
- If you get an error when cutting any kind of file under Windows, please check your anti-virus. It might be blocking execution of ffmpeg, see [#18](https://github.com/mifi/lossless-cut/issues/18)
2017-01-30 09:25:02 +01:00
2016-10-30 11:57:12 +01:00
## Development building / running
2019-01-28 12:49:26 +01:00
This app is built using Electron. Make sure you have at least node v8 and yarn installed. The app uses ffmpeg from PATH when developing.
2016-10-30 11:57:12 +01:00
```
git clone https://github.com/mifi/lossless-cut.git
cd lossless-cut
2018-05-22 23:32:54 +02:00
npm install
2016-10-30 11:57:12 +01:00
```
### Running
In one terminal:
```
npm run watch
```
2018-05-22 23:32:54 +02:00
In another:
2016-10-30 11:57:12 +01:00
```
npm start
```
2018-09-30 20:56:38 +02:00
## Donate 🙈
2019-01-31 19:54:11 +01:00
This project is maintained by me alone. The project will always remain free and open source, but if it's useful for you, consider supporting me. :) It will give me extra motivation to improve it. Or even better [donate to ffmpeg](https://www.ffmpeg.org/donations.html) because they are doing the world a big favor 🙏
2018-09-30 20:56:38 +02:00
- Paypal: [https://paypal.me/mifino](https://paypal.me/mifino)
- Bitcoin: 1ApBmaN98YtSzTuYofEoSRnYBUycPr5qtC
## Credits
- App icon made by [Dimi Kazak](http://www.flaticon.com/authors/dimi-kazak "Dimi Kazak") from [www.flaticon.com](http://www.flaticon.com "Flaticon") is licensed by [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0/ "Creative Commons BY 3.0")