【完全攻略】Audacity 4.0.0 Windowsビルド手順｜768kHz ASIO対応のコード修正まで解説

次世代オーディオエディタ Audacity 4.0.0 (Muse Framework) を Windows 11 環境にて Visual Studio 2022 と Qt 6 を使ってソースコードからコンパイルし、正常起動させるまでの全手順をまとめました。

ASIO SDKのライセンスの関係で、Ver 3.X.X はASIO対応のためには自前でビルドする必要がありました。ASIO SDKの開発元Steinbergが「GPLv3」でも利用できるようにライセンスを拡張したため、Ver 4.0.0からWindows版の公式ビルドでASIOがサポートされました。したがって、Audacityを自前でビルドする必要性はあまりないかもしれませんが、備忘録を兼ねてブログにまとめました。
また、サンプリング周波数の上限を768kHzまで拡張するためのコード修正とビルド方法を最後にご紹介します。

Audacity 4.0 はアーキテクチャが大幅に刷新されており、ビルド時にハマりやすいポイント（パスの長さ制限、Qt の依存モジュール不足、書き込み権限エラーなど）がいくつか存在します。本記事ではそれらの回避策も含めて詳しく解説します。

Audacityの以前のバージョン(3.7.X)のビルドについては以下の記事をご覧ください。

カスタム化したPortAudioに対応したAudacityのビルド方法

ASIO対応Audacityのビルド方法とその際にPortAudioをカスタム化する方法をご紹介します。

binaural.jp

2025.06.25

1. 準備と動作環境

Audacityのソースコードについては以下をご参照ください。

GitHub - audacity/audacity: Audio Editor

Audio Editor . Contribute to audacity/audacity development by creating an account on GitHub.

github.com

ASIO SDKについては以下をご参照ください。

About ASIO (Open Source license variant)

Steinberg ASIO technology is available in open source form under a GNU General Public License, version GPLv3.

www.steinberg.net

Qtについての詳細は、Qt公式サイト をご参照ください。

Qt | ソフトウェア開発ライフサイクルの各ステージに対応するフレームワーク

Qtのツール群は、企画・設計・開発・テスト・展開まで、ソフトウェア開発ライフサイクル全体をサポート。クロスプラットフォームアプリケーションや組み込み機器の開発に必要な機能を網羅し、将来的な変更にも柔軟に対応。

www.qt.io

以下の環境でビルドしています。

• OS: Windows 10 / 11 (64-bit)
• IDE: Visual Studio 2022 (C++ によるデスクトップ開発 ワークロード)
• Build Tool: CMake 3.21 以上 (cmake-gui を使用)
• Framework: Qt 6.11.2 (MSVC 2022 64-bit コンパイラ用)
• VCS: Git (Git Bash 環境推奨)

2. Step 1: 最重要！パスの長さ制限 (MAX_PATH = 260文字) の考慮

Windows 環境で C++ / Qt6 (QML) のプロジェクトをビルドする際、一番最初に対処すべきが 260文字のパス長制限 (MAX_PATH) です。

ビルド時に自動生成される中間ファイル（.tlog や _autogen など）のパスが非常に長いため、ソースフォルダやビルドフォルダが深い位置にあると MSB3491 や MSB8066 といった MSBuild エラーが発生してコンパイルが失敗します。

【解決策】
ドライブ直下の最も浅い階層にフォルダを作成して配置します。

• ソース配置ディレクトリ: C:\tmp\audacity-4.0.0
• ビルド出力先 (Where to build): C:\b
• インストール配備先 (CMAKE_INSTALL_PREFIX): C:\b\i

3. Step 2: Qt 6 のインストールと必須モジュールの選択

Audacity 4.0 のビルドには Qt 6 (6.8 以降) が必須です。

① インストーラーのダウンロードとログイン

1. Qt Official Downloads から Qt Online Installer（qt-online-installer-windows-x64-4.11.0.exe）をダウンロードして実行します。
2. Qt アカウント（無料コミュニティ版 / オープンソース利用） でログインします（※会社のアドレスでも登録・利用可能です）。

② 必須コンポーネントの選択

Qt MaintenanceTool や Installer のコンポーネント選択画面で、以下を選択してインストールします：

• Qt 6.11.2（6.11.2 をインストールしました）
• MSVC 2022 64-bit (★必須。mingw_64 だけでは VS2022 でビルド不可)
• Qt 5 Compatibility Module (Core5Compat)
• Qt Network Authorization (NetworkAuth)
• Qt Image Formats / Qt Shader Tools / Qt SVG

※ご自身がインストールしたQtのバージョン（例: 6.8.2等）に読み替えてください

4. Step 3: Git リポジトリのクローン

Audacity 4.0 は Git サブモジュールを大量に使用しています。GitHub の ZIP ダウンロードでは muse フレームワーク等のコードが含まれずビルドエラーになるため、必ず git clone --recursive を使用してください。

