lossless-cut/README.md

86 wiersze
3.7 KiB
Markdown
Czysty Zwykły widok Historia

2016-10-31 15:40:35 +00:00
# LosslessCut 🎥 [![Travis](https://img.shields.io/travis/mifi/lossless-cut.svg)]()
2016-10-30 10:57:12 +00:00
2017-10-08 21:40:44 +00:00
Simple, cross platform tool for lossless trimming / cutting of video and audio files. Great for rough processing of large video files taken from a video camera, GoPro, drone, etc. It lets you quickly extract the good parts from your videos and discard GBs 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. ffmpeg is included in the app.
2016-10-30 10:57:12 +00:00
2018-01-07 14:28:00 +00:00
2016-11-05 20:33:39 +00:00
![Demo](https://thumbs.gfycat.com/HighAcclaimedAnaconda-size_restricted.gif)
2016-10-30 10:57:12 +00:00
## Installing / running
- Download [latest LosslessCut from releases](https://github.com/mifi/lossless-cut/releases)
- Run LosslessCut app/exe
2016-11-15 15:20:10 +00:00
- On OSX, to open LosslessCut.app, Right Click > Open to bypass the security warning.
2016-10-30 10:57:12 +00:00
## Documentation
2016-11-05 20:43:03 +00:00
### Supported platforms
- Mac OS X
- Windows (64/32bit)
- Linux (64/32bit, not tested)
2016-11-06 15:55:37 +00: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.
2017-03-19 20:03:40 +00:00
### Typical workflow
2016-10-31 15:40:35 +00: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 <kbd>I</kbd> to select the start time, <kbd>O</kbd> to select the end time for the cut.
- Press the rotation button if you want to set rotation metadata
- Press the scissors button to export the slice
- Press the camera button to take a snapshot
2016-10-31 15:40:35 +00: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 10:57:12 +00:00
### Keyboard shortcuts
2017-01-28 21:25:27 +00:00
Press <kbd>h</kbd> To show/hide list of shortcuts
2016-10-30 10:57:12 +00:00
2017-01-28 22:28:45 +00:00
For old shortcuts see here:
https://github.com/mifi/lossless-cut/blob/41d6991c11b0a82b08344fd22a1ea094af217417/README.md#keyboard-shortcuts
2017-01-30 08:25:02 +00:00
### Known issues
2018-02-11 12:44:34 +00:00
- Some output videos will have an empty portion in the beginning (you might lose a few seconds after your in-cutpoint). A tip is to set the cutpoint a few extra seconds before the part you want to keep, that way you will not lose anything. See discussion in [#13](https://github.com/mifi/lossless-cut/pull/13)
2017-01-30 12:24:05 +00: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 08:25:02 +00:00
2016-10-30 10:57:12 +00:00
## Development building / running
This app is built using Electron. Make sure you have at least node v6 and yarn installed. The app uses ffmpeg from PATH when developing.
2016-10-30 10:57:12 +00:00
```
git clone https://github.com/mifi/lossless-cut.git
cd lossless-cut
yarn
2016-10-30 10:57:12 +00:00
```
### Running
In one terminal:
```
npm run watch
```
Then:
2016-10-30 10:57:12 +00:00
```
npm start
```
2017-02-11 13:46:06 +00:00
### Release new version
2016-10-30 10:57:12 +00:00
```
2017-02-11 13:46:06 +00:00
# Commit changes
# Wait for Travis
npm version ...
# Update CHANGELOG.md
2017-02-11 13:56:35 +00:00
# Commit CHANGELOG.md
# Push
npm run download-ffmpeg
npm run extract-ffmpeg
2016-10-30 10:57:12 +00:00
npm run build
npm run icon-gen
2017-02-11 13:46:06 +00:00
npm run package
npm run release
2016-10-30 10:57:12 +00: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")