Skip to content

YoshimiKudo/AutoLooper

Repository files navigation

AutoLooper

Download / ダウンロード

Windows版アプリ本体: AutoLooper.0.2.0.exe

最新版のリリースページ: AutoLooper Releases

Download the latest Windows portable exe from the link above.

日本語

AutoLooper は、ゲーム音楽向けのループマーカー検出・編集デスクトップアプリです。WAV、AIFF、Ogg Vorbis、MP3 ファイルを読み込み、最良のループ候補を自動採用し、波形表示とリストエディタの両方で確認・編集できます。

バージョン情報

  • アプリバージョン: 0.2.0
  • リリースタグ: v0.2.0-beta
  • リリース日: 2026-06-02 JST
  • リリース種別: ベータ / プレリリース
  • 現在の主な対象環境: Windows
  • macOS 対応は将来予定です。

主な機能

  • .wav.aif.aiff.ogg.mp3 の読み込み
  • Ogg は Vorbis を対象
  • MP3 は読み込み、波形表示、自動検出、手動マーカー編集、ループ再生に対応
  • MP3 へのループマーカー埋め込み保存は非対応。保存時に警告を表示
  • 複数ファイルの一括読み込みと一括検出
  • 最良候補を自動採用するループ検出
  • 波形上のループ開始・終了マーカー表示
  • 波形上でループ区間をドラッグして平行移動
  • ループ開始、ループ終了、ループ長の編集
  • サンプル数表示と秒数表示の切り替え
  • リストエディタでのソート、列並び替え、矩形範囲コピー
  • 検出プリセット: High / Mid / Low / Custom
  • カスタム検出プリセットの保存
  • _looped.wav のような別名コピー保存
  • WAV / AIFF / Ogg ファイルへのループメタデータ書き込み

検出設定

  • 照合区間: ループ候補の比較に使う音声区間の長さ
  • 必要一致率: 候補を採用するために必要な最低スコア
  • 最短ループ: これより短い候補を無視する下限
  • ループ確認開始位置: Loop End の何 ms 前から再生確認を始めるか

Custom プリセットは現在の検出設定を保存します。保存値はアプリ内のローカルストレージに保持されます。

再生とループ確認

通常の再生では、ループマーカーがあるトラックの場合、先頭から再生し、Loop End に到達すると Loop Start へ戻って再生を継続します。ループマーカーがないトラックは通常どおり最後まで再生します。

Check Loop は、ループマーカーがあるトラックでのみ有効です。Loop End の指定 ms 前から再生し、Loop End に到達すると Loop Start へ戻って再生を継続します。停止するまでループを繰り返します。

開発用起動

CMD:

cd /d <path-to-AutoLooper>
npm.cmd run dev

PowerShell:

Set-Location "<path-to-AutoLooper>"
npm.cmd run dev

ビルドとテスト

npm.cmd run build
npm.cmd test

exe 生成

unpacked 版:

npm.cmd run dist:dir

portable exe:

npm.cmd run dist

生成物は release フォルダに出力されます。

注意

  • 自動保存は行いません。保存操作を実行したときだけ、ループ付きコピーを書き出します。
  • MP3 はループマーカーのアプリ内利用には対応しますが、MP3ファイル自体への埋め込み保存には対応しません。
  • ループ長などに無効な値を入力すると、トラック状態が警告になり、検証欄に理由が表示されます。
  • 現在の開発・検証環境は Windows です。macOS 対応は将来想定です。

サポートと連絡先

ライセンス

ライセンス方針は未確定です。再利用条件を明確にする必要がある場合は、LICENSE ファイルを追加してください。


English

AutoLooper is a desktop app for detecting and editing loop markers in game music files. It imports WAV, AIFF, Ogg Vorbis, and MP3 files, automatically adopts the best loop candidate, and lets you review and edit loop points in both waveform and list editor views.

Version

  • App version: 0.2.0
  • Release tag: v0.2.0-beta
  • Release date: 2026-06-02 JST
  • Release type: beta / prerelease
  • Primary current target: Windows
  • macOS support is planned for a future release.

Features

  • Import .wav, .aif, .aiff, .ogg, and .mp3 files
  • Ogg support targets Vorbis
  • MP3 supports import, waveform display, automatic detection, manual marker editing, and loop playback
  • MP3 loop marker embedding is not supported. The app shows a warning when saving MP3 tracks
  • Batch import and batch detection
  • Automatic adoption of the best loop candidate
  • Waveform display with loop start and loop end markers
  • Drag-to-shift loop ranges on the waveform
  • Edit loop start, loop end, and loop length
  • Toggle display between samples and time
  • List editor with sorting, column reordering, and rectangular cell copy
  • Detection presets: High / Mid / Low / Custom
  • Saved custom detection preset
  • Save looped copies using names such as _looped.wav
  • Write loop metadata into WAV / AIFF / Ogg files

Detection Settings

  • Match Window: Audio duration used to compare loop candidates
  • Required Match: Minimum score required to accept a candidate
  • Minimum Loop: Shortest allowed loop length
  • Loop Check Preroll: How many ms before Loop End playback starts when checking the loop

The Custom preset saves the current detection settings. Saved values are stored in the app's local storage.

Playback and Loop Check

During normal playback, tracks with loop markers play from the beginning and jump from Loop End back to Loop Start. Tracks without loop markers play through to the end.

Check Loop is enabled only for tracks with loop markers. Playback starts shortly before Loop End, jumps back to Loop Start when it reaches Loop End, and continues looping until stopped.

Development

CMD:

cd /d <path-to-AutoLooper>
npm.cmd run dev

PowerShell:

Set-Location "<path-to-AutoLooper>"
npm.cmd run dev

Build and Test

npm.cmd run build
npm.cmd test

Build Executables

Unpacked app:

npm.cmd run dist:dir

Portable exe:

npm.cmd run dist

Build outputs are written to the release folder.

Notes

  • The app does not autosave. Looped copies are written only when the save action is executed.
  • MP3 markers can be used inside the app, but cannot be embedded back into MP3 files.
  • Invalid loop length input sets the track status to warning and shows the reason in the validation column.
  • macOS support is planned for the future. Current development and verification are on Windows.

Support and Contact

License

The license policy has not been decided yet. Add a LICENSE file before publishing reuse terms.

About

Desktop app for automatic loop marker detection and editing for game music files.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors