～ Mix Tracks, Unleash Fun ～

[🌐 Website] • [🐱 GitHub] [🐦 Twitter] • [🍀 Official Blog]

[!IMPORTANT] このリポジトリのリリースノートやREADME、コミットメッセージの9割近くはclaude.aiやChatGPT4を活用したAIRA, SourceSage, Gaiah, HarmonAI_IIで生成しています。

CatDJ

🌟 Introduction

CatDJは、複数の音楽トラックをDJスタイルで結合し、その音楽に合わせて指定した動画をループ再生するためのパッケージです。このツールを使用することで、オリジナルのパーティー体験を簡単に作成することができます。音楽と映像を組み合わせて、魅力的でエネルギッシュなパフォーマンスを実現しましょう。

🎥 Demo

https://github.com/user-attachments/assets/01959d8c-951e-4da4-90b4-801539a08985

🚀 Getting Started

このリポジトリを使い始めるには、以下の手順を守ってください：

1. CatDJをインストールします：

pip install cat-dj

2. 必要な入力ファイルを準備します：

   • 音楽トラックを input_tracks ディレクトリに配置します
   • ループさせたい動画ファイル（例：cat_is_playing_dj2.mp4）を用意します

3. 以下のコマンドを実行してCatDJを起動します：

cat-dj --input-dir input_tracks --input-video cat_is_playing_dj2.mp4 --track-duration 25000

🛠 Options

• --input-dir: 音楽ファイルが入っているディレクトリ（必須）
• --output-dir: 出力ファイルを保存するディレクトリ（デフォルト: output）
• --input-video: 入力ビデオファイル（必須）
• --track-duration: 各トラックの長さ（ミリ秒）。-1で元の長さを維持（デフォルト: -1）
• --crossfade-duration: クロスフェードの長さ（ミリ秒）（デフォルト: 4000）

📝 Updates

最新のアップデートや新機能は、リリースノートで確認できます。定期的に更新をチェックして、新機能をお楽しみください。

📄 License

このプロジェクトはMITライセンスの下で公開されています。詳細についてはLICENSEを参照してください。

🙏 Acknowledgements

このプロジェクトは、オープンソースコミュニティからの多くのインスピレーションとサポートによって作成されました。特に、音楽や映像処理に関する文献やライブラリに感謝します。

🤝 Contributing

プロジェクトへの貢献を歓迎します！バグ報告、機能リクエスト、プルリクエストなど、どんな形での貢献も大歓迎です。

📬 Contact

質問や提案がある場合は、Issuesセクションでお気軽にお問い合わせください。