You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
lossless-cut/README.md

92 lines
6.5 KiB
Markdown

8 years ago
# 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)
10 years ago
7 years ago
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 is fueled by the awesome ffmpeg (included) for doing the grunt work. It also features some other lossless operations on videos.
8 years ago
![Demo](https://github.com/mifi/gifs/raw/master/2019-01-28-lossless-cut.gif)
10 years ago
9 years ago
## Features
- Lossless cutting of common video and audio formats
8 years ago
- Lossless re-merge of selected segments (for cutting out commercials etc.)
8 years ago
- Lossless merge of arbitrary files (with identical codecs)
7 years ago
- Lossless extracting of all data streams from a file (explode video, audio, subtitle and other streams of a file into separate files)
9 years ago
- Take full-resolution snapshots from videos in JPEG/PNG format
8 years ago
- Manual input range of cutpoints
7 years ago
- Can include primary streams (audio/video), or all streams
- Can remove audio track
8 years ago
- Apply a timecode offset
7 years ago
- Remux into different output format
8 years ago
- Change rotation/orientation metadata in videos. Great for rotating phone videos that come out the wrong way without actually re-encoding the video.
9 years ago
10 years ago
## Installing / running
- Download [latest LosslessCut from releases](https://github.com/mifi/lossless-cut/releases)
- Run LosslessCut app/exe
- On macOS, to open LosslessCut.app, Right Click > Open to bypass the security warning.
10 years ago
9 years ago
## Supported platforms
- macOS
10 years ago
- Windows (64/32bit)
7 years ago
- Linux (64, partially tested)
10 years ago
9 years ago
## Supported formats
10 years ago
8 years ago
Since LosslessCut is based on Chromium and uses the HTML5 video player, not all ffmpeg supported formats will be supported directly.
10 years ago
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.
8 years ago
7 years ago
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 (without audio) will then be created and 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.
8 years ago
10 years ago
9 years ago
## Typical workflow
10 years ago
- Drag drop a video file into player to load or use <kbd></kbd>/<kbd>CTRL</kbd>+<kbd>O</kbd>.
8 years ago
- 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.
7 years ago
- *(optional)* 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>.
- *(optional)* 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.)
- *(optional)* If you want to export to a certain dir, press the custom output dir button (default: input file dir)
- *(optional)* If you want to override orientation metadata, press the rotation button
- *(optional)* By default, all streams from input file will be exported to output. If you like to only export primary streams (1video&1audio) (pre-2.0 behaviour), toggle the button `all` to `ps`.
7 years ago
- Press the scissors button (or <kbd>E</kbd>) to export the slice(s)
- Press the camera button (or <kbd>C</kbd>) to take a JPEG/PNG snapshot from the current time
8 years ago
- If you want to move the original file to trash, press the trash button
10 years ago
8 years ago
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.
10 years ago
9 years ago
## Keyboard shortcuts
Press <kbd>h</kbd> To show/hide list of shortcuts
10 years ago
7 years ago
## Known issues & limitations
7 years ago
- **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
7 years ago
- **If you have an error when running the cut:** Try toggling the button `all` (all streams) to `ps` (primary streams). If that doesn't help, try to toggle `kc` *(keyframe cut)* to `nc` *(normal cut)*. 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))
7 years ago
- H265 is not yet supported natively. You need to convert to friendly codec from the menu, see [#88](https://github.com/mifi/lossless-cut/issues/88)
10 years ago
- 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)
10 years ago
10 years ago
## Development building / running
8 years ago
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.
10 years ago
```
git clone https://github.com/mifi/lossless-cut.git
cd lossless-cut
8 years ago
npm install
10 years ago
```
### Running
In one terminal:
```
npm run watch
```
8 years ago
In another:
10 years ago
```
npm start
```
8 years ago
## Donate 🙈
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 🙏
8 years ago
- 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")