Git Bash で以下を実行します：

# パスを浅くするため C:\tmp を作成してクローン
cd /c/tmp
# 1. タグ/ブランチを指定してサブモジュールごとクローン
git clone --recursive -b Audacity-4.0.0 https://github.com/audacity/audacity.git audacity-4.0.0
# 2. クローンしたディレクトリに移動
cd audacity-4.0.0
# 3. 念のためサブモジュールの同期を確認
git submodule update --init --recursive

# パスを浅くするため C:\tmp を作成してクローン
cd /c/tmp
# 1. タグ/ブランチを指定してサブモジュールごとクローン
git clone --recursive -b Audacity-4.0.0 https://github.com/audacity/audacity.git audacity-4.0.0
# 2. クローンしたディレクトリに移動
cd audacity-4.0.0
# 3. 念のためサブモジュールの同期を確認
git submodule update --init --recursive

5. Step 4: cmake-gui の設定と Configure / Generate

cmake-gui を起動し、パラメータを設定します。

① ディレクトリパスの設定

• Where is the source code: C:/tmp/audacity-4.0.0
• Where to build the binaries: C:/b

② エントリーの追加 ([Add Entry])

画面右上の [Add Entry] ボタンから、以下の変数を登録・更新します。

※CMAKE_PREFIX_PATHは、ご自身がインストールしたQtのバージョン（例: 6.8.2等）に読み替えてください

💡 ハマりポイント回避策 (CMAKE_INSTALL_PREFIX)
デフォルト値の C:\Program Files (x86)\audacity のままだと、Visual Studio 側で書き込み権限エラー (Access Denied) になったり 32-bit パスとして誤認識されたりします。必ず書き込み権限のあるローカルパス（C:/b/i）に変更してください。

③ Configure & Generate

1. [Configure] ボタンを押します（Generator: Visual Studio 17 2022, Platform: x64 を選択）。
2. Configuring done と表示されたら、[Generate] ボタンを押します (Generating done)。
3. [Open Project] ボタンを押して Visual Studio 2022 を起動します。

6. Step 5: Visual Studio 2022 でのビルドと INSTALL 配備

① ビルド構成の確認

Visual Studio 上部のツールバーで以下を設定します：

• 構成: Release
• プラットフォーム: x64

② INSTALL ターゲットのビルド (最重要ステップ)

単に Audacity プロジェクトだけをビルドした場合、C:\b\bin\Release に Audacity4.exe 本体のみが生成されますが、これだけでは Qt6 の DLL やアセット類が不足しているため起動できません。

1. ソリューションエクスプローラーから INSTALL プロジェクト（CMakePredefinedTargets 配下）を探します。
2. INSTALL プロジェクトを右クリックして [ビルド] を実行します。

INSTALL が完了すると、C:\b\i\bin に必要ファイル群（Audacity4.exe、Qt6*.dll、プラットフォームプラグイン等）が全自動で転送・集約されます。

7. Step 6: 動作確認とポータブル化

① 動作確認

1. ソリューションエクスプローラーで Audacity プロジェクトを右クリックし、「スタートアップ プロジェクトに設定」を選択します。
2. Ctrl + F5（デバッグなしで開始）を押すと、Audacity 4.0.0 が正常に起動します。

② 生成ディレクトリの構成解説

💡 フォルダを移動・配布する際の重要な注意点

INSTALL ターゲットで出力された C:\b\i\bin 内を全て別ディレクトリにコピーして起動しても、QML や UI リソースの読み込みに失敗し、スプラッシュ画面で停止してしまう場合があります。

Audacity 4.0 は bin 以外の階層にある QML モジュールやリソース群を参照するため、ポータブル環境を作る際は C:\b\i (インストールディレクトリ全体) を丸ごとコピー し、その中の bin\Audacity4.exe を起動するようにしてください。

8. 768kHz 超ハイレゾ対応のためのソースコード改修

標準の PortAudio および Audacity 4.0.0 (Muse Framework) は、安全策や内部バッファの制約上、サンプリングレートの上限が 384kHz に制限されています。

RME などの 768kHz 対応オーディオインターフェースの性能をフルに引き出すため、PortAudio と Audacity 本体の両層で制限を解除するコード修正を行います。

① PortAudio の上限ガード解除

• 対象ファイル: C:\b_deps\portaudio\work\src\src\pa_front.c
• 修正内容: 1009行目付近にあるサンプリングレートのパラメータ検証処理で、上限値を 384000.0 から 768000.0 へ引き上げます。

【修正前】 // if( (sampleRate < 1000.0) || (sampleRate > 384000.0) )

【修正後】 if( (sampleRate < 1000.0) || (sampleRate > 768000.0) )

② Audacity コアエンジン & UI 制限の解除

1. レート検証リストへの追加

