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>, <kbd>k</kbd> Play/pause
- <kbd>j</kbd> Slow down video
- <kbd>l</kbd> Speed up video
- <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>i</kbd> Mark in / cut start point
- <kbd>o</kbd> Mark out / cut end point
- <kbd>e</kbd> Export selection (in the same dir as the video)
- <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 / ideas
- About menu
- icon
- Visual feedback on button presses
- ffprobe show keyframes
- ffprobe format
- improve ffmpeg error handling
- Slow scrub with modifier key
- show frame number
- Bundle ffmpeg
- support for loading other formats by streaming through ffmpeg?
- cutting out the commercials in a video file while saving the rest to a single file?

## Links
- http://apple.stackexchange.com/questions/117306/what-options-are-available-to-losslessly-trim-mp4-m4v-video-on-10-8-or-above
- http://superuser.com/questions/554620/how-to-get-time-stamp-of-closest-keyframe-before-a-given-timestamp-with-ffmpeg/554679#554679
- http://www.fame-ring.com/smart_cutter.html
- http://electron.atom.io/apps/
- 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 15:40:35 +00: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 10:57:12 +00:00
Update README.md 2016-10-30 14:27:13 +00:00			`![Demo](demo.gif)`

initial 2016-10-30 10:57:12 +00: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 15:40:35 +00: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 10:57:12 +00:00
			`### Keyboard shortcuts`
Implement partial speed control J, K, L, however backward playing is not supported by chromium. Also bump electron to 1.4.5 And don't use electron-compile anymore as it doesn't really give us anything 2016-11-03 19:16:27 +00:00			`- <kbd>SPACE</kbd>, <kbd>k</kbd> Play/pause`
			`- <kbd>j</kbd> Slow down video`
			`- <kbd>l</kbd> Speed up video`
initial 2016-10-30 10:57:12 +00:00			`- <kbd>←</kbd> Seek backward 1 sec`
			`- <kbd>→</kbd> Seek forward 1 sec`
			`- <kbd>.</kbd> (period) Tiny seek forward`
			`- <kbd>,</kbd> (comma) Tiny seek backward`
Add new features Add more hotkeys More buttons Show in/out point timestamps and click to jump to these Scrubbing Show error for unsupported files 2016-10-31 22:24:04 +00:00			`- <kbd>i</kbd> Mark in / cut start point`
			`- <kbd>o</kbd> Mark out / cut end point`
			`- <kbd>e</kbd> Export selection (in the same dir as the video)`
initial 2016-10-30 10:57:12 +00:00			`- <kbd>c</kbd> Capture snapshot (in the same dir as the video)`

			`## Development building / running`

Update README.md 2016-10-31 15:40:35 +00: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 10:57:12 +00: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`
			```

Add new features Add more hotkeys More buttons Show in/out point timestamps and click to jump to these Scrubbing Show error for unsupported files 2016-10-31 22:24:04 +00:00			`## TODO / ideas`
initial 2016-10-30 10:57:12 +00:00			`- About menu`
Add new features Add more hotkeys More buttons Show in/out point timestamps and click to jump to these Scrubbing Show error for unsupported files 2016-10-31 22:24:04 +00:00			`- icon`
			`- Visual feedback on button presses`
			`- ffprobe show keyframes`
			`- ffprobe format`
initial 2016-10-30 10:57:12 +00:00			`- improve ffmpeg error handling`
Add new features Add more hotkeys More buttons Show in/out point timestamps and click to jump to these Scrubbing Show error for unsupported files 2016-10-31 22:24:04 +00:00			`- Slow scrub with modifier key`
			`- show frame number`
			`- Bundle ffmpeg`
			`- support for loading other formats by streaming through ffmpeg?`
			`- cutting out the commercials in a video file while saving the rest to a single file?`
initial 2016-10-30 10:57:12 +00:00
			`## Links`
			`- http://apple.stackexchange.com/questions/117306/what-options-are-available-to-losslessly-trim-mp4-m4v-video-on-10-8-or-above`
Add new features Add more hotkeys More buttons Show in/out point timestamps and click to jump to these Scrubbing Show error for unsupported files 2016-10-31 22:24:04 +00:00			`- http://superuser.com/questions/554620/how-to-get-time-stamp-of-closest-keyframe-before-a-given-timestamp-with-ffmpeg/554679#554679`
			`- http://www.fame-ring.com/smart_cutter.html`
			`- http://electron.atom.io/apps/`
initial 2016-10-30 10:57:12 +00:00			`- https://github.com/electron/electron/blob/master/docs/api/file-object.md`
			`- https://github.com/electron/electron/issues/2538`