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

107 lines
8.2 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
2019-08-12 23:57:42 +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 is fueled by the awesome ffmpeg (included) for doing the grunt work. It also features some other lossless operations on videos.
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
2020-02-10 09:57:04 +01:00
**Shameless Plugs**
2020-02-10 12:14:37 +01:00
🆕I made an easy to use Instagram bot with a GUI: [SimpleInstaBot](https://github.com/mifi/SimpleInstaBot/)
2020-02-10 09:57:04 +01:00
I made a tool for cross platform sharing of files between computer/phone over the local network: [ezshare](https://github.com/mifi/ezshare)
2019-08-16 19:36:23 +02: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)
2019-08-12 23:57:42 +02:00
- Lossless extracting of all data streams from a file (explode video, audio, subtitle and other streams of a file into separate files)
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
2019-08-12 23:57:42 +02:00
- Can include primary streams (audio/video), or all streams
- Can remove audio track
2019-01-29 00:09:55 +01:00
- Apply a timecode offset
2019-08-12 23:57:42 +02:00
- Remux into different output format
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
2020-02-10 09:57:04 +01:00
## Download
2016-10-30 11:57:12 +01:00
2020-02-10 09:57:04 +01:00
- [Mac OS X](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-mac.dmg)
- [Windows](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-win.exe)
- [Linux AppImage](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux.AppImage)
- [Linux snap](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux.snap)
- [Linux tar.bz2](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux.tar.bz2)
2016-10-30 11:57:12 +01:00
2020-02-10 09:57:04 +01:00
NOTE: After installing you may need to right click the application icon and then "Open" in order to bypass "Untrusted app" dialogs. This is because Microsoft requires a $300/year certificate just to remove this block (I'm not going to pay for that.) Alternatively try to google `windows how to run untrusted app`.
2016-11-05 21:43:03 +01:00
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-08-12 23:57:42 +02: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 (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.
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
2019-08-27 23:02:38 +02:00
- 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. *Note that the portions you select will be PRESERVED and exported to a new file.*
- *(optional)* If you want to export 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 like advertisements (by selecting everything *except* the advertisements.)
2019-08-12 23:57:42 +02:00
- *(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`.
2019-08-12 23:36:31 +02:00
- 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
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-08-18 13:43:23 +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 only the part before the keyframe. See [#126](https://github.com/mifi/lossless-cut/issues/126)
2019-08-18 13:42:38 +02:00
- Your mileage may vary when it comes to `kc` *(keyframe cut)* vs `nc` *(normal cut)*. You may need to try both, depending on the video. GoPro 6/7 seems to require Normal Cut `nc`. See [#121](https://github.com/mifi/lossless-cut/issues/121). [ffmpeg](https://trac.ffmpeg.org/wiki/Seeking) also has documentation about these two seek/cut modes. `kc` means `-ss` *before* `-i` and `nc` means `-ss` *after* `-i`.
2019-08-18 13:44:53 +02:00
- `all` *(all streams)* seems to cause wrong length in GoPro footage. Use `ps` instead. See [#146](https://github.com/mifi/lossless-cut/issues/146) and [121](https://github.com/mifi/lossless-cut/issues/121#issuecomment-522196244)
2019-11-04 13:11:52 +01:00
- H265 is not yet supported natively. I have added a crude support with very low FPS preview. Alternatively convert to friendly codec (slow) from the menu, see [#88](https://github.com/mifi/lossless-cut/issues/88)
2019-08-27 23:02:38 +02:00
- Maybe counter-intuitively for some, cutting will remove the parts that of the video that are NOT selected. This is because in previous versions of LosslessCut there was no possibility to cut/merge multiple segments, but this was retrofitted later. Need to redesign the UI to make it more intuitive. See [#128](https://github.com/mifi/lossless-cut/issues/128)
2019-08-18 13:42:38 +02:00
## Troubleshooting
- **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).
- If you get an error when cutting or opening 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
2020-02-11 18:09:31 +01:00
[Paypal](https://paypal.me/mifino)
2018-09-30 20:56:38 +02:00
## 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")
2019-10-04 12:38:07 +02:00
---
Made with ❤️ in 🇳🇴