Skip to content

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.md
index 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).
## Download
diff --git a/docs/features.md b/docs/features.md
new file mode 100644
index 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.ts
index 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.tsx
index 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.md
const 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 &quot;rounded&quot; 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.css
index 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> is
opened. 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. */