定格你所爱的每一帧 Android 视频抽帧应用
从任意视频中精确截取画面，支持 HDR、动态照片与完整 EXIF 保留。通过快捷按钮和底部设置面板可调整格式、质量、导出目录、文件名、静音等。
-green.svg){kind=icon}
- 帧级精准定位 — 始终使用
MediaMetadataRetriever.OPTION_CLOSEST精确定位帧，不回退至关键帧搜索 - 静态图 & 动态照片导出 — 标准高画质 JPEG 导出；动态照片遵循 Google MicroVideo 规范（XMP + 附加 MP4）
- 音频静音选项 — 导出动态照片时可选择不包含音频
- HDR & 杜比视界感知 — 通过
MediaExtractor检测 HDR10、HDR10+、HLG 和杜比视界；为 SDR 导出进行色调映射，避免 HDR 视频截帧偏色 - 快速切换控制栏 — 底栏一键切换静音、动图模式、元数据保留
- 自定义命名 & 导出目录 — 支持预设名称、手动输入、自定义文件夹（可通过 SAF 选择），带有效长度检查
- 无损元数据保存 — 从源视频读取完整 EXIF（拍摄日期、GPS、设备信息、ISO、曝光、焦距），通过
androidx.exifinterface写入导出图片 - 品质优先默认值 — 默认 100% 质量、原始分辨率；用户可自行调整
- 质量与分辨率控制 — 100% 默认，可设置最大像素限制；输入值有边界检查
- 4K 视频低内存占用 — 显式
recycle()+ 缩略图缓存，优化大内存消耗操作以防止 OOM，所有重操作运行在Dispatchers.IO - 懒加载缩略图时间线 — 基于
LazyRow的时间线条，按需加载 120px 缩略图，带实时进度指示器 - Material 3 界面 — 动态取色（Android 12+）、自定义播放控件（±5 秒快进/后退、实时拖动预览）、
ModalBottomSheet导出设置 - Scoped Storage & SAF — 严格使用
MediaStoreAPI，支持保存到共享相册、DCIM、Movies 或自定义路径 - 中英双语 — 跟随系统语言自动切换
 |
 |
 |
