Skip to content

Repository files navigation

hodomia

曲の拍、構成、歌詞、コード、音高を同じ時間軸で確認・修正できるローカル音楽解析アプリです。MP3 / MP4 / M4A / WAV / FLACに対応し、1曲15分まで扱えます。MP4は最初の音声トラックを使います。

初回セットアップ後の解析はローカルで実行します。自動推定には誤りや未確定の情報が含まれるため、試聴して確認・修正してください。

ダウンロード

最新版のダウンロード(GitHub Releases)から、使うOSのファイルを選んでください。

音源解析はWindows x64版とApple Silicon搭載Mac向けです。Intel MacとLinux x64版は実験的なUIビルドで、音源解析は利用できません。配布形式や署名の状態はリリースに記載しています。

はじめる

セットアップをコーディングエージェントに依頼する場合は、このリポジトリを開いて次のプロンプトを渡してください。初回は依存パッケージとモデルをダウンロードするため、ネット接続と数十GBの空き容量が必要です。

hodomiaをこの環境で使えるようにセットアップし、デスクトップアプリを起動してください。

AGENTS.mdとdocs/development.mdを読み、必要な同梱スキルを使って進めてください。
まず環境を診断し、不足する依存関係と解析モデルを準備してください。
実際のTauriアプリが起動するところまで確認し、残った問題があれば報告してください。

エージェントから操作する

GUIに加えて、CLIとMCPで保存曲の取得、解析、区間の確認・修正、音声クリップの切り出し、JSON/CSV/SRTの書き出しを操作できます。初回セットアップを済ませてから、音源のパスを書き換えて依頼してください。

docs/automation.mdを読み、hodomiaのCLIで次の曲を解析してください。

音源:<音源ファイルの絶対パス>
解析モード:日本語歌唱・精度優先

この音源があるフォルダーを許可して取り込み、解析完了までジョブの状態を確認してください。
完了したら、BPM、曲構成、歌詞の推定結果を要約し、プロジェクトの保存先を教えてください。
未確定の時刻や未確認の推定はそのまま区別し、音源や歌詞を外部へ送信しないでください。

MCP対応クライアントへ接続するときは、次のように依頼できます。

docs/automation.mdに従って、この環境のhodomia用MCP接続設定を生成してください。
使用するクライアント:<クライアント名>
操作を許可するフォルダー:<フォルダーの絶対パス>

接続後に保存した曲の一覧を取得できることを確認してください。

画面

公開用デモデータをブラウザーハーネスで表示した画面です。実曲の解析結果ではありません。ライトモードと画面の説明も掲載しています。

ダークモードの解析画面

変更を依頼する

hodomiaに次の変更を加えてください。

変更内容:<実現したい動作や修正したい問題>

AGENTS.md、.clean/architecture.md、docs/development.mdを読み、同梱スキルに従って実装してください。
変更に必要な検証とプロジェクト指定のチェックを実行し、変更点と結果を報告してください。

ドキュメント

About

No description, website, or topics provided.

Resources

Stars

18 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages