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

85 lines
3.4 KiB
Markdown
Raw Normal View History

2016-10-31 16:40:35 +01:00
# LosslessCut 🎥 [![Travis](https://img.shields.io/travis/mifi/lossless-cut.svg)]()
2016-10-30 11:57:12 +01:00
2016-11-06 16:55:37 +01:00
Simple, cross platform video editor for lossless trimming / cutting of videos. Great for rough processing of large video files taken from a video camera, GoPro, drone, etc. Lets you quickly extract the good parts from your videos and discard GB of data without losing quality. It doesn't do any decoding / encoding and is therefore extremely fast. Also allows for taking JPEG snapshots of the video at the selected time. This app uses the awesome ffmpeg🙏 for doing the grunt work. Also supports lossless cutting in the most common audio formats.
2016-10-30 11:57:12 +01:00
<b>ffmpeg is now included in the app! 🎉</b>
2016-11-05 21:33:39 +01:00
![Demo](https://thumbs.gfycat.com/HighAcclaimedAnaconda-size_restricted.gif)
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
2016-11-15 16:20:10 +01:00
- On OSX, to open LosslessCut.app, Right Click > Open to bypass the security warning.
2016-10-30 11:57:12 +01:00
## Documentation
2016-11-05 21:43:03 +01:00
### Supported platforms
- Mac OS X
- Windows (64/32bit)
- Linux (64/32bit, not tested)
2016-11-06 16:55:37 +01:00
### Supported formats
Since LosslessCut is based on Chromium and uses the HTML5 video player, not all ffmpeg supported formats will be supported.
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.
### Typical flow
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>.
- Press <kbd>SPACE</kbd> to play/pause
- Select the cut start and end time
- Press the scissors button to export the slice
- Press the camera button to take a snapshot
2016-10-31 16:40:35 +01:00
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
### 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
2017-01-28 23:28:45 +01:00
For old shortcuts see here:
https://github.com/mifi/lossless-cut/blob/41d6991c11b0a82b08344fd22a1ea094af217417/README.md#keyboard-shortcuts
2017-01-30 09:25:02 +01:00
### Known issues
2017-01-30 13:24:05 +01:00
- Output videos will have an empty portion in the beginning, see discussion in [#13](https://github.com/mifi/lossless-cut/pull/13)
- 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
This app is built using Electron. Make sure you have at least node v4 with npm 3. 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
npm install
```
### Running
In one terminal:
```
npm run watch
```
Then:
2016-10-30 11:57:12 +01:00
```
npm start
```
2017-02-11 14:46:06 +01:00
### Release new version
2016-10-30 11:57:12 +01:00
```
2017-02-11 14:46:06 +01:00
# Commit changes
# Wait for Travis
npm version ...
# Update CHANGELOG.md
2017-02-11 14:56:35 +01:00
# Commit CHANGELOG.md
# Push
npm run download-ffmpeg
npm run extract-ffmpeg
2016-10-30 11:57:12 +01:00
npm run build
npm run icon-gen
2017-02-11 14:46:06 +01:00
npm run package
npm run release
2016-10-30 11:57:12 +01: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")