Skip to content
yf-officialPublic

About

A native macOS app for extracting audio from video files locally.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

VidAudio

A small, native macOS app that extracts audio from video files locally.

English · 简体中文

English

VidAudio turns MP4, MOV, and M4V videos into MP3, M4A, WAV, or AIFF audio. Drop in one or more files, choose an output format and folder, then let the queue run. All media processing stays on your Mac.

Preview

VidAudio ready for videos in Dark appearance VidAudio extracting audio in Light appearance

Highlights

  • Native SwiftUI interface for macOS 14 and later
  • MP3, M4A, WAV, and AIFF output
  • Sequential batch processing with item and overall progress
  • Audio-track validation before export
  • Collision-safe filenames that never overwrite existing files
  • Open results directly or reveal them in Finder
  • English and Simplified Chinese interface
  • System, Light, and Dark appearance modes
  • App Sandbox and security-scoped output-folder access
  • No cloud uploads, accounts, telemetry, or network dependency

Download

Get the latest universal build for Apple silicon and Intel Macs from GitHub Releases.

Download the ZIP, extract it, and move VidAudio.app to Applications. The current public build is ad-hoc signed. Because it is not Apple-notarized, macOS may show a Gatekeeper warning on first launch.

Build from source

Requirements: macOS 14 or later and a current Xcode version.

xcodebuild -project VidAudio.xcodeproj \
  -scheme VidAudio \
  -configuration Debug \
  -derivedDataPath build/DerivedData \
  build

Run tests:

xcodebuild -project VidAudio.xcodeproj \
  -scheme VidAudio \
  -configuration Debug \
  -derivedDataPath build/DerivedData \
  test

Create a universal release package:

./Scripts/package-release.sh

The script places VidAudio.app and VidAudio-1.0.0-macOS-universal.zip in dist/. Build caches and release artifacts are intentionally excluded from Git; the ZIP is distributed through GitHub Releases.

Privacy

VidAudio works entirely offline. It does not upload your media, require an account, collect analytics, or make network requests. App Sandbox limits file access to videos and folders you explicitly select.

Formats and implementation

Input support includes MP4, MOV, and M4V, subject to codecs supported by macOS AVFoundation. M4A, WAV, and AIFF use Apple media frameworks. MP3 encoding uses the vendored LAME 3.100 Swift package, whose LGPL-3.0 license is retained with the source and included in the app bundle.

Current scope

  • Full-track extraction only; trimming and advanced encoding controls are not included.
  • A damaged file or unsupported codec is reported as failed without stopping the remaining queue.

简体中文

VidAudio 是一款轻量、原生、完全本地运行的 macOS 视频音频提取工具。拖入一个或多个 MP4、MOV、M4V 视频,选择输出格式与保存目录,即可导出 MP3、M4A、WAV 或 AIFF。

主要功能

  • 原生 SwiftUI 界面,支持 macOS 14 或更高版本
  • 导出 MP3、M4A、WAV、AIFF
  • 多文件顺序处理,显示单项与总体进度
  • 导出前验证音频轨道
  • 自动避让同名文件,不覆盖已有内容
  • 直接打开结果或在 Finder 中显示
  • English 与简体中文即时切换
  • 跟随系统、浅色、深色外观
  • App Sandbox 与安全作用域输出目录权限
  • 不上传云端、不需要账号、不收集分析数据、不依赖网络

下载

请前往 GitHub Releases 下载同时支持 Apple 芯片与 Intel Mac 的最新版本。

下载 ZIP 并解压,然后将 VidAudio.app 移入“应用程序”文件夹。当前公开版本使用 ad-hoc 签名;由于尚未经过 Apple 公证,macOS 首次启动时可能显示 Gatekeeper 提示。

从源码构建

环境要求:macOS 14 或更高版本,以及当前版本的 Xcode。

xcodebuild -project VidAudio.xcodeproj \
  -scheme VidAudio \
  -configuration Debug \
  -derivedDataPath build/DerivedData \
  build

运行测试:

xcodebuild -project VidAudio.xcodeproj \
  -scheme VidAudio \
  -configuration Debug \
  -derivedDataPath build/DerivedData \
  test

生成通用 Release 安装包:

./Scripts/package-release.sh

脚本会在 dist/ 生成 VidAudio.app 和 VidAudio-1.0.0-macOS-universal.zip。构建缓存与发布产物不会提交到 Git;ZIP 通过 GitHub Releases 分发。

隐私

VidAudio 完全离线运行,不上传媒体、不要求账号、不收集分析数据,也不会发起网络请求。App Sandbox 将文件访问限制在你明确选择的视频和目录内。

格式与实现

输入支持 MP4、MOV、M4V,实际编解码能力取决于 macOS AVFoundation。M4A、WAV、AIFF 使用 Apple 媒体框架;MP3 使用项目内置的 LAME 3.100 Swift Package,其 LGPL-3.0 许可证随源码保留并包含在应用包中。

当前范围

  • 仅支持完整音轨提取,暂不包含裁剪与高级编码参数。
  • 损坏文件或系统不支持的编解码格式会被标记为失败,不影响队列中的其他文件。

About

A native macOS app for extracting audio from video files locally.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages