lossless-cut/README.md

# LosslessCut 🎥 [![Travis](https://img.shields.io/travis/mifi/lossless-cut.svg)]()
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. It doesn't do any decoding / encoding and is therefore extremely fast and has no quality loss. Also allows for taking JPEG snapshots of the video at the selected time. This app uses the awesome ffmpeg🙏 for doing the grunt work. ffmpeg is not included and must be installed separately.

![Demo](demo.gif)

## Download


## Installing / running

- Install [ffmpeg](https://www.ffmpeg.org/download.html)
- Download [latest LosslessCut from releases](https://github.com/mifi/lossless-cut/releases)
- Run app
- If ffmpeg is available in <b>$PATH</b>/<b>%PATH%</b> it will just work  
- If not, a dialog will pop up to select ffmpeg executable path.

## Documentation

- Drag drop a video file into player to load or use <kbd>⌘</kbd>/<kbd>CTRL</kbd>+<kbd>O</kbd>.
- Select the start and end time
- Press the scissors button to export a slice.
- Press the camera button to take a snapshot.

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.

### Keyboard shortcuts
- <kbd>SPACE</kbd> Play/pause
- <kbd>←</kbd> Seek backward 1 sec
- <kbd>→</kbd> Seek forward 1 sec
- <kbd>.</kbd> (period) Tiny seek forward
- <kbd>,</kbd> (comma) Tiny seek backward
- <kbd>c</kbd> Capture snapshot (in the same dir as the video)

## Development building / running

This app is made using Electron. [electron-compile](https://github.com/electron/electron-compile) is used for development. Make sure you have at least node v4 with npm 3.
```
git clone https://github.com/mifi/lossless-cut.git
cd lossless-cut
npm install
```

### Running
```
npm start
```

### Building package
```
npm run build
npm run package
```

## TODO
- more hotkeys
- ffprobe show keyframes?
- ffprobe format
- About menu
- improve ffmpeg error handling
- timeline scrub support

## Links
- http://apple.stackexchange.com/questions/117306/what-options-are-available-to-losslessly-trim-mp4-m4v-video-on-10-8-or-above
- https://www.google.no/webhp?sourceid=chrome-instant&ion=1&espv=2&ie=UTF-8#q=lossless%20cut%20video
- https://github.com/electron/electron/blob/master/docs/api/file-object.md
- https://github.com/electron/electron/issues/2538
Update README.md 2016-10-31 16:40:35 +01:00			`# LosslessCut 🎥 [![Travis](https://img.shields.io/travis/mifi/lossless-cut.svg)]()`
			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. It doesn't do any decoding / encoding and is therefore extremely fast and has no quality loss. Also allows for taking JPEG snapshots of the video at the selected time. This app uses the awesome ffmpeg🙏 for doing the grunt work. ffmpeg is not included and must be installed separately.
initial 2016-10-30 11:57:12 +01:00
Update README.md 2016-10-30 15:27:13 +01:00			`![Demo](demo.gif)`

initial 2016-10-30 11:57:12 +01:00			`## Download`


			`## Installing / running`

			`- Install [ffmpeg](https://www.ffmpeg.org/download.html)`
			`- Download [latest LosslessCut from releases](https://github.com/mifi/lossless-cut/releases)`
			`- Run app`
			`- If ffmpeg is available in <b>$PATH</b>/<b>%PATH%</b> it will just work`
			`- If not, a dialog will pop up to select ffmpeg executable path.`

			`## Documentation`

Update README.md 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>.`
			`- Select the start and end time`
			`- Press the scissors button to export a slice.`
			`- Press the camera button to take a snapshot.`

			`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.`
initial 2016-10-30 11:57:12 +01:00
			`### Keyboard shortcuts`
			`- <kbd>SPACE</kbd> Play/pause`
			`- <kbd>←</kbd> Seek backward 1 sec`
			`- <kbd>→</kbd> Seek forward 1 sec`
			`- <kbd>.</kbd> (period) Tiny seek forward`
			`- <kbd>,</kbd> (comma) Tiny seek backward`
			`- <kbd>c</kbd> Capture snapshot (in the same dir as the video)`

			`## Development building / running`

Update README.md 2016-10-31 16:40:35 +01:00			`This app is made using Electron. [electron-compile](https://github.com/electron/electron-compile) is used for development. Make sure you have at least node v4 with npm 3.`
initial 2016-10-30 11:57:12 +01:00			```
			`git clone https://github.com/mifi/lossless-cut.git`
			`cd lossless-cut`
			`npm install`
			```

			`### Running`
			```
			`npm start`
			```

			`### Building package`
			```
			`npm run build`
			`npm run package`
			```

			`## TODO`
			`- more hotkeys`
			`- ffprobe show keyframes?`
			`- ffprobe format`
			`- About menu`
			`- improve ffmpeg error handling`
			`- timeline scrub support`

			`## Links`
			`- http://apple.stackexchange.com/questions/117306/what-options-are-available-to-losslessly-trim-mp4-m4v-video-on-10-8-or-above`
			`- https://www.google.no/webhp?sourceid=chrome-instant&ion=1&espv=2&ie=UTF-8#q=lossless%20cut%20video`
			`- https://github.com/electron/electron/blob/master/docs/api/file-object.md`
			`- https://github.com/electron/electron/issues/2538`