Skip to content

Commit 491c751

Browse files
authored
[docs] add video editor (#7863)
## Description Adds video editor to docs. ## Tests - [x] Reviewed the doc
1 parent a574df5 commit 491c751

File tree

1 file changed

+128
-0
lines changed

1 file changed

+128
-0
lines changed
Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
---
2+
title: Video Editor
3+
description: Edit your videos with trim, crop, and rotate tools
4+
---
5+
6+
# Video Editor
7+
8+
The video editor lets you make basic edits to your videos directly within Ente Photos. Edit videos with trim, crop, and rotate tools, and save them as new copies while preserving your originals.
9+
10+
> **Note**: The video editor was revamped in v1.2.18 to drastically improve speed when editing larger videos and enhance the user experience.
11+
12+
## Features
13+
14+
The video editor supports three main editing operations:
15+
16+
### Trim
17+
18+
Cut your videos to the exact length you need:
19+
20+
- Set start and end points using the timeline slider
21+
- Preview your selection before saving
22+
- Minimum video duration: 1 second
23+
- View trimmed duration in real-time
24+
25+
### Crop
26+
27+
Adjust the video frame to different aspect ratios or custom dimensions:
28+
29+
**Available aspect ratios:**
30+
31+
- **Free** - Manually adjust the crop area without constraints
32+
- **1:1** - Square format (Instagram posts)
33+
- **9:16** - Vertical format (Instagram Stories, TikTok)
34+
- **16:9** - Widescreen format (YouTube, most videos)
35+
- **3:4** - Vertical portrait
36+
- **4:3** - Classic format
37+
38+
The crop tool automatically accounts for video rotation, ensuring the aspect ratio appears correctly in the final output.
39+
40+
### Rotate
41+
42+
Rotate videos in 90-degree increments:
43+
44+
- **Rotate left** - Counter-clockwise 90°
45+
- **Rotate right** - Clockwise 90°
46+
47+
Useful for correcting videos captured in the wrong orientation.
48+
49+
## How to use the video editor
50+
51+
**On mobile:**
52+
53+
1. Open any video in your library
54+
2. Tap the **Edit** button in the bottom actions
55+
3. The video editor opens with three action buttons at the bottom:
56+
- **Trim** - Adjust video length
57+
- **Crop** - Change video dimensions
58+
- **Rotate** - Change video orientation
59+
4. Make your edits using one or more tools
60+
5. Tap **Save copy** to create the edited version
61+
62+
**What happens when you save:**
63+
64+
- Ente creates a new video file with your edits applied
65+
- The original video remains unchanged
66+
- The new video preserves:
67+
- Creation time from the original
68+
- Location data (if available)
69+
- Collection/album membership
70+
- The edited video automatically syncs to your account
71+
- Both videos appear in your library
72+
73+
## Video preview and playback
74+
75+
While editing:
76+
77+
- Preview your changes in real-time
78+
- Use playback controls to review specific sections
79+
- Play/pause the video to verify your edits
80+
- Seek through the timeline to check different moments
81+
82+
The preview shows exactly how your edited video will look, including all applied transformations.
83+
84+
## Technical details
85+
86+
### Export methods
87+
88+
Ente uses two export methods to ensure compatibility across devices:
89+
90+
1. **Native export** (default)
91+
- **iOS**: Uses AVFoundation with HighestQuality preset or Passthrough (no re-encoding for simple trims)
92+
- **Android**: Uses Media3 Transformer with H.264 encoding
93+
- Faster performance and better quality preservation
94+
- Hardware-accelerated on supported devices
95+
- **Output**: MP4 with H.264 video, maintains original quality when possible
96+
97+
2. **FFmpeg fallback**
98+
- Automatically used if native export fails
99+
- Cross-platform software-based encoding
100+
- **Output**: MP4 with H.264 video (libx264), AAC audio
101+
102+
The app automatically switches between methods to ensure your edits can be saved successfully.
103+
104+
### Output format
105+
106+
All edited videos are exported as MP4 files:
107+
108+
- **File naming**: `[original-name]_edited_[timestamp].mp4`
109+
- **Resolution**: Preserves original resolution when possible
110+
- **Quality**: Native export maintains highest quality; FFmpeg uses standard H.264/AAC encoding
111+
112+
### Processing time
113+
114+
Export time depends on:
115+
116+
- Video duration and resolution
117+
- Number of edits applied
118+
- Device processing power
119+
- Export method used (native vs FFmpeg)
120+
121+
A progress dialog shows the export status while your video is being processed.
122+
123+
## Limitations
124+
125+
- **Minimum duration**: Videos must be at least 1 second long after trimming
126+
- **Mobile only**: Currently available on iOS and Android apps only
127+
- **Single video editing**: Edit one video at a time
128+
- **Destructive workflow**: Cannot save edit settings - each export creates a final video

0 commit comments

Comments
 (0)