• 対象ファイル: src/audioio/AudioIOBase.cpp
• 修正内容: デバイス初期化時にサポート確認を行う配列 StandardRates[] および RatesToTry[] に 705600, 768000 を追加します。

2. プロジェクト最大サンプリングレートの引き上げ

• 対象ファイル: src/project/projectaudio.cpp
• 修正内容: プロジェクト全体の上限定数を変更します。

【修正前】 // constexpr double maxSampleRate = 384000.0;

【修正後】 constexpr double maxSampleRate = 768000.0;

3. エクスポート設定ドロップダウンの拡張

• 対象ファイル: src/export/exportpreferencesmodel.cpp
• 修正内容: 設定メニューのデフォルトサンプルレートリスト DEFAULT_SAMPLE_RATE_LIST に 705600, 768000 を追加します。

💡 補足（ExportFFmpeg.cpp について）
ExportFFmpeg.cpp 内の AC3Options 等は AC-3 (Dolby Digital) 規格固有の制約（最大 48kHz）を扱うコードのため、修正不要（そのまま）で問題ありません。WAV や FLAC などの一般的なハイレゾ書き出しは上記修正のみで 768kHz に対応します。

9. コード修正後の高速増分ビルド & 配備手順

ソースコード修正後、Audacity 全体を最初から再コンパイルする必要はありません。以下の手順で修正箇所のみを高速に増分ビルドして配備します。

1. PortAudio 単体でのビルド & 配備
   • Visual Studio 2022 で C:\b_deps\portaudio\work\build\portaudio.sln を開きます。
   • 構成を Release / x64 に設定します。
   • pa_front.c を修正後、portaudio プロジェクトを右クリックして [ビルド] します。
   • 続いて INSTALL プロジェクト（CMakePredefinedTargets 配下）を右クリックして [ビルド] を実行し、成果物を Audacity 側のビルドツリーへ書き出します。
2. Audacity 本体への反映と全体配備
   • Visual Studio 2022 で C:\b\audacity.sln を開きます。
   • 構成を Release / x64 に設定します。
   • INSTALL プロジェクトを右クリックして [ビルド] を実行します。
3. 実行ファイルの確認
   • C:\b\i\bin フォルダ内に、768kHz 対応コードが組み込まれた Audacity4.exe と portaudio_x64.dll が配備されます。

⚠️ 注意点（ポータブル化）
C:\b\i\bin 内の EXE 単体だけを別フォルダにコピーして起動すると、QML アセット等のロードに失敗してスプラッシュ画面で停止する場合があります。別場所に移動して実行する際は、C:\b\i (インストールディレクトリ全体) を丸ごとコピー し、その中の bin\Audacity4.exe を起動するようにしてください。

10. 実機検証：RME ADI-2 Pro での 768kHz 再生テスト

ビルド完了後、実際のハイレゾオーディオハードウェアを使用して動作検証を行いました。

• オーディオインターフェース: RME ADI-2 Pro Anniversary Edition (ASIO MADIface ドライバ)
• プロジェクトサンプリングレート: 768,000 Hz (768kHz)
• テスト信号: 768kHz サンプリングレートで生成した 1kHz 正弦波トラック

【検証結果】

Audacity 4.0.0 のオーディオ設定にてホストに「ASIO」、デバイスに「ASIO MADIface」を選択し、768kHz の正弦波トラックを作成して再生を開始。

音切れやクロックの不整合を起こすことなく、768kHz のリアルタイム再生に無事成功しました！
RME 本体側のディスプレイ／コントロールパネルにおいても、即座に 768kHz クロックのストリームとして自動認識・追従されることが確認できました。

11. まとめ

Audacity 4.0.0 (Muse Framework) で 768kHz 超ハイレゾ環境を構築するための重要ポイントは以下の通りです。

1. 260文字制限 (MAX_PATH) 回避: ソースとビルド場所を C:\tmp / C:\b など浅い階層にする。
2. Qt6 依存モジュールの網羅: Core5Compat や NetworkAuth を指定してインストールする。
3. PortAudio & Audacity コアの制限解除: pa_front.c および projectaudio.cpp などのガード条件を 768kHz (768000.0) へ引き上げる。
4. INSTALL ターゲットによる全成果物配備: ビルド後に INSTALL を実行し、C:\b\i 全体を配備・利用する。

標準の DAW ではなかなか味わえない 768kHz / 32-bit float の超高精度オーディオ環境を、手軽にビルドして手に入れることができました。RME デバイスをお持ちの方や、カスタム DAW 開発に興味のある方はぜひチャレンジしてみてください。

ビルドしたEXEの実行結果です。

※ ASIO は Steinberg Media Technologies GmbH の登録商標です。
※ Audacity® は Muse Media 社および Dominic Mazzoni 氏の登録商標です。
※ Visual Studio、Windows は Microsoft Corporation の商標または登録商標です。
※ Qt は The Qt Company Ltd. およびその子会社の登録商標です。