{"id":30604189,"url":"https://github.com/takunagai/sonicbloom","last_synced_at":"2025-08-30T01:34:53.070Z","repository":{"id":310278280,"uuid":"1039308768","full_name":"takunagai/sonicbloom","owner":"takunagai","description":"インタラクティブデジタルアート作品。ペンタトニックスケールと黄金比に基づく音響理論と物理演算パーティクルシステムが融合し、マウス＆クリック操作でリアルタイムに美しい視覚・聴覚体験を創出します。","archived":false,"fork":false,"pushed_at":"2025-08-17T00:45:15.000Z","size":118,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-17T01:13:03.066Z","etag":null,"topics":["interactive-a","interactive-animation","p3","vibe-coding"],"latest_commit_sha":null,"homepage":"https://sonicbloom.autumn-wave-9579.workers.dev","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/takunagai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-16T23:43:32.000Z","updated_at":"2025-08-17T00:45:19.000Z","dependencies_parsed_at":"2025-08-17T01:13:04.798Z","dependency_job_id":"8e6721e4-6702-40b0-930e-387d61051acb","html_url":"https://github.com/takunagai/sonicbloom","commit_stats":null,"previous_names":["takunagai/sonicbloom"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/takunagai/sonicbloom","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takunagai%2Fsonicbloom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takunagai%2Fsonicbloom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takunagai%2Fsonicbloom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takunagai%2Fsonicbloom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/takunagai","download_url":"https://codeload.github.com/takunagai/sonicbloom/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/takunagai%2Fsonicbloom/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272792664,"owners_count":24993827,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-29T02:00:10.610Z","response_time":87,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["interactive-a","interactive-animation","p3","vibe-coding"],"created_at":"2025-08-30T01:34:51.391Z","updated_at":"2025-08-30T01:34:53.058Z","avatar_url":"https://github.com/takunagai.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌸 SonicBloom\n\n\u003cdiv align=\"center\"\u003e\n\n**音と映像が織りなす美しい調和のインタラクティブアート体験**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![p5.js](https://img.shields.io/badge/p5.js-1.9.0-ED225D)](https://p5js.org/)\n[![Web Audio API](https://img.shields.io/badge/Web%20Audio%20API-Supported-blue)](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API)\n\n### 🎮 [今すぐプレイ](https://sonicbloom.autumn-wave-9579.workers.dev) \n\n*音楽理論とビジュアルアートが融合した、感情に響く体験型デジタルアート*\n\n\u003c/div\u003e\n\n---\n\n## 📖 概要\n\nSonicBloomは、p5.jsとWeb Audio APIを活用して作られた、音と映像が調和したインタラクティブアート作品です。ペンタトニックスケールと黄金比に基づく音響理論と、物理演算によるパーティクルシステムが組み合わさり、ユーザーの操作に応じて美しい視覚・聴覚体験を生み出します。\n\n### 🎯 プロジェクトの特徴\n\n- **🎵 音楽理論に基づく音響システム**: ペンタトニックスケール、黄金比、倍音構造による調和の取れたサウンド\n- **⚡ リアルタイム物理演算**: 高度なパーティクルシステムによる自然な動きと相互作用\n- **🖱️ 直感的インタラクション**: マウス操作による即座の視覚・聴覚フィードバック\n- **🎨 動的ビジュアルエフェクト**: 5種類の異なるエフェクトモードと3秒間のドラッグトレイル\n- **🚀 最適化されたパフォーマンス**: オブジェクトプールとメモリ管理による滑らかな体験\n- **🔧 設定駆動アーキテクチャ**: カスタマイズ可能な全パラメータと統一されたエラーハンドリング\n\n---\n\n## 🎮 操作方法\n\n### 🖱️ 基本操作\n\n| 操作 | 効果 | 説明 |\n|------|------|------|\n| **初回クリック** | 🔊 サウンドシステム開始 | Web Audio APIの制限により、最初のクリックで音声を有効化 |\n| **クリック** | 💥 爆発エフェクト | クリック位置を中心とした爆発的パーティクル生成 |\n| **ドラッグ** | 🌊 パーティクル操作 | マウス軌跡に沿ってパーティクルが引き寄せられ、3秒間の美しい軌跡を表示 |\n| **Space** | ⏸️ 一時停止/再開 | アニメーションの停止・再開 |\n| **R** | 🔄 リセット | 全パーティクルとエフェクトをリセット |\n| **M** | 🔇/🔊 ミュート | サウンドシステムのオン/オフ |\n| **D** | 📊 デバッグ情報 | パフォーマンス統計とシステム情報の表示 |\n\n### 💡 遊び方のコツ\n\n- **同時爆発を楽しむ**: Spaceキーで一時停止中に複数箇所をクリックしてパーティクルをセット → 再開すると一斉に爆発！\n- **パーティクル誘導**: ドラッグでパーティクルを引き寄せて誘導。素早くドラッグすると、より強力に引き寄せられます！\n\n### 🎨 エフェクトモード\n\n| キー | モード | 視覚効果 | 音響効果 | 特徴 |\n|------|--------|----------|----------|------|\n| **1** | 🎆 爆発 | 放射状拡散、リバーブ効果 | 低音衝撃 + 高音煌めき | バランスの取れた基本モード |\n| **2** | 🌈 トレイル | 軌跡表示、ディレイエコー | ペンタトニック旋律 | 美しい軌跡と余韻のあるサウンド |\n| **3** | 🌙 虹色パルス | 色相変化、倍音フィルター | ハーモニック和音 | 色彩豊かな視覚と豊かな音響 |\n| **4** | 🌍 重力 | 重力シミュレーション | ピッチベンド | 物理的リアリティのある動き |\n| **5** | 🌀 渦巻き | 回転運動、LFO変調 | 空間的パンニング | 動的で立体的な体験 |\n\n### 🎵 サウンドシステム\n\n#### 音響理論に基づく設計\n- **基準周波数**: 432Hz（調和の取れた自然周波数）\n- **スケール**: ペンタトニック（C-D-E-G-A）による癒しの音階\n- **倍音構造**: 黄金比（1.618）に基づく美しい音色\n- **空間音響**: ステレオパンニングによる立体音場\n\n#### インタラクティブサウンド\n- **位置連動**: マウス位置に応じた音程とパンニング\n- **速度感応**: ドラッグ速度による音量とエフェクト強度\n- **アンビエント**: 70BPMの心拍リズムによる安らぎ\n- **リアルタイム合成**: 全サウンドがリアルタイム生成\n\n---\n\n## 🚀 ローカル開発\n\n### 📥 セットアップ\n\n```bash\n# 1. リポジトリをクローン\ngit clone https://github.com/takunagai/sonicbloom.git\ncd sonicbloom\n\n# 2. 依存関係をインストール\nnpm install\n\n# 3. 開発サーバーを起動\nnpm run dev     # http://localhost:8000\n```\n\n**注意**: p5.soundライブラリのCORS制限により、ローカルHTTPサーバーでの実行が必須です。\n\n---\n\n## 🛠️ 開発者向け情報\n\n### 🏗️ 技術スタック\n\n- **p5.js 1.9.0** \u0026 **p5.sound**: クリエイティブコーディングフレームワーク（CDN経由）\n- **Web Audio API**: リアルタイム音声処理\n- **Vanilla JavaScript**: ES6+ モジュラー設計\n- **http-server**: 軽量Node.js HTTPサーバー\n\n### 📁 主要ファイル\n\n- `sketch.js` - p5.jsメインループ\n- `config.js` - 設定値一元管理\n- `soundSystem.js` - 音響システム（Web Audio API）\n- `particleSystem.js` - パーティクル管理システム\n- `dragTrail.js` - ドラッグ軌跡管理\n\n### ⚙️ カスタマイズ\n\n`config.js` で各種パラメータを調整可能：\n\n```javascript\nConfig.PARTICLES.MAX_COUNT = 2000;           // 最大パーティクル数\nConfig.CANVAS.TARGET_FPS = 120;              // 目標フレームレート\nConfig.SOUND.DEFAULT_MASTER_VOLUME = 0.8;    // 音量設定\n```\n\n詳細な開発ガイドラインは [CLAUDE.md](CLAUDE.md) を参照してください。\n\n---\n\n## 🔧 トラブルシューティング\n\n- **音が出ない**: 最初にクリックして音声を初期化してください（Web Audio API制限）\n- **動作が重い**: Dキーでデバッグ情報を表示し、パーティクル数を確認（1000個以下推奨）\n- **CORSエラー**: `file://`ではなくHTTPサーバー経由でアクセス（`npm run dev`）\n\n---\n\n## 🤝 コントリビューション\n\nIssue報告やPull Requestを歓迎します。詳細な開発ガイドラインは [CLAUDE.md](CLAUDE.md) を参照してください。\n\n---\n\n## 📄 ライセンス\n\nこのプロジェクトは **MIT License** の下で公開されています。\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**✨ 美しい音と映像の調和をお楽しみください ✨**\n\n*SonicBloom - Where Sound Meets Art*\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftakunagai%2Fsonicbloom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftakunagai%2Fsonicbloom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftakunagai%2Fsonicbloom/lists"}