| 首页状态 选择视频后即可开始精准定位帧。 |
抽帧预览 时间线缩略图和播放器联动，方便精确停在目标画面。 |
导出设置 格式、质量、目录、HDR 与动态照片选项集中在底部面板。 |
FrameEcho/
├── app/ # 应用模块（MVVM + Compose）
│ └── ui/
│ ├── player/ # 视频播放器 & 抽帧界面
│ │ ├── PlayerScreen.kt # M3 Compose 界面
│ │ └── PlayerViewModel.kt# 状态管理 + 缩略图缓存
│ ├── about/ # 关于页面
│ ├── export/ # 导出设置底部弹窗
│ ├── components/ # ThumbnailTimeline（LazyRow）
│ └── theme/ # M3 主题（动态取色）
├── core/
│ ├── model/ # 数据模型（ExportConfig、ColorSpaceInfo 等）
│ ├── media/ # 媒体处理引擎
│ │ ├── extraction/ # FrameExtractor
│ │ ├── colorspace/ # HDR 检测 & 色调映射
│ │ ├── metadata/ # MetadataExtractor + MetadataWriter（EXIF）
│ │ └── export/ # FrameExporter（静态 + MicroVideo 动态照片）
│ └── common/ # 共享工具（FileUtils）
├── .github/workflows/ # CI — 构建 APK & 运行测试
└── gradle/libs.versions.toml # 版本目录
| 层级 | 技术 |
|---|---|
| 语言 | Kotlin 2.0 |
| UI | Jetpack Compose + Material 3（动态取色） |
| 视频播放 | Media3 / ExoPlayer |
| 帧提取 | MediaMetadataRetriever（OPTION_CLOSEST） |
| 缩略图时间线 | getScaledFrameAtTime + LazyRow |
| 色彩空间检测 | MediaExtractor → MediaFormat color-transfer / color-standard |
| 色调映射 | HdrToneMapper（HDR 源自动映射为 sRGB） |
| 元数据 | ExifInterface（AndroidX）+ MediaMetadataRetriever |
| 动态照片 | MediaMuxer 剪辑提取 + XMP 注入（Google MicroVideo 规范） |
| 导出 | MediaStore（Scoped Storage），Bitmap.compress，可选择自定义目录（SAF） |
| 内存安全 | 显式 recycle()，缩略图缓存，Dispatchers.IO |
| 构建 | Gradle Kotlin DSL，版本目录 |
| CI | GitHub Actions |
| 最低 SDK | 26（Android 8.0） |
| 目标 SDK | 35 |
# 调试包
./gradlew assembleDebug
# 单元测试
./gradlew test
# 发布包
./gradlew assembleRelease本项目基于 MIT License 开源。
Freeze Every Frame You Love
Video frame capture for Android
Extract precise frames from any video with HDR awareness, motion photo export, and full EXIF preservation. Quick‑access toggles and a settings sheet let you choose format, quality, export folder, filename template and audio muting.
- Frame-Accurate Seeking & Capture — Always uses
MediaMetadataRetriever.OPTION_CLOSEST; never falls back to keyframe seeking - Static & Motion Photo Export — JPEG, PNG, WebP; motion photo follows Google MicroVideo spec
- Mute Audio Option — omit audio when exporting motion photos
- HDR & Dolby Vision Aware — Detects HDR10, HDR10+, HLG, Dolby Vision; tone-maps HDR frames to sRGB so exports look correct
- Quick‑Access Controls — bottom toolbar lets you toggle mute, motion‑photo mode, metadata preservation and tap to cycle formats
- Custom File Names & Export Locations — presets, manual input with length validation, root folders or SAF-picked custom directory
- Lossless Metadata Preservation — full EXIF from source video written to exported image
- Quality & Resolution Controls — 100% default, adjustable quality and optional max resolution with bounds checks
- Memory-Optimized for 4K Videos — explicit
recycle(), thumbnail caching, heavy work runs onDispatchers.IOto prevent memory issues - Lazy Thumbnail Timeline —
LazyRow‑based strip with on-demand 120px thumbnails and live position indicator - Material 3 UI — Dynamic Color (Android 12+), custom playback controls,
ModalBottomSheetexport settings - Scoped Storage & SAF — strict
MediaStoreAPI; gallery refreshes immediately after export
|
|
|
| Start clean Open a video and jump straight into frame-accurate capture. |
Capture view Timeline thumbnails and playback stay in sync for precise frame picking. |
Export sheet Format, quality, HDR, metadata, and motion-photo options live in one place. |
| Layer | Technology |
|---|---|
| Language | Kotlin 2.0 |
| UI | Jetpack Compose + Material 3 (Dynamic Color) |
| Video Playback | Media3 / ExoPlayer |
| Frame Extraction | MediaMetadataRetriever (OPTION_CLOSEST always) |
| Thumbnail Timeline | getScaledFrameAtTime + LazyRow |
| Color Space | MediaExtractor → MediaFormat color-transfer / color-standard |
| Tone Mapping | HdrToneMapper (HDR sources are tone-mapped to sRGB) |
| Metadata | ExifInterface (AndroidX) + MediaMetadataRetriever |
| Motion Photo | MediaMuxer clip extraction + XMP injection (Google MicroVideo spec) |
| Export | MediaStore (scoped storage), Bitmap.compress, optional custom folder (SAF) |
| Memory Safety | explicit recycle(), thumbnail caching, Dispatchers.IO |
| Build | Gradle Kotlin DSL, Version Catalog |
| CI | GitHub Actions |
| Min SDK | 26 (Android 8.0) |
| Target SDK | 35 |
./gradlew assembleDebug # Debug APK
./gradlew test # Unit tests
./gradlew assembleRelease # Release APKMIT License.