1
0
mirror of https://github.com/mifi/lossless-cut.git synced 2024-11-25 03:33:14 +01:00
lossless-cut/README.md

262 lines
19 KiB
Markdown
Raw Normal View History

2021-01-26 21:52:42 +01:00
<div align="center">
<br>
<br>
<p><a href="https://mifi.no/losslesscut/"><img src="src/icon.svg" width="130" alt="LosslessCut" /></a></p>
<p><b>LosslessCut</b></p>
The swiss army knife of lossless video/audio editing
<br>
2021-02-09 12:07:05 +01:00
<img src="https://github.com/mifi/lossless-cut/workflows/Build/release/badge.svg" />
2022-06-14 02:12:01 +02:00
<a href="https://paypal.me/mifino/usd"><img src="https://img.shields.io/badge/Donate-PayPal-green.svg" /></a> <a href="https://github.com/mifi/lossless-cut#download"><img src="https://img.shields.io/github/v/release/mifi/lossless-cut" /></a> <a href="https://discord.gg/fhnEREfUJ3"><img src="https://img.shields.io/discord/986051448385183804" /></a>
2021-01-26 21:52:42 +01:00
<br>
<br>
2022-06-30 03:23:25 +02:00
<a href="https://mifi.no/thanks/">Thanks to my supporters</a> and everyone who purchased LosslessCut!
2021-02-09 12:07:05 +01:00
<br>
2021-01-26 21:52:42 +01:00
<br>
<p align="center"><img src="https://github.com/mifi/lossless-cut/raw/master/main_screenshot.jpg" width="600" alt="screenshot" /></p>
<br>
<br>
</div>
2016-10-30 11:57:12 +01:00
2020-02-19 07:51:34 +01:00
LosslessCut aims to be the ultimate cross platform FFmpeg GUI for extremely fast and lossless operations on video, audio, subtitle and other related media files.
The main feature is lossless trimming and cutting of video and audio files, which is 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. Or you can add a music or subtitle track to your video without needing to encode. Everything is extremely fast because it does an almost direct data copy, fueled by the awesome FFmpeg which does all the grunt work.
2018-02-18 16:25:38 +01:00
## Features
2020-02-19 07:51:34 +01:00
- Lossless cutting of most video and audio formats
- [Smart cut](https://github.com/mifi/lossless-cut/issues/126) (experimental)
2020-02-19 07:51:34 +01:00
- Losslessly cut out parts of video/audio (for cutting away commercials etc.)
- Losslessly rearrange the order of video/audio segments
- Lossless merge/concatenation of arbitrary files (with identical codecs parameters, e.g. from the same camera)
2022-02-14 05:01:37 +01:00
- Lossless stream editing
- Combine arbitrary tracks from multiple files (ex. add music or subtitle track to a video file)
- Remove unneeded tracks
- Replace or re-encode only some tracks
- Extract all tracks from a file (extract video, audio, subtitle, attachments and other tracks from one file into separate files)
2021-08-28 16:47:43 +02:00
- Batch view for fast multi-file workflow
2022-02-14 05:01:37 +01:00
- Keyboard shortcut workflow
2022-06-30 03:22:20 +02:00
- Losslessly remux video/audio into a different container (file) format
- Take full-resolution snapshots from videos in JPEG/PNG format, or export ranges of video frames to images
2020-03-26 15:53:41 +01:00
- Manual input of cutpoint times
2020-11-27 23:23:36 +01:00
- Apply a per-file timecode offset (and auto load timecode from file)
2022-02-14 05:01:37 +01:00
- Edit file metadata, per-track metadata and per-track disposition
2020-02-19 07:51:34 +01:00
- Change rotation/orientation metadata in videos
2022-02-14 05:01:37 +01:00
- View technical data about all tracks
- Timeline zoom and frame/keyframe jumping for cutting around keyframes
- Video thumbnails and audio waveform
2020-02-23 11:21:31 +01:00
- Saves per project cut segments to project file
- View FFmpeg last command log so you can modify and re-run recent commands on the command line
2020-02-23 11:21:31 +01:00
- Undo/redo
- Give labels to cut segments
- Annotate segments with tags
2022-02-14 05:01:37 +01:00
- Import/export segments: MP4/MKV chapter marks, Text file, YouTube, CSV, CUE, XML (DaVinci, Final Cut Pro) and more
- MKV/MP4 embedded chapters marks editor
- View subtitles
- Customizable keyboard hotkeys
- Black scene detection
2022-05-24 07:31:48 +02:00
- Divide timeline into segments with length L or into N segments or even randomized segments!
2020-02-19 07:51:34 +01:00
## Example lossless use cases
2021-01-26 21:52:42 +01:00
- Cut out commercials from a recorded TV show (and re-format from TS to MP4)
2020-11-21 15:01:37 +01:00
- Remove audio tracks from a file
- Extract music track from a video and cut it to your needs
- Add music to a video (or replace existing audio track)
- Combine audio and video tracks from separate recordings
2021-01-26 21:52:42 +01:00
- Include an external subtitle into a video
- Quickly change a H264/H265 MKV video to MOV or MP4 for playback on iPhone
2020-11-21 15:01:37 +01:00
- Import a list of cut times from other tool as a EDL (edit decision list, CSV) and run these cuts with LosslessCut
2021-01-26 21:52:42 +01:00
- Export a list of cut times as a CSV EDL and process these in another tool
- Quickly cut a file by its MP4/MKV chapters
2021-01-27 15:11:06 +01:00
- Quickly cut a [YouTube video](https://youtube-dl.org/) by its chapters (or music times from a comment)
2020-12-10 17:35:00 +01:00
- Change the language of a file's audio/subtitle tracks
- Attach cover art / thumbnail to videos / audio from an external JPEG file or from a frame on the timeline
2020-12-10 17:35:00 +01:00
- Change author, title, GPS position, recording time of a video
2020-11-21 15:01:37 +01:00
- Fix rotation of a video that has the wrong orientation flag set
- Great for rotating phone videos that come out the wrong way without actually re-encoding the video.
- Loop a video / audio clip X times quickly without re-encoding
- See [#284](https://github.com/mifi/lossless-cut/issues/284)
- Convert a video or parts of it into X image files (not lossless)
2020-02-19 07:51:34 +01:00
2021-02-19 13:51:21 +01:00
### Export cut times as YouTube Chapters
1. Export with Merge and "Create chapters from merged segments" enabled
2. Open the exported file and select "Import chapters" in the dialog
3. File -> Export project -> YouTube Chapters
2022-02-14 05:01:37 +01:00
### Re-encode only the audio track, keeping the lossless video track
2020-10-20 13:16:42 +02:00
First export each track as individual files. Then use Handbrake or similar to re-encode the audio file (if mp4 file, encode as AAC.) Then open the extracted video stream in LosslessCut. The open your encoded audio file and select "Include all tracks from the new file". Then export.
2020-10-20 13:16:42 +02:00
2020-02-19 07:51:34 +01:00
### Advanced multi-step workflows
**Tip:** you can use LosslessCut in multiple passes in order to achieve separate trimming of individual tracks:
2021-01-26 21:52:42 +01:00
1. Open a file an export all tracks as individual files
2020-02-19 07:51:34 +01:00
2. Open the exported track files independently and cut them as desired
3. Add the track back to the video and combine them to one output video
2020-02-10 09:57:04 +01:00
## Download
2016-10-30 11:57:12 +01:00
2020-11-21 15:01:37 +01:00
If you want to support my continued work on LosslessCut, and you want the advantage of a secure and simple installation process with automatic updates, consider getting it from your favorite store:
2020-04-01 12:17:38 +02:00
2020-04-01 12:25:07 +02:00
<a href="https://apps.apple.com/app/id1505323402"><img src="mac-app-store-badge.svg" alt="Mac App Store" height="50"/></a> <a href="https://www.microsoft.com/store/apps/9P30LSR4705L?cid=storebadge&ocid=badge"><img src="ms-store-badge.svg" alt="MS badge" height="50"/></a> <a href="https://snapcraft.io/losslesscut"><img src="https://snapcraft.io/static/images/badges/en/snap-store-black.svg" alt="Snapcraft" height="50"/></a>
2020-04-01 12:17:38 +02:00
If you prefer to download the executables manually, this will of course always be free:
2022-03-10 07:00:45 +01:00
- Mac OS X: [DMG](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-mac-x64.dmg)
2022-07-25 11:12:55 +02:00
- Windows: [7zip](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-win-x64.7z) (APPX not available)
2022-07-21 04:24:12 +02:00
- Linux: [x64 tar.bz2](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux-x64.tar.bz2) / [x64 AppImage](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux-x86_64.AppImage) / [arm64 tar.bz2](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux-arm64.tar.bz2) / [Raspberry Pi armv7l](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-linux-armv7l.tar.bz2)
2020-04-01 12:17:38 +02:00
- [More releases](https://github.com/mifi/lossless-cut/releases)
2016-10-30 11:57:12 +01:00
2020-04-01 12:17:38 +02:00
If you find LosslessCut useful, I'm very thankful for [donations](https://github.com/mifi/lossless-cut#donate-).
2016-11-05 21:43:03 +01:00
2020-11-21 15:01:37 +01:00
### Difference between App Stores and Github download
2022-03-13 06:07:46 +01:00
They have exactly the same in-app features, except for a few platform limitations. Apple doesn't allow opening VOB files with App Store apps. Apple App Store apps need to prompt for output directory. LosslessCut version in the App Stores is a few versions behind the GitHub version, because I want to be sure that the new versions work perfectly before releasing in the App Stores. GitHub version can contain new, untested features and may contain some bugs. I consider the newest GitHub versions to be a public "beta" test.
2020-11-21 15:01:37 +01:00
2018-02-18 16:25:38 +01:00
## Supported formats
2016-11-06 16:55:37 +01:00
Since LosslessCut is based on Chromium and uses the HTML5 video player, not all FFmpeg supported formats will be supported smoothly.
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
2022-03-13 06:07:46 +01:00
Unsupported files can still be converted to a supported format/codec from the `File` menu. (Try the "fastest" option first.) A low quality version of the file (with/without audio) will then be created and opened in the player. The actual cut/export operation will still be performed on the original file, 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
2021-11-15 07:35:17 +01:00
## Video demos
2020-04-21 19:46:47 +02:00
2021-11-15 07:35:17 +01:00
- [Common features](https://www.youtube.com/watch?v=pYHMxXy05Jg)
2022-08-12 21:11:22 +02:00
- [How to add a thumbnail / cover art to an MP4](https://www.youtube.com/watch?v=4pYJ93cn80E)
2021-11-15 07:35:17 +01:00
- [How to add multi-language audio to a video](https://www.youtube.com/watch?v=MRBGDsuw_WU)
- **Your video here?** If you would like to make a video showing off LosslessCut use cases, let me know and I can link it here!
2020-04-21 19:46:47 +02:00
### Typical workflow
2020-02-19 07:51:34 +01:00
- Drag drop a video file into player or use <kbd></kbd>/<kbd>CTRL</kbd>+<kbd>O</kbd>.
2021-03-28 17:49:07 +02:00
- Press <kbd>SPACE</kbd> to play/pause or <kbd></kbd><kbd></kbd>, <kbd>,</kbd><kbd>.</kbd> or mouse/trackpad wheel to seek back/forth.
2020-05-03 13:28:48 +02:00
- Select the cut segment's start and end time by moving the time marker and then pressing <kbd>I</kbd> to set start time, and <kbd>O</kbd> to set end time.
2021-03-28 17:49:07 +02:00
- Note that all segments you create will be **preserved** and exported as new files. You can change this behavior with the **Yin Yang** symbol ☯️, in which case it will instead **remove** all selected segments and export the parts **between** segments.
- Note also that start times will not be accurate, see [Known issues](#known-issues--limitations)
2020-02-19 07:51:34 +01:00
- *(optional)* If you want to add more than one segment, move to the desired start time and press <kbd>+</kbd>, then select the next segment start/end times with <kbd>I</kbd>/<kbd>O</kbd>.
2020-05-03 13:28:48 +02:00
- *(optional)* If you want to re-merge all the selected segments into one file after cutting, toggle the button `Separate files` to `Merge cuts`.
- *(optional)* If you want to export to a certain output folder, press the `Working dir unset` button (default: Input file folder)
- *(optional)* If you want to change orientation, press the **rotation** button
2020-02-23 11:21:31 +01:00
- *(optional)* By default, audio, video and subtitle tracks from the input file will be cut and exported. Press the `Tracks` button to customise and/or add new tracks from other files.
2020-02-19 07:51:34 +01:00
- *(optional)* select a new output format
2021-03-28 17:49:07 +02:00
- *(optional)* In the right-hand segments panel, right click a segment for options, or drag-drop to reorder. Segments will appear in this order in the merged output.
- **When done, press the `Export` button (or <kbd>E</kbd>) to show an overview with export options.**
- *(optional)* adjust any export options
- **Then press `Export` again to confirm the export**
2020-05-03 13:28:48 +02:00
- Press the **Camera** button (or <kbd>C</kbd>) if you want to take a JPEG/PNG snapshot from the current time
- If you want to move the original file to trash, press the **trash** button
2021-03-28 17:49:07 +02:00
- For best results you may need to trial and error with another output format (Matroska takes nearly everything), change keyframe cut mode or disable some tracks (see known issues below).
- Press <kbd>H</kbd> to view help and all keyboard shortcuts.
- **Note:** The original video file will not be modified. Instead, a file is created file in the same directory as the original file with from/to timestamps in the file name.
2016-10-30 11:57:12 +01:00
2020-04-01 12:17:38 +02:00
## Known issues & limitations
2021-08-23 10:31:29 +02:00
- **Cutting times are not accurate!** Start cut time will be "rounded" to the nearest **previous** keyframe. This means that you often have **move the start cut time to few frames after** the desired keyframe.
2022-06-30 03:22:20 +02:00
- Lossless cutting is not an exact science. For some files, it just works. For others, you may need to trial and error depending on the codec, keyframes etc to get the best cut. See [#330](https://github.com/mifi/lossless-cut/issues/330)
2020-05-03 13:28:48 +02:00
- Your mileage may vary when it comes to `Keyframe cut` vs `Normal cut`. You may need to try both, depending on the video. [ffmpeg](https://trac.ffmpeg.org/wiki/Seeking) also has documentation about these two seek/cut modes. `Keyframe cut` means `-ss` *before* `-i` and `Normal cut` means `-ss` *after* `-i`.
2022-09-04 14:08:29 +02:00
- If you're seeing a blank video at the beginning of the resulting file, try `Keyframe cut` instead.
- You may try to enable the new "Smart cut" mode. However it is very experimental and may not work for most files.
2021-03-28 17:49:07 +02:00
- When exporting you may lose some proprietary data tracks (like `tmcd`, `fdsc` and `gpmd` added by GoPro). These can however be losslessly exported to separate files.
2022-07-21 04:22:17 +02:00
- If you cut a file, but the duration of the exported file is incorrect (or the same as input), try to disable all tracks except for the video track.
2021-03-28 17:49:07 +02:00
- EXIF/metadata can be preserved (see Export Options dialog), but it doesn't always output compliant files, so use it carefully.
2022-06-30 03:22:20 +02:00
- Some codecs are not natively supported, but will preview with low quality playback and no audio. You may convert these files to a supported codec from the File menu, see [#88](https://github.com/mifi/lossless-cut/issues/88).
2020-04-01 12:17:38 +02:00
2021-03-28 17:49:07 +02:00
## Troubleshooting / FAQ
2020-04-01 12:17:38 +02:00
2022-08-07 10:30:24 +02:00
- **Can LosslessCut crop, resize, stretch, mirror, overlay text/images, watermark, blur, redact, re-encode, speed-up/slow-down, create GIF, slideshow, burn subtitles, color grading, fade/combine/mix audio tracks or change audio volume?**
2022-06-30 03:22:20 +02:00
- [No, these are all lossy operations, but in the future I may start to implement such features](https://github.com/mifi/lossless-cut/issues/372).
2022-07-21 04:22:17 +02:00
- **MPEG TS** files have a tendency to be a bit problematic. It may help to **first** remux them to another format like MP4/MKV. Then you can open the MP4/MKV file an work on that.
2022-07-17 23:53:46 +02:00
- Can LosslessCut be batched/automated using a CLI or API?
- No, it was never designed for that. However there are a few feature requests regarding this: [#980](https://github.com/mifi/lossless-cut/issues/980) [#868](https://github.com/mifi/lossless-cut/issues/868)
2022-06-27 01:31:34 +02:00
- **Linux**: If you get an error like `FATAL:setuid_sandbox_host.cc(157)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now.`, try to run it as `./lossless-cut --no-sandbox`. See [#258](https://github.com/mifi/lossless-cut/issues/258)
### Windows issues
2022-07-25 11:33:49 +02:00
- If you get an error immediately when starting up LosslessCut, try to disable your anti-virus or whitelist LosslessCut. See [#18](https://github.com/mifi/lossless-cut/issues/18) [#1114](https://github.com/mifi/lossless-cut/issues/1114)
- How to uninstall LosslessCut? There is no installer. Just delete the folder. Settings and temp files are stored in your [appData](https://www.electronjs.org/docs/api/app#appgetpathname) folder.
2021-07-25 06:48:36 +02:00
- Completely white window when starting up? Try to run with `--disable-gpu` - See [781](https://github.com/mifi/lossless-cut/issues/781).
- Where did the `.exe`/`.zip` downloads go? I decided to stop distributing exe and instead just 7zip, due to the [problems that the exe download was causing and the large size of zips.](https://github.com/mifi/lossless-cut/issues/1072#issuecomment-1066026323)
2022-07-25 11:12:55 +02:00
- [APPX is not signed and **does not work**.](https://github.com/mifi/lossless-cut/issues/337) Please use [7z package](https://github.com/mifi/lossless-cut/releases/latest/download/LosslessCut-win-x64.7z) instead.
2020-04-01 12:17:38 +02:00
2022-06-27 01:31:34 +02:00
If any other problem, check [Known issues](#known-issues--limitations), or please search for existing issues before you file an issue here on GitHub. You can check the developer tools for any errors or clues. Menu: `Tools` -> `Toggle Developer Tools`.
2022-06-14 02:12:01 +02:00
Also you are welcome to hang out on [Discord](https://discord.gg/fhnEREfUJ3) 🤗
2020-07-09 14:16:06 +02:00
2020-04-01 12:17:38 +02:00
## CSV import/export
2020-02-23 11:21:31 +01:00
2021-01-26 21:52:42 +01:00
- The CSV export/import function takes CSV files with one cut segment on each line. Each line contains three columns: `segment start`, `segment end`, `label`.
- `segment start` and `segment end` are expressed in seconds or left empty. Empty `segment end` means segment ends at the duration of the video.
- Use comma `,` to separate the fields (**not** semicolon `;`)
2020-02-23 11:21:31 +01:00
### example.csv
```csv
,56.9568,First segment starting at 0
70,842.33,"Another quoted label"
1234,,Last segment
```
## Command line interface (CLI)
2022-07-17 23:53:46 +02:00
LosslessCut only has limited support for automation through the CLI. Note that these examples assume that you have set up LosslessCut in your `PATH` environment. Alternatively you can run it like this:
2022-05-02 23:20:15 +02:00
```
# First navigate to the folder containing the LosslessCut app
cd /path/to/directory/containing/app
# On Linux:
./LosslessCut arguments
# On Windows:
./LosslessCut.exe arguments
# On MacOS:
./LosslessCut.app/Contents/MacOS/LosslessCut arguments
```
### Open one or more files:
```bash
LosslessCut file1.mp4 file2.mkv
```
### Override settings (experimental)
See [available settings](https://github.com/mifi/lossless-cut/blob/master/public/configStore.js). Note that this is subject to change in newer versions. ⚠️ If you specify incorrect values it could corrupt your configuration file. You may use JSON or JSON5:
```bash
LosslessCut --settings-json '{captureFormat:"jpeg", "keyframeCut":true}'
```
### Multiple instances
By default, only a single running instance of LosslessCut is allowed. If you start a new LosslessCut instance from the command line, it will instead pass the list of files onto the already running instance. You can override this behavior by passing `--allow-multiple-instances` via the command line. Running multiple instances is experimental.
## Developing
See the [developer notes](developer-notes.md).
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
2021-03-28 17:47:51 +02:00
[Paypal](https://paypal.me/mifino/usd) | [crypto](https://mifi.no/thanks)
2018-09-30 20:56:38 +02:00
2022-02-21 08:39:03 +01:00
## Articles
- [Featured in the Console newsletter](https://console.substack.com/p/console-93)
2020-04-21 19:46:47 +02:00
## Attributions
- 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")
2020-04-21 19:46:47 +02:00
- [Lottie animation](https://lottiefiles.com/7077-magic-flow)
2020-02-21 06:00:12 +01:00
- Thanks to Adi Abinun for his UI sketch work, inspiration and guidance
2020-11-21 15:01:37 +01:00
- [Thanks to everyone for supporting](https://mifi.no/thanks/) my open source work 🙌
2020-05-03 16:21:46 +02:00
- Thanks to translators who helped translate the app. [You can too!](https://hosted.weblate.org/projects/losslesscut/losslesscut/)
2019-10-04 12:38:07 +02:00
2020-11-21 15:01:37 +01:00
## More software
- I made a command line video editor with slick transitions and lots of colors! [editly](https://github.com/mifi/editly)
- I made a tool for cross platform sharing of files between computer/phone over the local network: [ezshare](https://github.com/mifi/ezshare)
- I created a super simple Instagram bot for getting more followers [SimpleInstaBot](https://github.com/mifi/SimpleInstaBot)
2019-10-04 12:38:07 +02:00
---
2021-01-25 00:06:07 +01:00
Made with ❤️ in [🇳🇴](https://www.youtube.com/watch?v=uQIv8Vo9_Jc)
2020-04-01 17:17:51 +02:00
2020-05-16 17:51:50 +02:00
[More apps by mifi.no](https://mifi.no/)
2020-07-09 14:16:06 +02:00
Follow me on [GitHub](https://github.com/mifi/), [YouTube](https://www.youtube.com/channel/UC6XlvVH63g0H54HSJubURQA), [IG](https://www.instagram.com/mifi.no/), [Twitter](https://twitter.com/mifi_no) for more awesome content!