diff --git a/README.ja.md b/README.ja.md index b7acb89..2707cbe 100644 --- a/README.ja.md +++ b/README.ja.md @@ -1,80 +1,70 @@ # MP4Flow -> **MP4 への変換を、とても簡単にする、無料・オープンソースのネイティブ macOS 動画変換アプリ。** +> **動画を MP4 に、とても簡単に。無料・オープンソースのネイティブ macOS 動画変換アプリです。** [![最新リリース](https://img.shields.io/github/v/release/ixiehao/MP4Flow?display_name=tag&sort=semver&label=release)](https://github.com/ixiehao/MP4Flow/releases/latest) [![macOS 13+](https://img.shields.io/badge/macOS-13%2B-000000?logo=apple&logoColor=white)](https://github.com/ixiehao/MP4Flow/releases/latest) [![ライセンス](https://img.shields.io/github/license/ixiehao/MP4Flow)](LICENSE) -[![GitHub stars](https://img.shields.io/github/stars/ixiehao/MP4Flow?style=flat)](https://github.com/ixiehao/MP4Flow/stargazers) -[MP4Flow をダウンロード](https://github.com/ixiehao/MP4Flow/releases/latest) · [公式サイト](https://ixiehao.github.io/MP4Flow/?lang=ja) · [English](README.md) · [简体中文](README.zh-CN.md) · [問題を報告](https://github.com/ixiehao/MP4Flow/issues/new/choose) +[無料でダウンロード](https://github.com/ixiehao/MP4Flow/releases/latest) · [公式サイト](https://ixiehao.github.io/MP4Flow/?lang=ja) · [English](README.md) · [简体中文](README.zh-CN.md) · [ヘルプ](SUPPORT.md) -MP4Flow は、一般的な動画ファイルを再生しやすい MP4 に変換し、すべての処理を **あなたの Mac 上で** 完結させます。複雑なコーデックの用語を、元の画質を保つ、容量を抑える、互換性を優先する、といった分かりやすい選択肢に置き換えました。トリミング、クロップ、回転、結合にも対応しています。アカウント登録も動画のアップロードも不要で、無料で使えます。 - -MP4 変換に加えて、動画の一部を切り出し、画面をクロップし、向きを回転できます。macOS に馴染む、速く、軽く、無料でオープンソースの動画変換ツールを目指しています。 +無料、オープンソース、ローカル処理。**ログイン不要、アップロード不要、難しい設定不要。** 動画を追加し、画質を選ぶだけで Mac 上で変換できます。 ![MP4Flow の機能デモ](docs/assets/mp4flow-demo.gif) -*動画を追加し、必要なら簡単に編集して、Mac 上で変換します。* - -[ダウンロードとインストール](docs/DOWNLOAD.md) · [インストーラをビルド](docs/INSTALLER-BUILD.md) · [メディア回帰テスト](docs/MEDIA-REGRESSION.md) · [リリースチェックリスト](docs/RELEASE-CHECKLIST.md) · [サポート](SUPPORT.md) · [プライバシー](PRIVACY.ja.md) · [セキュリティ](SECURITY.ja.md) +## 3ステップで始める -## ダウンロードとインストール - -1. [GitHub の最新リリース](https://github.com/ixiehao/MP4Flow/releases/latest)を開き、`.dmg` と対応する `.sha256` ファイルをダウンロードします。 -2. DMG を開き、**MP4Flow** を **Applications** にドラッグします。 -3. FFmpeg と ffprobe を一度インストールしてから、アプリ内の **環境チェック** で準備ができていることを確認します。 +1. [最新リリース](https://github.com/ixiehao/MP4Flow/releases/latest)から `.dmg` をダウンロードし、開いて **MP4Flow** を **Applications** にドラッグします。 +2. ローカル依存関係を一度だけインストールします。`ffmpeg` と `ffprobe` の両方が入ります。 ```sh brew install ffmpeg ``` -リリースページとこのリポジトリが公式の配布場所です。開く前にダウンロードを確認したい場合は、[チェックサムの手順](docs/DOWNLOAD.md)を参照してください。 +3. MP4Flow を開き、動画を追加し、**スマート変換（推奨）** のまま **変換を開始** を選びます。 + +ほとんどの場合、これだけで完了です。FFmpeg やハードウェアエンコードの準備を確認したい場合は、アプリ内の **環境チェック** を開きます。 -**対応する Mac：** macOS 13 Ventura 以降、Appleシリコンおよび Intel Mac。ハードウェアアクセラレーションの可否は、Mac と元動画のコーデックにより異なります。 +> macOS 13 Ventura 以降が必要です。Appleシリコンと Intel Mac に対応します。初回起動を macOS に止められた場合は、Control キーを押しながら MP4Flow をクリックして **開く** を選択してください。必要なら短い[ダウンロードとチェックサムの手順](docs/DOWNLOAD.md)も確認できます。 -## MP4Flow でできること +## できること -| やりたいこと | MP4Flow の方法 | +| 機能 | できること | | --- | --- | -| 動画を MP4 に変換 | スマート変換、H.264 互換、HEVC の容量節約、ソフトウェア互換モードを分かりやすく選べます。 | -| できるだけ速く処理 | MP4 を直接再格納できるときは再エンコードしません。対応するトリミングはストリームコピーを使います。 | -| すばやく編集 | 範囲をトリミング、画面をクロップ、90°/180° 回転、または複数の動画を結合してから書き出せます。 | -| 動画を手元に残す | メディア処理はすべて Mac 上で行います。アカウント、分析、動画アップロードサービスはありません。 | +| **スマート変換** | 推奨の初期設定です。MP4Flow が動画に合った実用的な処理方法を選びます。 | +| **高速なローカル処理** | MP4 の直接再格納やストリームコピーによるトリミングが可能な場合、不要な再エンコードを避けます。 | +| **トリミング、クロップ、回転** | 必要な部分だけを残し、画面範囲や向きを整えて書き出せます。 | +| **動画の結合** | 同じ条件のファイルはロスレス結合、異なるファイルは画面を引き伸ばさない互換結合ができます。 | +| **解像度の選択** | 元のサイズを保つか、比率を維持して 1080p、720p、576p、480p を選べます。 | +| **プライバシーを重視** | 動画処理は Mac 上だけで行われます。アカウント、分析、動画アップロードサービスはありません。 | -## 主な特徴 +### 目的に合わせて選ぶ -- **日本語、英語、簡体字中国語の UI** — 初回起動時はシステム言語に従い、アプリ内で切り替えられます。 -- **可能な限り高速** — MP4 の直接再格納とストリームコピーによるトリミングで再エンコードを回避。対応する H.264/HEVC の拡大縮小は Apple VideoToolbox を利用します。 -- **分かりやすい変換方法** — スマート変換、明瞭でコンパクト、元の画質を維持、H.264 互換、容量を抑える HEVC、ソフトウェア互換モードを選べます。 -- **解像度の制御** — 元の寸法を保つか、アスペクト比を維持したまま 1080p、720p、576p、480p に変換できます。拡大はキャンバスを大きくするもので、存在しない細部を復元するものではありません。 -- **実験的なスマート高画質拡大** — Appleシリコンかつ macOS 27 以降では、システムが報告する正確な倍率で VideoToolbox の超解像を利用できます。明示的な選択が必要で、クロップや回転との同時使用にはまだ対応していません。初回利用時にシステムモデルのダウンロードが必要な場合があります。 -- **シンプルな編集** — 範囲のトリミング、ドラッグと数値入力によるクロップ、90° または 180° の回転に対応します。 -- **2つの結合方法** — ストリームが一致する場合はロスレス結合、異なる場合は表示比率を引き伸ばさず、最大の元解像度に合わせた互換結合を使えます。 -- **信頼できるバッチ処理** — 進行状況、失敗項目の再試行、キャンセル、安全な一時出力、既存出力の非上書きを備えます。 -- **プライバシーを重視** — 処理は Mac 上にとどまります。出力ではコンテナメタデータとチャプターをコピーしない設定です。機密情報の編集では、共有前に書き出し結果を確認してください。 +- 多くの機器で再生したい：**H.264** を選びます。 +- 新しい機器向けにファイルを小さくしたい：**HEVC** を選びます。 +- 難しい動画を安定して変換したい：**ソフトウェア互換モード** を選びます。 +- 対応動画を拡大したい：実験的な **スマート高画質拡大** を試します。Appleシリコン、macOS 27 以降、かつ VideoToolbox がその正確な倍率に対応している場合のみ使えます。クロップや回転との同時利用はできず、初回利用時に macOS がシステムモデルをダウンロードすることがあります。 -## 動作環境 +## 知っておくこと -- macOS 13 Ventura 以降 -- [FFmpeg](https://ffmpeg.org/) と `ffprobe` が `/opt/homebrew/bin`、`/usr/local/bin`、`/opt/local/bin`、または `/usr/bin` にインストール済み -- Appleシリコンまたは Intel Mac。ハードウェアアクセラレーションの可否は Mac と元動画のコーデックにより異なります -- **スマート高画質拡大（実験的）**：Appleシリコン、macOS 27 以降、かつ VideoToolbox が対応する元解像度と目標解像度の組み合わせが必要です。システムは初回使用時にモデルをダウンロードすることがあります。モデルは MP4Flow に同梱されず、MP4Flow が動画を開発者や第三者へ送信することもありません。 +- **入力ごとに出力を作成：** 既存ファイルを上書きせず、完了後は Finder で表示できます。 +- **進行状況が分かる：** 素材の検査、直接再格納、ハードウェア/ソフトウェア変換、出力検証を表示します。失敗した項目は再試行できます。 +- **音声、字幕、HDR：** 変換前に複数音声、字幕、HDR を知らせます。既定では最初の映像と音声トラックを出力し、コンテナメタデータとチャプターはコピーしません。機密性のある動画は共有前に書き出し結果を確認してください。 +- **通常の拡大は高画質化ではありません：** 通常の拡大は寸法を変えるだけです。上のスマート高画質拡大は、システム対応時に選べるオプションです。 -Homebrew で FFmpeg をインストールします。 +## よくある質問 -```sh -brew install ffmpeg -``` +### FFmpeg または ffprobe が見つからない + +`brew install ffmpeg` を実行し、**環境チェック** の **再チェック** を選びます。MP4Flow は FFmpeg を同梱または自動ダウンロードしません。 -## 使い方 +### 動画の処理に失敗した -1. MP4Flow を開き、動画ファイルを追加するかキューにドラッグします。 -2. 変換方法、画質/容量、解像度、出力先を選びます。 -3. 必要に応じて、待機中の項目でトリミング、クロップ、回転を行います。 -4. **変換を開始** を選択します。完了したファイルは Finder で表示できます。 +まず **再試行** を選びます。解決しない場合は、**スマート変換** で新しい MP4 を作成し、その新しいファイルで編集または高画質拡大を再試行してください。状態表示は可能な限り失敗した段階を示します。 -結合するには、編集していない待機中のファイルを少なくとも2つ追加し、**結合** を選びます。ストリームのパラメータが異なる場合は、**互換結合** を選択してください。 +### 動画を結合するには？ + +編集していない待機中の動画を少なくとも2つ追加し、**結合** を選びます。コーデック、フレームレート、サイズが異なる場合は **互換結合** を選択してください。 ## ソースからビルド @@ -85,24 +75,13 @@ cd MP4Flow open MP4Flow.app ``` -生成されるアプリにはローカル開発用の ad-hoc 署名が付与されます。配布可能な DMG を作成するには、[インストーラ作成手順](docs/INSTALLER-BUILD.md)を参照してください。 - -## メディア回帰テスト - -FFmpeg をインストールした後、リリース前に合成メディアのテストスイートを実行できます。 - -```sh -./Scripts/run-media-regression.sh -``` - -このスクリプトはプロジェクト専用の小さなテスト素材を作成・削除し、H.264、HEVC、可変フレームレート、縦長動画、音声/字幕のバリエーション、回転、HDR シグナル、特殊な寸法、長時間スケジューリング、特殊なファイル名、破損した入力を確認します。公開リリース前には、[メディア回帰ゲート](docs/MEDIA-REGRESSION.md)にある実機テストも完了してください。 +貢献する場合は、FFmpeg のインストール後に `swift test` と `./Scripts/run-media-regression.sh` を実行してください。開発者向け資料：[貢献方法](CONTRIBUTING.md)、[メディア回帰テスト](docs/MEDIA-REGRESSION.md)、[インストーラ作成](docs/INSTALLER-BUILD.md)、[リリースチェックリスト](docs/RELEASE-CHECKLIST.md)。 -## 依存関係とライセンス +## プライバシー、依存関係、ライセンス -- MP4Flow は Swift、SwiftUI、Apple のシステムフレームワークを使用します。 -- FFmpeg は外部の実行時依存関係です。アプリは FFmpeg を同梱、ダウンロード、またはライセンスするものではありません。ライセンスはインストールするビルドによって決まります。 -- スマート高画質拡大は、現在の Mac と macOS が対応するときに Apple のオンデバイス VideoToolbox フレームワークを使用します。利用可否、対応倍率、モデル配信はオペレーティングシステムによって管理されます。 -- 同梱する Noto Sans SC フォントは [SIL Open Font License 1.1](AppResources/OFL.txt) で提供されています。 -- アプリは、インターフェース用に [Tabler Icons Outline](https://github.com/tabler/tabler-icons) SVG の厳選した一部（v3.49.0）を同梱しています。実行時のネットワーク依存はなく、[MIT License](AppResources/ASSET_NOTICES.md)の下でローカル利用しています。 +- MP4Flow は Swift、SwiftUI、Apple のシステムフレームワークを使用します。[プライバシーポリシー](PRIVACY.ja.md) · [セキュリティポリシー](SECURITY.ja.md) +- FFmpeg は別途インストールするローカル実行時依存関係です。ライセンスは導入したビルドによって決まり、MP4Flow が同梱またはダウンロードすることはありません。 +- スマート高画質拡大は、macOS が提供する場合に Apple のオンデバイス VideoToolbox を使用します。対応倍率とシステムモデルの配信は macOS により管理されます。 +- アプリには [SIL Open Font License 1.1](AppResources/OFL.txt)の Noto Sans SC と、[MIT License](AppResources/ASSET_NOTICES.md)の [Tabler Icons Outline](https://github.com/tabler/tabler-icons) のローカル厳選セット（v3.49.0）が含まれます。 -帰属表示は [NOTICE.ja.md](NOTICE.ja.md)、データの取り扱いは [PRIVACY.ja.md](PRIVACY.ja.md)、プロジェクトのライセンスは [LICENSE](LICENSE) を参照してください。 +帰属表示は [NOTICE.ja.md](NOTICE.ja.md)、プロジェクトのライセンスは [LICENSE](LICENSE) を参照してください。 diff --git a/README.md b/README.md index 7d66c37..e9f04ce 100644 --- a/README.md +++ b/README.md @@ -1,80 +1,70 @@ # MP4Flow -> **A free, open-source, native macOS video converter that makes MP4 simple.** +> **A free, open-source macOS app that turns video into MP4 — seriously simple.** [![Latest release](https://img.shields.io/github/v/release/ixiehao/MP4Flow?display_name=tag&sort=semver&label=release)](https://github.com/ixiehao/MP4Flow/releases/latest) [![macOS 13+](https://img.shields.io/badge/macOS-13%2B-000000?logo=apple&logoColor=white)](https://github.com/ixiehao/MP4Flow/releases/latest) [![License](https://img.shields.io/github/license/ixiehao/MP4Flow)](LICENSE) -[![GitHub stars](https://img.shields.io/github/stars/ixiehao/MP4Flow?style=flat)](https://github.com/ixiehao/MP4Flow/stargazers) -[Download MP4Flow](https://github.com/ixiehao/MP4Flow/releases/latest) · [Website](https://ixiehao.github.io/MP4Flow/) · [日本語](README.ja.md) · [中文说明](README.zh-CN.md) · [Report a problem](https://github.com/ixiehao/MP4Flow/issues/new/choose) +[Download free](https://github.com/ixiehao/MP4Flow/releases/latest) · [Website](https://ixiehao.github.io/MP4Flow/) · [中文](README.zh-CN.md) · [日本語](README.ja.md) · [Get help](SUPPORT.md) -MP4Flow converts common video files to playable MP4 **on your Mac**. It replaces codec jargon with clear choices: keep the original, save space, use a compatible format, trim, crop, rotate, or merge clips. Your videos are never uploaded, no account is required, and the app is free to use. - -Beyond MP4 conversion, use MP4Flow to trim clips, crop the frame, and rotate video. We are building a fast, lightweight, free, and open-source macOS video conversion tool that feels at home on macOS. +Free, open source, and local. **No account, no upload, no codec jargon.** Add a video, choose a quality, and convert it on your Mac. ![MP4Flow feature demo](docs/assets/mp4flow-demo.gif) -*Add a video, make quick edits, and convert it locally.* - -[Download guide](docs/DOWNLOAD.md) · [Build an installer](docs/INSTALLER-BUILD.md) · [Media regression](docs/MEDIA-REGRESSION.md) · [Release checklist](docs/RELEASE-CHECKLIST.md) · [Privacy](PRIVACY.md) · [Security](SECURITY.md) +## Start in 3 steps -## Download and install - -1. Open the [latest GitHub Release](https://github.com/ixiehao/MP4Flow/releases/latest) and download the `.dmg` and its matching `.sha256` file. -2. Open the DMG and drag **MP4Flow** to **Applications**. -3. Install FFmpeg and ffprobe once, then use the in-app **Environment Check** to confirm they are ready: +1. Download the `.dmg` from the [latest release](https://github.com/ixiehao/MP4Flow/releases/latest), open it, and drag **MP4Flow** to **Applications**. +2. Install the one local dependency. It includes both `ffmpeg` and `ffprobe`: ```sh brew install ffmpeg ``` -The release page and this repository are the official download locations. If you need to verify a download before opening it, follow the short [checksum instructions](docs/DOWNLOAD.md#verify-a-download-optional). +3. Open MP4Flow, add videos, keep **Smart Convert (Recommended)** selected, then click **Start Conversion**. + +That is all most people need. Open **Environment Check** in the app if you want to confirm FFmpeg or hardware encoding is ready. -**Compatible Macs:** macOS 13 Ventura or later, on Apple Silicon or Intel. Hardware acceleration depends on the Mac and source codec. +> macOS 13 Ventura or later is required. Apple Silicon and Intel Macs are supported. If macOS blocks the first launch, Control-click MP4Flow and choose **Open**. See the short [download and checksum guide](docs/DOWNLOAD.md) if needed. -## What MP4Flow does +## What you can do -| Need | MP4Flow approach | +| Feature | What it means | | --- | --- | -| Convert a video to MP4 | Clear presets for Smart Convert, H.264 compatibility, HEVC efficiency, or a software fallback. | -| Keep processing fast | Direct MP4 remuxing and stream-copy trimming avoid re-encoding when the source allows it. | -| Make a quick edit | Trim a range, crop the frame, rotate 90°/180°, or merge clips before exporting. | -| Keep videos private | All media processing stays on the Mac. MP4Flow has no account, analytics, or video upload service. | +| **Smart Convert** | The recommended default. MP4Flow chooses the practical route for the file. | +| **Fast local processing** | Uses direct MP4 remuxing or stream-copy trimming when possible, avoiding unnecessary re-encoding. | +| **Trim, crop, rotate** | Keep just the clip you need, adjust the frame, or fix orientation before exporting. | +| **Merge videos** | Use lossless merge for matching files, or compatible merge for different files without stretching the image. | +| **Choose a size** | Keep the original resolution or select 1080p, 720p, 576p, or 480p while preserving the aspect ratio. | +| **Private by default** | Video processing stays on your Mac. MP4Flow has no account, analytics, or video-upload service. | -## Highlights +### Want a different result? -- **English, Japanese, and Simplified Chinese UI** — follows the system language on first launch and can be changed in the app. -- **Fast when possible** — direct MP4 remuxing and stream-copy trimming avoid re-encoding; supported H.264/HEVC scaling uses Apple VideoToolbox. -- **Clear choices** — Smart Convert, Clear and Compact, Preserve Original Quality, device-compatible H.264, smaller HEVC, and a software fallback. -- **Resolution control** — keep original dimensions or convert to 1080p, 720p, 576p, or 480p while preserving aspect ratio. Upscaling enlarges the canvas, not missing detail. -- **Experimental Smart Enhance Upscale** — on Apple Silicon running macOS 27 or later, use VideoToolbox super resolution for the exact scale factors reported by the system. It is intentionally opt-in, supports no crop or rotation yet, and may require a one-time system model download. -- **Simple editing** — trim a time range, crop with draggable handles and numeric fields, and rotate 90° or 180°. -- **Two merge modes** — lossless merging for matching streams; compatible merging normalises clips to the largest source resolution without stretching. -- **Reliable batches** — progress, retry failed items, cancellation, safe temporary outputs, and no overwrite of existing files. -- **Privacy by design** — processing stays on your Mac. Outputs are configured not to copy container metadata or chapters; review exports when sensitive redaction matters. +- Need the widest playback compatibility? Choose **H.264**. +- Want a smaller file on newer devices? Choose **HEVC**. +- Need maximum compatibility after a difficult conversion? Choose the **software** option. +- Need to enlarge a supported video? Try **Smart Enhance Upscale**. It is experimental and available only on Apple Silicon with macOS 27 or later when VideoToolbox supports that exact scale. It does not support crop or rotation at the same time, and macOS may download a system model on first use. -## Requirements +## Good to know -- macOS 13 Ventura or later -- [FFmpeg](https://ffmpeg.org/) and `ffprobe` installed together in `/opt/homebrew/bin`, `/usr/local/bin`, `/opt/local/bin`, or `/usr/bin` -- Apple Silicon or Intel Mac; hardware acceleration depends on the Mac and source codec -- **Smart Enhance Upscale (experimental):** Apple Silicon, macOS 27 or later, and a source/target pair that matches a VideoToolbox-supported scale factor. The system may download its model before the first use. It is not bundled with MP4Flow and does not send your video to MP4Flow or a third-party service. +- **One output per input:** existing files are never overwritten; you can reveal completed files in Finder. +- **Clear progress:** MP4Flow shows inspection, direct remuxing, hardware or software conversion, and final verification. Failed items can be retried. +- **Tracks and metadata:** before converting, the app reports multi-audio, subtitles, and HDR. The default export keeps the first video and audio track and does not copy container metadata or chapters. Check the result before sharing sensitive material. +- **No magic enlargement:** normal upscaling changes dimensions, not missing detail. Smart Enhance is the optional system-assisted exception described above. -Install FFmpeg with Homebrew: +## Common questions -```sh -brew install ffmpeg -``` +### “FFmpeg” or “ffprobe” is missing + +Run `brew install ffmpeg`, then select **Environment Check** → **Check Again**. MP4Flow does not bundle or download FFmpeg for you. -## Use +### A file failed once -1. Open MP4Flow and add video files or drag them into the queue. -2. Choose a conversion mode, quality/size, resolution, and output location. -3. Optionally use Trim, Crop, or Rotate on a waiting item. -4. Select **Start Conversion**. Completed files can be revealed in Finder. +Try **Retry** first. If it still fails, use **Smart Convert** to create a new MP4, add that new file, and try the edit or enhancement again. The status message explains the failed stage when possible. -To merge, add at least two untouched waiting files and select **Merge**. Choose **Compatible Merge** when their stream parameters differ. +### How do I merge clips? + +Add at least two untouched waiting items and choose **Merge**. Use **Compatible Merge** when their codecs, frame rates, or sizes differ. ## Build from source @@ -85,28 +75,13 @@ cd MP4Flow open MP4Flow.app ``` -The generated app is ad-hoc signed for local development. See [docs/INSTALLER-BUILD.md](docs/INSTALLER-BUILD.md) to create a distributable DMG. - -## Media regression - -With FFmpeg installed, run the synthetic media suite before a release: - -```sh -./Scripts/run-media-regression.sh -``` - -It creates and removes tiny project-owned fixtures for H.264, HEVC, VFR, -portrait video, audio/subtitle variants, rotation, HDR signalling, unusual -dimensions, long-duration scheduling, special file names, and corrupt input. -See [the media regression gate](docs/MEDIA-REGRESSION.md) for its limits and -the real-device matrix required for a public release. +For contributors, run `swift test` and `./Scripts/run-media-regression.sh` (with FFmpeg installed) before submitting a change. More details: [contributing](CONTRIBUTING.md), [media regression](docs/MEDIA-REGRESSION.md), [installer build](docs/INSTALLER-BUILD.md), and [release checklist](docs/RELEASE-CHECKLIST.md). -## Dependencies and licensing +## Privacy, dependencies, and license -- MP4Flow uses Swift, SwiftUI, and Apple system frameworks. -- FFmpeg is an external runtime dependency and is not bundled, downloaded, or licensed by the app. Its licence depends on the build you install. -- Smart Enhance Upscale uses Apple's on-device VideoToolbox framework when it is supported by the current Mac and macOS. Its availability, supported factors, and model delivery are controlled by the operating system. -- The bundled Noto Sans SC font is licensed under the [SIL Open Font License 1.1](AppResources/OFL.txt). -- The app bundles a curated subset of [Tabler Icons Outline](https://github.com/tabler/tabler-icons) SVGs (v3.49.0) for its interface. They are used locally, without a runtime network dependency, under the [MIT License](AppResources/ASSET_NOTICES.md). +- MP4Flow uses Swift, SwiftUI, and Apple system frameworks. [Privacy policy](PRIVACY.md) · [Security policy](SECURITY.md) +- FFmpeg is a separately installed local runtime dependency; its licence depends on the build you install. MP4Flow neither bundles nor downloads it. +- Smart Enhance uses Apple’s on-device VideoToolbox capability when macOS makes it available. Its supported factors and system model delivery are controlled by macOS. +- The app includes Noto Sans SC under the [SIL Open Font License 1.1](AppResources/OFL.txt), plus a curated local subset of [Tabler Icons Outline](https://github.com/tabler/tabler-icons) (v3.49.0) under the [MIT License](AppResources/ASSET_NOTICES.md). -See [NOTICE.md](NOTICE.md) for attribution, [PRIVACY.md](PRIVACY.md) for data handling, and [LICENSE](LICENSE) for the project license. +See [NOTICE.md](NOTICE.md) for attribution and [LICENSE](LICENSE) for the project licence. diff --git a/README.zh-CN.md b/README.zh-CN.md index 612b001..2465758 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,80 +1,70 @@ # MP4Flow -> **一款免费、开源、原生的 macOS 视频转 MP4 工具，把转换这件事变得特别简单。** +> **一款免费、开源的原生 macOS 视频转 MP4 工具：把视频变成 MP4，特别简单。** [![最新版本](https://img.shields.io/github/v/release/ixiehao/MP4Flow?display_name=tag&sort=semver&label=release)](https://github.com/ixiehao/MP4Flow/releases/latest) [![macOS 13+](https://img.shields.io/badge/macOS-13%2B-000000?logo=apple&logoColor=white)](https://github.com/ixiehao/MP4Flow/releases/latest) [![许可证](https://img.shields.io/github/license/ixiehao/MP4Flow)](LICENSE) -[![GitHub stars](https://img.shields.io/github/stars/ixiehao/MP4Flow?style=flat)](https://github.com/ixiehao/MP4Flow/stargazers) -[下载 MP4Flow](https://github.com/ixiehao/MP4Flow/releases/latest) · [官方网站](https://ixiehao.github.io/MP4Flow/) · [English](README.md) · [日本語](README.ja.md) · [反馈问题](https://github.com/ixiehao/MP4Flow/issues/new/choose) +[免费下载](https://github.com/ixiehao/MP4Flow/releases/latest) · [官方网站](https://ixiehao.github.io/MP4Flow/) · [English](README.md) · [日本語](README.ja.md) · [获取帮助](SUPPORT.md) -MP4Flow 将常见视频格式转换为易播放的 MP4，所有处理都在 **你的 Mac 本机** 完成。它把复杂的编码参数换成直观选择：保留原画、节省空间、兼容播放、剪辑、裁切、旋转和合并。无需登录、不会上传视频，且完全免费。 - -除了转换为 MP4 格式这一核心功能外，你可以用它把视频剪成片段、裁切视频画面，还可以旋转视频画面。我们努力打造一款在 macOS 上好用、快速、轻量、免费且开源的视频格式转换工具。 +免费、开源、本地处理。**不用登录、不用上传、不用会看参数。** 添加视频，选择画质，在你的 Mac 上完成转换。 ![MP4Flow 功能演示](docs/assets/mp4flow-demo.gif) -*添加视频、快速剪辑、裁切或旋转，然后在本地转换。* - -[下载与安装](docs/DOWNLOAD.md) · [安装包构建](docs/INSTALLER-BUILD.md) · [媒体回归测试](docs/MEDIA-REGRESSION.md) · [发布检查清单](docs/RELEASE-CHECKLIST.md) · [隐私](PRIVACY.md) · [安全](SECURITY.md) +## 三步上手 -## 下载与安装 - -1. 打开 [GitHub 最新版本](https://github.com/ixiehao/MP4Flow/releases/latest)，下载 `.dmg` 和与之对应的 `.sha256` 校验文件。 -2. 打开 DMG，把 **MP4Flow** 拖入 **Applications（应用程序）**。 -3. 首次使用前安装 FFmpeg 与 ffprobe；随后在应用中打开「环境体检」确认状态： +1. 在 [GitHub 最新版本](https://github.com/ixiehao/MP4Flow/releases/latest)下载 `.dmg`，打开后把 **MP4Flow** 拖进 **Applications（应用程序）**。 +2. 安装一次本地依赖；它会同时安装 `ffmpeg` 和 `ffprobe`： ```sh brew install ffmpeg ``` -本仓库和 Release 页面是官方发布渠道。如需在打开前校验下载文件，请查看[校验说明](docs/DOWNLOAD.md#可选校验下载文件)。 +3. 打开 MP4Flow，添加视频，保持「**智能转换（推荐）**」，点击「**开始转换**」。 + +大多数情况下，做到这里就可以了。若想确认 FFmpeg 或硬件编码是否可用，请在应用里打开「环境体检」。 -**兼容设备：**macOS 13 Ventura 或更高版本，支持 Apple 芯片与 Intel Mac。硬件加速是否可用取决于设备和源视频编码。 +> 需要 macOS 13 Ventura 或更高版本，支持 Apple 芯片与 Intel Mac。若 macOS 阻止首次打开，请按住 Control 点按 MP4Flow，选择「打开」。需要时可查看简短的[下载与校验说明](docs/DOWNLOAD.md)。 -## MP4Flow 能做什么 +## 它能做什么 -| 你的需求 | MP4Flow 的方式 | +| 功能 | 你会得到什么 | | --- | --- | -| 将视频转换为 MP4 | 直观选择智能转换、H.264 兼容播放、HEVC 节省空间或软件兼容模式。 | -| 尽可能快速处理 | 能直接封装 MP4 就不重编码；兼容时剪辑可直接复制流。 | -| 快速剪辑视频 | 修剪片段、裁切画面、旋转 90°/180°，或合并视频后再导出。 | -| 让视频留在自己手里 | 媒体处理全部在 Mac 本机完成；没有账户、分析追踪或视频上传服务。 | +| **智能转换** | 推荐的默认选择；MP4Flow 会为当前文件选择合适的处理方式。 | +| **极速本地处理** | 能直接封装 MP4 或直接剪切流时，就不做不必要的重新编码。 | +| **剪切、裁切、旋转** | 截取需要的片段、调整画面范围，或修正视频方向后导出。 | +| **合并视频** | 参数相同可无损合并；参数不同可兼容合并，画面不会被拉伸。 | +| **选择分辨率** | 保持原画，或选 1080P、720P、576P、480P，始终保持宽高比。 | +| **隐私优先** | 视频始终在你的 Mac 上处理；没有账户、分析追踪或视频上传服务。 | -## 功能特点 +### 想要不同效果？ -- **中文、英文、日文界面**：首次启动跟随系统语言，也可在应用顶部手动切换。 -- **能快则快**：可直接封装 MP4；兼容时剪辑不重新编码；符合条件的 H.264/HEVC 缩放使用 Apple VideoToolbox。 -- **好懂的转换选择**：智能转换、清晰又省空间、尽量保留原画、所有设备都能播放、节省更多空间、软件兼容模式。 -- **分辨率控制**：保持原画，或转为 1080P、720P、576P、480P，并保持原视频比例。放大只改变尺寸，不能补回不存在的细节。 -- **实验性智能增强放大**：Apple 芯片且 macOS 27 或更高版本，可使用系统 VideoToolbox 的超分能力。仅在系统报告支持的精确放大倍率下启用，暂不支持同时裁切或旋转；首次使用可能需要系统下载模型。 -- **简单编辑**：可修剪起止时间、拖动裁切框并输入数值、旋转 90° 或 180°。 -- **两种合并方式**：参数一致时无损合并；参数不同可兼容合并，以队列中最大尺寸为准，小画面等比例放大且不拉伸。 -- **稳定批处理**：显示进度、重排失败项、可取消任务、安全临时文件、不会覆盖已有输出。 -- **隐私优先**：所有处理留在本机。输出会被设置为不复制容器元数据和章节；涉及敏感信息时，请在分享前自行检查导出文件。 +- 想让更多设备都能播放：选 **H.264**。 +- 想让新设备上的文件更小：选 **HEVC**。 +- 遇到难处理的视频、优先求稳：选 **软件兼容模式**。 +- 想放大支持的视频：试试「**智能增强放大**」。它是实验性功能，仅在 Apple 芯片、macOS 27 或更高版本且 VideoToolbox 支持该精确倍率时可用；暂不能同时裁切或旋转，首次使用时 macOS 可能下载系统模型。 -## 环境要求 +## 使用前知道这几点 -- macOS 13 Ventura 或更高版本 -- 已在 `/opt/homebrew/bin`、`/usr/local/bin`、`/opt/local/bin` 或 `/usr/bin` 中安装 [FFmpeg](https://ffmpeg.org/) 和 `ffprobe` -- Apple 芯片或 Intel Mac；硬件加速取决于设备与源视频编码 -- **智能增强放大（实验性）**：需要 Apple 芯片、macOS 27 或更高版本，且源尺寸与目标尺寸须匹配 VideoToolbox 支持的放大倍率。系统首次使用时可能下载模型；模型不随 MP4Flow 打包，MP4Flow 也不会将视频上传给开发者或第三方服务。 +- **一条输入，对应一个输出：** 不会覆盖已有文件；完成后可直接在访达中显示。 +- **进度看得懂：** 会显示检测素材、快速直封装、硬件/软件转换和输出校验；失败项可重试。 +- **音轨、字幕与 HDR：** 转换前会提示多音轨、字幕与 HDR。默认输出第一路视频和音频，不复制容器元数据或章节。处理敏感内容后，请在分享前检查导出结果。 +- **普通放大不是“变清晰”：** 普通放大只改变尺寸，不会凭空补细节；系统支持时可尝试上面的智能增强放大。 -通过 Homebrew 安装 FFmpeg： +## 常见问题 -```sh -brew install ffmpeg -``` +### 提示找不到 FFmpeg 或 ffprobe + +运行 `brew install ffmpeg`，再到「环境体检」点「重新检查」。MP4Flow 不会自行打包或下载 FFmpeg。 -## 使用方法 +### 某个视频处理失败了 -1. 打开 MP4Flow，添加视频或直接拖入队列。 -2. 选择转换方式、画质大小、分辨率和输出位置。 -3. 如有需要，在等待中的文件右侧使用剪辑、裁切、旋转。 -4. 点击“开始转换”；完成后可在访达中查看文件。 +先点「重试」。仍失败时，用「智能转换」先生成一个新 MP4，再添加这个新文件重试剪辑或增强操作。状态提示会尽可能说明失败发生在哪一步。 -要合并视频时，添加至少两个未编辑的等待中文件，点击“合并”。如果文件参数不同，选择“兼容合并”。 +### 怎样合并视频？ + +添加至少两个未编辑、处于等待中的视频，点击「合并」。若编码、帧率或尺寸不同，请选「兼容合并」。 ## 从源码构建 @@ -85,24 +75,13 @@ cd MP4Flow open MP4Flow.app ``` -本地构建的应用使用 ad-hoc 签名。制作可发布的 DMG，请查看 [安装包构建说明](docs/INSTALLER-BUILD.md)。 - -## 媒体回归测试 - -安装 FFmpeg 后，发布前可运行合成媒体测试： - -```sh -./Scripts/run-media-regression.sh -``` - -它会临时生成并在结束后删除很小的项目自有测试素材，覆盖 H.264、HEVC、可变帧率、竖屏、音轨/字幕变体、旋转、HDR 标记、异常尺寸、长时长调度、特殊文件名和损坏输入。公开发布前仍须按[媒体回归门槛](docs/MEDIA-REGRESSION.md)完成真机测试。 +贡献代码前，请在安装 FFmpeg 后运行 `swift test` 和 `./Scripts/run-media-regression.sh`。开发资料：[参与贡献](CONTRIBUTING.md)、[媒体回归测试](docs/MEDIA-REGRESSION.md)、[安装包构建](docs/INSTALLER-BUILD.md)、[发布检查清单](docs/RELEASE-CHECKLIST.md)。 -## 依赖与许可 +## 隐私、依赖与许可 -- MP4Flow 使用 Swift、SwiftUI 与 Apple 系统框架开发。 -- FFmpeg 是外部运行时依赖，应用不会打包、下载或为其授权；其许可证取决于你安装的构建版本。 -- 智能增强放大在当前 Mac 与系统支持时调用 Apple VideoToolbox；可用性、支持倍率和模型交付均由操作系统控制。 -- 随应用提供的 Noto Sans SC 字体使用 [SIL Open Font License 1.1](AppResources/OFL.txt)。 -- 应用为界面内置了 [Tabler Icons Outline](https://github.com/tabler/tabler-icons) SVG 的精选子集（v3.49.0）；图标仅在本机使用、没有运行时网络依赖，并遵循 [MIT License](AppResources/ASSET_NOTICES.md)。 +- MP4Flow 使用 Swift、SwiftUI 与 Apple 系统框架开发。[隐私政策](PRIVACY.md) · [安全政策](SECURITY.md) +- FFmpeg 是需单独安装的本地运行时依赖；其许可证取决于你安装的构建。MP4Flow 不会打包或下载它。 +- 智能增强放大在 macOS 支持时调用 Apple 设备端 VideoToolbox；支持倍率和系统模型交付由 macOS 决定。 +- 应用内置 Noto Sans SC，遵循 [SIL Open Font License 1.1](AppResources/OFL.txt)；也内置 [Tabler Icons Outline](https://github.com/tabler/tabler-icons) 的本地精选子集（v3.49.0），遵循 [MIT License](AppResources/ASSET_NOTICES.md)。 -请查看 [NOTICE.md](NOTICE.md)、[PRIVACY.md](PRIVACY.md) 和 [LICENSE](LICENSE)。 +归属信息见 [NOTICE.md](NOTICE.md)，项目许可证见 [LICENSE](LICENSE)。