The swiss army knife of lossless video/audio editing
Features and use cases: one full list in docs/features.md, highlights in the README and on the homepage
Claude65126ddeea8d
diff --git a/README.md b/README.mdindex 004a747e..3bfe2ca8 100644--- a/README.md+++ b/README.md@@ -17,12 +17,11 @@</div>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. There are also many more [use cases](#typical-workflow). Everything is extremely fast because it does an almost direct data copy, fueled by the awesome FFmpeg which does all the grunt work.+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. There are also many more [use cases](https://losslesscut.app/docs/features#example-use-cases). Everything is extremely fast because it does an almost direct data copy, fueled by the awesome FFmpeg which does all the grunt work.## Table of contents- [Features](#features)-- [Example lossless use cases](#example-lossless-use-cases)- [Download](#download)- [Supported formats](#supported-formats)- [Documentation, usage & getting started](#documentation)@@ -32,77 +31,20 @@ The main feature is lossless trimming and cutting of video and audio files, whic## Features-- Lossless cutting of most video and audio formats-- [Smart cut](https://github.com/mifi/lossless-cut/issues/126) (experimental)-- 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)-- Lossless multi track/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)-- View technical data about all tracks. Edit file metadata, per-track metadata and per-track disposition- - Suggestions for common metadata keys and languages- - Copy metadata from another track or file, or apply a value to all tracks of the same type- - See which tracks have been changed, and reset changes-- Select video/audio tracks for playback. Playback multiple audio tracks simultaneously.-- Fast multi-file workflow (note: no mass/batch export yet)-- Keyboard shortcut workflow-- Losslessly remux video/audio into a different container (file) format-- Take full-resolution snapshots from videos in JPEG/PNG format (low or high quality)-- Export ranges of video frames to images (every nth frame, second, by scene change, best thumbnails)- - Export only from a selected time range (segment)- - Optionally include original timestamps in image file names-- Manual input of cutpoint times-- Apply a per-file timecode offset (and auto load timecode from file)-- Change rotation/orientation metadata in videos-- Timeline zoom and frame/keyframe jumping for cutting around keyframes-- Video thumbnails and audio waveform-- 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-- Undo/redo-- Advanced segment query and mutation JS-based expression language.-- Give labels to cut segments, annotate with tags-- [Import/export](https://losslesscut.app/docs#importexport-projects) 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, silent audio detection, and scene change detection-- Divide timeline into segments of length L, size (X MB), N number of segments or even randomized segments!-- Speed up / slow down video or audio file ([changing FPS](https://github.com/mifi/lossless-cut/issues/1712))-- Lossless crop and aspect ratio modification-- Basic [CLI](https://losslesscut.app/docs/cli) and [HTTP API](https://losslesscut.app/docs/api)-- Show (DJI) embedded GPS track on a map-- Losslessly Download videos over HTTP (e.g. HLS `.m3u8`)-- Extremely fast removal of all non-keyframes (e.g. timelapse)--## Example lossless use cases--- Cut out commercials from a recorded TV show (and re-format from TS to MP4).-- 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.-- Include an external subtitle into a video-- Copy track titles and languages from one file to another when combining tracks.-- Quickly change a H264/H265 MKV video to MOV or MP4 for playback on iPhone.-- Import a list of cut times from other tool as a EDL (edit decision list, CSV) and run these cuts with LosslessCut.-- 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.-- Quickly cut a [YouTube video](https://youtube-dl.org/) by its chapters (or music times from a comment).-- 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.-- Change author, title, GPS position, recording time of a video.-- Fix rotation of a video that has the wrong orientation flag set.-- 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)-- Losslessly split a video into one file per scene (note you probably have to shift segments, see [#330](https://github.com/mifi/lossless-cut/issues/330).)-- Cut away silent parts from an audio/video file.-- Split video into segments to for example respect Twitter's 140 second limit.-- Annotate each segment with one or more tags, then use those tags to organize your segments or use it to create an output folder structure or hierarchy for your segments.--See also [Recipe cookbook](https://losslesscut.app/docs/recipes)+<!-- Highlights only, the full list is docs/features.md. Keep in sync with the homepage's (website/src/components/Home.tsx) -->+- Cut and trim video and audio losslessly, in seconds+- Merge files with identical codecs, for example from the same camera+- Add, remove, replace or extract tracks: audio, subtitles and more+- Change the format (remux), for example from MKV to MP4, without re-encoding+- Segments with labels and tags, and import/export of chapters, CSV, EDL, YouTube timestamps and more+- Detect scenes, black frames and silence, and split by them+- Edit metadata, rotation and chapter marks+- Export snapshots and video frames as images+- Keyboard shortcut workflow, a [CLI](https://losslesscut.app/docs/cli) and an [HTTP API](https://losslesscut.app/docs/api)++**[All features and example use cases →](https://losslesscut.app/docs/features)**++See also the [Recipe cookbook](https://losslesscut.app/docs/recipes).## Downloaddiff --git a/docs/features.md b/docs/features.mdnew file mode 100644index 00000000..0d444046--- /dev/null+++ b/docs/features.md@@ -0,0 +1,97 @@+# Features ✨++LosslessCut cuts, merges and edits video and audio files without re-encoding them, so it's fast and keeps the original quality.++Here's everything it can do, and what people use it for. Which functions are available depends on the file and its format and codecs. See also the [Recipe cookbook](recipes.md) for step-by-step instructions.++## Cutting++- Lossless cutting of most video and audio formats+- Cut away parts of a file (for example commercials), or keep only the parts you want+- Rearrange the order of the segments+- Type in cut point times+- Timeline with zoom and frame/keyframe jumping, for cutting around keyframes+- Video thumbnails and audio waveform on the timeline+- [Smart cut](https://github.com/mifi/lossless-cut/issues/126) (experimental), to allow cutting between keyframes. It doesn't work for all files.+- Extremely fast removal of all non-keyframes (for example for a timelapse)+- Speed up or slow down a video or audio file ([by changing the FPS](https://github.com/mifi/lossless-cut/issues/1712))+- Lossless crop and aspect ratio change++Lossless cuts can only start at a keyframe, so a cut starts at the keyframe before your cut point, a fraction of a second up to several seconds earlier depending on the encoding. See [Troubleshooting](troubleshooting.md) for more.++## Segments++- Divide the timeline into segments of a length, a file size (X MB) or a number of segments, or randomized segments+- Detect black scenes, silent audio and scene changes, and create segments from them+- Give segments labels and tags+- Select and change segments with a JavaScript-based [expression language](expressions.md)+- [Import and export](index.md#importexport-projects) segments: MP4/MKV chapter marks, text files, YouTube, CSV, CUE, XML (DaVinci Resolve, Final Cut Pro) and more+- Edit the embedded chapter marks of MKV/MP4 files+- Segments are saved per file in a project file+- Undo/redo++## Merging++- Lossless merge/concatenation of files with identical codec parameters (for example from the same camera)++## Tracks++- Combine tracks from multiple files (for example add a music or subtitle track to a video)+- Remove tracks you don't need+- Replace or re-encode only some of the tracks+- Extract all tracks from a file into separate files: video, audio, subtitles, attachments and others+- Choose the video and audio tracks for playback, and play several audio tracks at once+- View subtitles++## Metadata++- View technical data about all tracks+- Edit the file's metadata, and each track's metadata and disposition+ - Suggestions for common metadata keys and languages+ - Copy metadata from another track or file, or apply a value to all tracks of the same type+ - See which tracks have changed, and reset the changes+- Change the rotation/orientation metadata of videos+- Apply a per-file timecode offset (and load the timecode from the file)+- Show the embedded GPS track (for example from DJI drones) on a map++## Formats and export++- Losslessly remux video/audio into a different container (file) format+- Take full-resolution snapshots from videos as JPEG/PNG (low or high quality)+- Export ranges of video frames to images: every nth frame or second, at scene changes, or the best thumbnails+ - Only from a selected time range (segment)+ - Optionally with the original timestamps in the image file names+- Losslessly download videos over HTTP (for example HLS `.m3u8`)++## Workflow++- Fast workflow for many files, one at a time (there's no batch export, see [Batch processing](batch.md))+- Keyboard shortcut workflow, with customizable shortcuts+- See the FFmpeg commands that were run, so you can change and re-run them on the command line+- Basic [CLI](cli.md) and [HTTP API](api.md)++## Example use cases++Everything here is lossless unless noted.++- Cut out commercials from a recorded TV show (and change it from TS to MP4)+- Remove an audio track from a file+- Extract the music track from a video and cut it to your needs+- Add music to a video, or replace its audio track+- Combine audio and video tracks from separate recordings+- Add an external subtitle file to a video+- Copy track titles and languages from one file to another when combining tracks+- Change the language of a file's audio or subtitle tracks+- Change an H264/H265 MKV video to MOV or MP4, for example for playback on an iPhone+- Cut a file by its MP4/MKV chapters+- Cut a YouTube video (downloaded with [yt-dlp](https://github.com/yt-dlp/yt-dlp)) by its chapters, or by a list of times from a comment+- Import a list of cut times from another tool as an EDL (edit decision list, CSV) and make those cuts, or export your cut times as a CSV EDL for another tool+- Attach cover art or a thumbnail to a video or audio file, from a JPEG file or a frame on the timeline+- Change the author, title, GPS position or recording time of a video+- Fix the rotation of a video that has the wrong orientation flag+- Loop a video or audio clip X times without re-encoding (see [#284](https://github.com/mifi/lossless-cut/issues/284))+- Split a video into one file per scene (you'll probably have to shift the segments, see [#330](https://github.com/mifi/lossless-cut/issues/330))+- Cut away the silent parts of an audio or video file+- Split a video into parts of a maximum length, for example for a social media platform's limit+- Tag segments, then use the tags to organize them, or to create an output folder structure for them+- Convert a video, or parts of it, into image files (not lossless)diff --git a/website/astro.config.ts b/website/astro.config.tsindex fd61b799..76de028a 100644--- a/website/astro.config.ts+++ b/website/astro.config.ts@@ -38,6 +38,7 @@ export default defineConfig({// Docs pages (the files in ../docs) by URL path. A new doc is built, but only listed here once added.sidebar: ['docs',+ 'docs/features','docs/installation','docs/requirements','docs/troubleshooting',diff --git a/website/src/components/Home.tsx b/website/src/components/Home.tsxindex 28f70497..2fb4123d 100644--- a/website/src/components/Home.tsx+++ b/website/src/components/Home.tsx@@ -1,7 +1,7 @@// The homepage content. Rendered to static HTML at build time (no client-side JavaScript).import type { CSSProperties, ReactNode } from 'react';import type { LucideIcon } from 'lucide-react';-import { AudioWaveform, Camera, Clock, CodeXml, Combine, Layers, ListOrdered, Monitor, PackageOpen, RefreshCw, RotateCw, Save, Scissors, Star, Tag, Terminal, ZoomIn } from 'lucide-react';+import { Camera, CodeXml, Combine, Layers, ListOrdered, Monitor, RefreshCw, ScanSearch, Scissors, SquarePen, Star, Terminal } from 'lucide-react';import macAppStoreBadge from '../../../mac-app-store-badge.svg?url';import msStoreBadge from '../../../ms-store-badge.svg?url';@@ -33,35 +33,26 @@ const quotes = ['In Chinese, the word "Lossless" (pronounced like "Lao-Si-Le-Si") sounds incredibly similar to the luxury car brand "Rolls-Royce" ("Lao-Si-Lai-Si"). I think this is a beautiful coincidence because this software truly is the Rolls-Royce of the video-cutting world — smooth, premium, pure, and absolutely perfect.',];+// Highlights only, the full list is docs/features.md (https://losslesscut.app/docs/features). Keep in sync with the README's.const features: { text: string, Icon: LucideIcon }[] = [- { text: 'Losslessly trim or cut out parts of video/audio', Icon: Scissors },- { text: 'Lossless merge/concatenation of arbitrary files (identical codec parameters)', Icon: Combine },- { text: 'Lossless stream editing: Combine arbitrary tracks from multiple files', Icon: Layers },- { text: 'Losslessly extract all tracks from a file', Icon: PackageOpen },- { text: 'Remux into any compatible output format', Icon: RefreshCw },- { text: 'Take full-resolution snapshots from videos in JPEG/PNG format', Icon: Camera },- { text: 'Apply a per-file timecode offset in the preview', Icon: Clock },- { text: 'Change rotation/orientation metadata in videos', Icon: RotateCw },- { text: 'Powerful timeline with zoom and frame/keyframe jumping', Icon: ZoomIn },- { text: 'Auto-saves per project cut segments to file', Icon: Save },- { text: 'View ffmpeg last command log so you can modify and re-run recent commands on the command line', Icon: Terminal },- { text: 'Give labels to cut segments', Icon: Tag },- { text: 'Segment panel showing segments with details, export/import cut segments as CSV', Icon: ListOrdered },- { text: 'Video thumbnails and audio waveform', Icon: AudioWaveform },+ { text: 'Cut and trim video and audio losslessly, in seconds', Icon: Scissors },+ { text: 'Merge files with identical codecs, for example from the same camera', Icon: Combine },+ { text: 'Add, remove, replace or extract tracks: audio, subtitles and more', Icon: Layers },+ { text: 'Change the format (remux), for example from MKV to MP4, without re-encoding', Icon: RefreshCw },+ { text: 'Segments with labels and tags, and import/export of chapters, CSV, EDL, YouTube timestamps and more', Icon: ListOrdered },+ { text: 'Detect scenes, black frames and silence, and split by them', Icon: ScanSearch },+ { text: 'Edit metadata, rotation and chapter marks', Icon: SquarePen },+ { text: 'Export snapshots and video frames as images', Icon: Camera },+ { text: 'Keyboard shortcut workflow, a CLI and an HTTP API', Icon: Terminal },];+// a few common ones, the full list is in docs/features.mdconst usageScenarios = [- 'Cut out commercials from a recorded TV show',- 'Remove audio or video track from a file',- 'Add music to a video (or replace existing audio track)',- 'Include a subtitle into a video',- 'Extract music, video or subtitle track from a video and cut it to your needs',- 'Change format of a H264 TV recording from TS to MP4',- 'Fix rotation of a video that has the wrong orientation flag set, e.g. phone recording',- 'Quickly change a H264 MKV video to MOV or MP4 for playback on iPhone',- 'Import a list of cut times from other tool as a EDL (edit decision list, CSV) and run these cuts with LosslessCut',- 'Export a list of cut times as a CSV EDL and run these in another tool',- 'Loop a video / audio clip X times quickly without re-encoding',+ 'Cut out commercials from a recorded TV show (and change it from TS to MP4)',+ 'Extract the music track from a video and cut it to your needs',+ 'Add music to a video, or replace its audio track',+ 'Change an H264/H265 MKV video to MOV or MP4, for example for playback on an iPhone',+ 'Cut a file by its MP4/MKV chapters',];const storeBadges = [@@ -217,29 +208,26 @@ export default function Home({ stars }: { stars: number }) {<WhiteSection><h2 style={{ margin: '20px 0' }}>Features</h2>- <Collapsible label="Show all features" collapsedHeight={460}>- <div className="feature-grid">- {features.map(({ text, Icon }) => (- <div key={text} className="feature-card">- <Icon aria-hidden size={28} strokeWidth={1.75} className="feature-icon" />- <div>{text}</div>- </div>- ))}- </div>- </Collapsible>+ <div className="feature-grid">+ {features.map(({ text, Icon }) => (+ <div key={text} className="feature-card">+ <Icon aria-hidden size={28} strokeWidth={1.75} className="feature-icon" />+ <div>{text}</div>+ </div>+ ))}+ </div>- <h2 style={{ margin: '20px 0' }}>Other usage scenarios</h2>+ <h2 style={{ margin: '20px 0' }}>Example use cases</h2><div className="list">- <Collapsible label="Show all usage scenarios" collapsedHeight={300}>- <List items={usageScenarios} />- </Collapsible>+ <List items={usageScenarios} />- <div style={{ marginLeft: '40px' }}>- * Which function is available depends on the file in question and which format/codec this file has<br />- * This app is not for exact cutting. Start cut time will be "rounded" to the nearest previous keyframe, which may be a fraction of a second before your desired cut point, or up to several seconds, depending on the encoding.- </div>+ <p className="note">+ Which functions are available depends on the file and its format and codecs. Lossless cuts can only start at a keyframe, so a cut starts at the keyframe before your cut point, a fraction of a second up to several seconds earlier depending on the encoding.+ </p></div>++ <a className="button" href="/docs/features">See all features and use cases</a></WhiteSection><div className="padded" style={{ padding: '110px 30px 80px 30px' }}>diff --git a/website/src/styles/home.css b/website/src/styles/home.cssindex 623826e4..84c52624 100644--- a/website/src/styles/home.css+++ b/website/src/styles/home.css@@ -225,10 +225,17 @@ body {width: 1000px;max-width: 100%;display: grid;- grid-template-columns: repeat(auto-fill, minmax(230px, 1fr));+ /* 3 columns for the 9 highlights on wide screens */+ grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));gap: 16px;margin-bottom: 40px;}+.note {+ margin: 10px 0 30px 40px;+ font-size: 15px;+ line-height: 1.5;+ opacity: 0.8;+}.feature-card {display: flex;flex-direction: column;@@ -242,6 +249,21 @@ body {.feature-icon {color: #1d8a96;}+/* phones: the icon next to the text, so the 9 cards take less space */+@media (max-width: 700px) {+ .feature-grid {+ gap: 10px;+ }+ .feature-card {+ flex-direction: row;+ align-items: center;+ gap: 14px;+ padding: 14px 16px;+ }+ .feature-icon {+ flex-shrink: 0;+ }+}/* <Collapsible> in Home.tsx: on phones, the first --collapsed-height of its content element, fading out, until the <details> isopened. Only where :has() works, so other browsers show everything. The wrapper takes no space of its own (display: contents),so the content element keeps its layout. */