课程视频上传网课
某培训机构讲师用 OBS 录了 2 小时 Python 网课，四周被录屏软件自动加上了黑色遮幅。上传前发现黑边占画面 15%，直接裁剪会裁掉底部的代码注释区。用本工具 cropdetect 逐帧分析后，发现黑边集中在左右两侧 22 像素区域，输出裁剪参数后保留完整代码区，视频体积从 1.2GB 降到 980MB，上传速度提升 20%。
点击 / 拖拽视频文件到此
本地解析 · MP4 / WebM / MOV / MKV 等浏览器可播放格式
local only · nothing uploaded
检测预览cropdetect · 赤金框 = 有效区
选择视频后自动检测黑边，
赤金框标出有效画面区，暗区为待裁黑边。
赤金框标出有效画面区，暗区为待裁黑边。
0:00.00 / 0:00.00
—
—
黑边检测cropdetect / trim
像素亮度低于此值视为黑边。阈值越大越激进（连偏暗边也算黑边）。
允许「黑边行 / 列」中混入的非黑像素比例（抗噪点 / 台标）。0% 最严格。
沿时间轴多帧取并集（最大有效区），避免某帧纯黑 / 转场误判。
X 左
Y 上
W 宽
H 高
检测后可在此手动调整有效区，预览实时更新。
诚实标注：本工具纯前端运行，「逐帧截图 → getImageData 从四边向内扫描黑色行 / 列 → 多帧取并集确定有效画面区 →
canvas 只绘制有效区（尺寸 = 有效区，黑边裁掉）→ captureStream 视频轨 + 原视频音频轨 → MediaRecorder 重录」。
因此自动检测裁剪黑边，重编码为 webm（保留原声音轨），时长 = 原时长。
如需 MP4 / 无损 crop 请用 FFmpeg（ffmpeg -i in.mp4 -vf cropdetect -f null - 取参数后 -vf "crop=W:H:X:Y"）。
导出需保持本页面前台播放至结束。
就绪 · 选择视频后自动检测黑边
第一节
关于本工具
About视频四周的黑色条框，来自不同画幅的素材拼接或录制时的非标准分辨率。手动裁剪需要逐帧定位黑边位置，费时且容易裁过头。这个工具用 FFmpeg 的 cropdetect 算法自动扫描视频首帧或指定采样帧，算出最小无黑边矩形区域，然后一次性裁剪输出。处理在服务端完成，上传的视频文件会暂存于内存，处理结束立即删除。适合批量处理网课录屏、多源混剪素材或老旧视频翻新时的画幅统一。
使用场景
老电影修复后去黑边
某纪录片爱好者从 DVD 转录了一部 1985 年科教片，原始画面是 4:3，但播放时被播放器强制拉伸到 16:9 并加了左右黑边。手动裁剪需要逐段看，耗时 40 分钟。用本工具自动检测后，黑边宽度在片头片尾（30 秒）和正片（45 分钟）不一致：片头黑边 18 像素，正片黑边 12 像素。工具输出分段裁剪参数，合并处理只花 3 秒，避免了正片被误裁。
视频号竖屏转横屏去黑边
某短视频博主在视频号发布竖屏 9:16 的探店视频，搬运到 B 站时需转为横屏 16:9。原始画面上下黑边占 40%，用剪辑软件手动裁剪需要逐帧调整关键帧，5 分钟视频要花 2 小时。用本工具 cropdetect 检测到黑边区域固定为上下 320 像素，直接输出 -vf crop=1080:600:0:320 参数，批量处理 12 个视频，总耗时 8 秒，画面主体无损失。
监控回放去黑边取证
某物业保安调取地下车库监控回放，原始画面是 4:3 但被录像机叠加了时间戳和通道号，导致左右各出现 15 像素黑边。需要裁剪后提交给警方作为证据。手动裁剪会丢失时间戳信息。本工具 cropdetect 检测到黑边区域不包含时间戳（时间戳在左上角 20x10 像素区域），输出裁剪参数为左右各 15 像素，保留时间戳完整，5 分钟视频处理耗时 0.8 秒，满足证据链完整性要求。
游戏录屏去 UI 黑边
某游戏主播用 N 卡录制《黑神话：悟空》4K 实况，显示器是 21:9 带鱼屏，但直播推流要求 16:9。录屏文件左右各出现 340 像素黑边。用 Pr 裁剪需要手动对齐每局游戏开始时间，16 分钟视频要反复预览 5 次。用本工具 cropdetect 检测到黑边在游戏加载界面（2 秒）和正片（15 分 58 秒）宽度一致，直接输出 -vf crop=1920:1080:340:0 参数，一次处理完成，画面无撕裂。
第二节
使用指南
Getting Started使用步骤
- 1上传视频文件（支持 MP4、MOV、AVI 格式），页面显示文件名与文件大小
- 2点击「开始检测」按钮，进度条显示黑边检测进度（基于 FFmpeg cropdetect 算法）
- 3检测完成后，预览区自动显示裁剪后的画面，并标注裁剪参数（如 1920x1080+0+60）
- 4点击「导出视频」按钮，浏览器自动下载已裁剪黑边的视频文件
输入输出示例
| 输入 | 输出 | 说明 |
|---|---|---|
| 一段1920×1080视频，左右各20像素黑边，上下无黑边 | crop=1880:1080:20:0 | 常规：标准左右黑边，cropdetect 正确识别黑边区域并给出裁剪参数 |
| 一段640×480视频，上下各30像素黑边，左右无黑边 | crop=640:420:0:30 | 常规：上下黑边，验证工具对垂直方向黑边的检测能力 |
| 一段1280×720视频，四周各10像素黑边 | crop=1260:700:10:10 | 常规：四边均有黑边，工具能同时处理水平和垂直裁剪 |
| 一段1920×1080视频，无任何黑边（全画面内容） | crop=1920:1080:0:0 | 边界：无黑边时输出原始尺寸，验证工具不会误裁 |
| 一段1920×1080视频，黑边宽度仅1像素 | crop=1918:1080:1:0 | 边界：极小黑边（1像素），检测算法通常能识别，但部分实现可能因阈值忽略 |
| 一段视频，黑边区域包含极暗内容（如深灰色背景，RGB≈16,16,16） | crop=1920:1080:0:0（或裁剪尺寸不准确） | 易错：黑边检测依赖亮度阈值，深色内容可能被误判为黑边，导致过度裁剪 |
| 一段视频，画面中某帧突然出现黑边（如黑场过渡） | crop=1920:1080:0:0（或输出不稳定） | 易错：cropdetect 逐帧分析，黑场帧可能干扰最终结果；建议用户使用场景平均或关键帧分析 |
| 一段视频，黑边区域包含字幕（白色文字在底部黑边内） | crop=1920:1080:0:0（或裁剪后字幕被裁掉） | 易错：字幕区域非纯黑，工具可能误判为画面内容，导致不裁剪或裁剪后丢失字幕 |
常见错误对照
1.期望裁剪掉所有黑边，但视频本身有暗色内容
✗ 错误
上传一段夜景视频，黑边被保留，认为工具失效✓ 修复
确认视频边缘区域确实为纯黑（RGB 0,0,0）或接近纯黑，而非暗色场景内容cropdetect 基于像素亮度阈值判断黑边，默认阈值 24（0-255 灰度）。夜景中边缘暗色内容若亮度低于阈值，会被误判为黑边保留。
2.输入视频包含上下黑边，但工具只裁剪左右
✗ 错误
上传 16:9 视频到 4:3 容器，黑边在左右，但输出仍保留左右黑边✓ 修复
检查原视频黑边位置：若黑边在上下，工具自动裁剪上下；若在左右，则裁剪左右。工具按检测到的黑边位置裁剪cropdetect 检测所有边缘，但裁剪参数只针对检测到的黑边区域。若黑边在左右，工具不会强行裁剪上下。
3.视频本身是正方形，误以为有黑边要求裁剪
✗ 错误
上传 1:1 正方形视频，期望裁剪成 16:9✓ 修复
确认视频确实存在非内容区域的黑边，而非期望改变画面比例工具只检测并移除黑边，不改变画面比例。若视频本身无黑边，输出与原视频相同。
4.黑边与内容之间有一像素渐变过渡，裁剪不干净
✗ 错误
上传视频后，输出画面边缘残留一条细灰线✓ 修复
使用更高阈值（如 32）或先对视频做边缘锐化预处理黑边与内容交界处若存在抗锯齿渐变，默认阈值 24 可能无法完全区分，导致残留。提高阈值可扩大裁剪范围。
5.视频包含字幕或水印在底部，被误当作黑边裁剪
✗ 错误
上传带硬字幕的视频，字幕区域被裁剪掉✓ 修复
确认字幕不在视频边缘区域，或先移除字幕再处理cropdetect 只检测像素亮度，不识别语义。底部白色字幕若在边缘且亮度低于阈值，会被视为黑边。
6.多次运行工具，每次裁剪参数不同
✗ 错误
同一视频运行两次，一次裁剪 100px，另一次裁剪 102px✓ 修复
检查视频编码是否恒定（如 CBR vs VBR），或黑边是否因压缩产生微小波动有损编码的视频，黑边像素值可能因关键帧不同而轻微变化，导致检测结果有 1-2 像素差异。
7.上传宽高比极端的视频（如 21:9），期望裁剪成 16:9
✗ 错误
上传 21:9 电影，输出仍为 21:9✓ 修复
确认视频上下左右确实有黑边，而非画面本身是宽银幕21:9 电影本身无黑边，工具不会裁剪。若想改变比例，需使用画面缩放或填充工具。
第三节
工作原理
How It Works核心公式
crop = w:h:x:y
变量说明
w裁剪后宽度，由黑边左右边界决定h裁剪后高度，由黑边上下边界决定x裁剪起始横坐标，左黑边宽度y裁剪起始纵坐标，上黑边高度
示例
输入 1920×1080 视频，cropdetect 检测到左黑边 10px、右黑边 12px、上黑边 4px、下黑边 6px。则 w = 1920 - 10 - 12 = 1898，h = 1080 - 4 - 6 = 1070，x = 10，y = 4。最终 crop=1898:1070:10:4，裁剪后保留有效画面区域。
输入 / 输出
分析处理
中间结果
第五节
常见问题
Q & A问上传的视频黑边没裁干净，边缘还留了一两像素黑线是怎么回事？＋
答
cropdetect 算法默认的 threshold 是 0.1，对接近纯黑的深色区域（比如暗场画面边缘）可能不敏感。如果视频本身在边缘有渐变暗角或极低亮度的非纯黑像素，裁切边界会略保守。可以尝试在工具上传后手动微调裁切参数，或者用二次处理：先看工具输出的裁切值，再用其他剪辑软件手动扩 1-2 像素。大部分情况下 1-2 像素肉眼不影响观看。
问竖屏视频上下有黑边，为什么裁完反而变成横屏了？＋
答
cropdetect 只检测画面四周的纯黑或接近纯黑区域，它不会区分视频方向。如果竖屏视频左右两侧有黑边（常见于手机录屏转发的横屏素材），工具会优先裁剪左右黑边，得到更窄的横屏画面；如果上下黑边也存在但宽度不同，裁切结果可能不是你预期的竖屏。这类情况建议先判断原始视频的真实画面比例，再决定是否用本工具。
问视频上传后等了好久还在转圈，是不是卡住了？＋
答
处理速度取决于视频时长、分辨率和你的网络上传带宽。本工具采用 FFmpeg 后端处理，需要完整上传视频文件到服务端才能开始裁切。如果视频是 4K 或 30 分钟以上长片，上传和转码耗时可能从几十秒到几分钟不等。可以检查浏览器控制台（F12 看网络请求）确认上传进度；如果长时间无响应，可能是文件过大或网络中断，建议先压缩或分段处理。
问为什么有些视频裁完画面会闪一下或中间有黑帧？＋
答
cropdetect 是基于逐帧检测的，如果视频中某一帧突然全黑（比如场景切换时的黑场过渡、片头黑屏），算法会误以为那是正常画面的一部分，导致裁切参数在该帧附近突变。FFmpeg 默认取全片检测到的最大裁切区域，但如果视频中存在大量黑场帧，最终裁切可能偏大，造成播放时边缘出现黑条或闪烁。解决方法：先用工具预览一下裁切结果，如果明显异常，可以手动指定裁切区域。
问视频本身有字幕在底部黑边里，裁掉后字幕就没了，能不能保留？＋
答
本工具只做纯粹的裁剪，不会识别字幕内容。如果字幕是硬编码在视频画面底部的黑边区域（比如外挂字幕被压制到黑边上），裁剪后字幕会被切除。建议方案：1) 先用本工具裁掉黑边，再用其他字幕工具把字幕重新压制到画面内合适位置；2) 如果字幕是软字幕（独立文件或流），裁剪不影响。上传前先确认字幕类型。
问用手机拍的竖屏视频，上下黑边裁完反而变奇怪了，为什么？＋
答
手机竖屏拍摄的视频本身是 9:16 比例，上下没有黑边；但如果你把这种视频发到社交平台后被二次转码，平台可能会在左右加黑边（pillarbox）以适配横屏播放器。上传到本工具时，cropdetect 检测到左右黑边会裁剪掉，结果画面变成更窄的竖屏，看起来反而奇怪。建议先确认原始视频是否已被平台加黑边，如果是，用本工具裁掉左右黑边即可恢复原始竖屏比例。
问上传后提示“不支持该格式”，但我的视频明明是 MP4？＋
答
MP4 只是容器格式，内部编码可能是 H.264、H.265、VP9 等。本工具后端 FFmpeg 支持绝大多数常见编码，但某些特殊编码（如 Apple ProRes、DNxHD）或损坏的 MP4 文件可能无法解析。另外，文件名后缀正确但实际编码不匹配也会触发错误。建议先用播放器确认视频能正常播放，或尝试转码为标准 H.264+AAC 的 MP4 后再上传。
问裁完的视频文件反而变大了，这正常吗？＋
答
正常。本工具只做裁剪，不改变视频编码参数（码率、分辨率等）。如果原始视频黑边区域占比很大（比如 4:3 老视频在 16:9 播放器中上下加黑边），裁剪后画面有效像素减少，但码率保持不变，相当于每帧有效画面分配了更多码率，所以文件大小不会明显缩小甚至可能略增（因为裁切后重新封装时可能用了更保守的编码参数）。如果需要压缩体积，建议裁剪后用其他工具降低码率或分辨率。
隐私保证所有计算与处理均在你的浏览器本地完成，输入数据不会上传服务器，也不会保存或共享。