1st

README.md

@@ -1,6 +1,6 @@
 ---
 title: BGMixer
-emoji: 🐢
+emoji: 🎵
 colorFrom: green
 colorTo: yellow
 sdk: gradio
@@ -11,3 +11,129 @@ short_description: 幫一段podcast mp3 做背景音樂BGM混音的工具
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+
+# 🎵 BGMixer - Podcast 背景音樂混音工具
+
+BGMixer 是一款簡單易用的 Podcast 背景音樂混音工具，讓你輕鬆將背景音樂 (BGM) 添加到 Podcast，並調整音量、淡入淡出效果，適合 Podcast 製作人或內容創作者。
+
+🚀 **特色功能：**
+- ✅ **Podcast & BGM 上傳**：支援 MP3 格式
+- ✅ **BGM 音量調整**：可調整背景音樂音量（預設 -14 dB）
+- ✅ **BGM 循環播放 (Loop)**：可選是否自動重複 BGM 來符合 Podcast 長度
+- ✅ **淡入淡出 (Fade in/out)**：可選擇是否開啟，並設定秒數（預設 5 秒）
+- ✅ **即時預覽 & 下載**：混音完成後可直接播放 & 下載 MP3
+
+---
+
+## 🛠️ 安裝與執行方式
+
+### **1️⃣ 本機運行**
+
+#### **📌 安裝必要套件**
+```bash
+pip install gradio pydub
+```
+
+#### **📌 執行應用程式**
+```bash
+python app.py
+```
+
+應用程式將會在本機啟動，並提供 Web UI 讓你操作。
+
+---
+
+### **2️⃣ 部署到 Hugging Face Spaces**
+1. 前往 [Hugging Face Spaces](https://huggingface.co/spaces) 建立新空間
+2. 選擇 **Gradio** 作為應用類型
+3. 連結 GitHub Repo 或手動上傳 `app.py`
+4. 在 `requirements.txt` 加入：
+   ```
+   gradio
+   pydub
+   ```
+5. 等待自動部署完成 🎉
+
+---
+
+## 🚀 **使用方式**
+
+1️⃣ **上傳** 你的 Podcast (MP3) 與 BGM (MP3) 🔼
+2️⃣ **設定音量**、是否開啟 **Loop** 與 **淡入淡出**
+3️⃣ 點擊 **開始混音** 🚀
+4️⃣ **播放預覽 & 下載** 你的混音 Podcast 🎧
+
+---
+
+## 🤝 貢獻指南
+歡迎 Pull Requests！請確保：
+- 使用 Python 進行開發
+- 遵循 `pydub` & `gradio` 標準
+- 提交 PR 時附上簡要說明
+
+---
+
+# 🎵 BGMixer - Podcast Background Music Mixer
+
+BGMixer is a simple and user-friendly tool that allows you to mix background music (BGM) into your podcast, adjust volume, apply fade effects, and more. Ideal for podcast creators and content producers.
+
+🚀 **Features:**
+- ✅ **Upload Podcast & BGM** (MP3 support)
+- ✅ **Adjust BGM Volume** (default -14 dB)
+- ✅ **Loop BGM** (optional, automatically repeats BGM to match podcast length)
+- ✅ **Fade In/Out** (optional, customizable duration, default 5 sec)
+- ✅ **Preview & Download** mixed MP3 files
+
+---
+
+## 🛠️ Installation & Usage
+
+### **1️⃣ Run Locally**
+
+#### **📌 Install dependencies**
+```bash
+pip install gradio pydub
+```
+
+#### **📌 Start the application**
+```bash
+python app.py
+```
+
+The app will launch locally, providing a user-friendly web interface.
+
+---
+
+### **2️⃣ Deploy on Hugging Face Spaces**
+1. Go to [Hugging Face Spaces](https://huggingface.co/spaces) and create a new space
+2. Select **Gradio** as the application type
+3. Connect your GitHub repository or manually upload `app.py`
+4. Add the following to `requirements.txt`:
+   ```
+   gradio
+   pydub
+   ```
+5. Wait for automatic deployment 🎉
+
+---
+
+## 🚀 **How to Use**
+
+1️⃣ **Upload** your Podcast (MP3) and BGM (MP3) 🔼
+2️⃣ **Adjust volume**, enable/disable **Loop** and **Fade In/Out**
+3️⃣ Click **Start Mixing** 🚀
+4️⃣ **Preview & Download** the mixed Podcast 🎧
+
+---
+
+## 🤝 Contribution Guide
+Pull requests are welcome! Please ensure:
+- Development is done in Python
+- Code follows `pydub` & `gradio` standards
+- PRs include a brief description of changes
+
+---
+
+🎵 Happy Podcast Mixing! 🎙️
+

app.py

@@ -0,0 +1,61 @@
+import gradio as gr
+from pydub import AudioSegment
+import os
+
+def mix_audio(podcast_file, bgm_file, bgm_volume, loop, fade_in_out, fade_duration):
+    if not podcast_file or not bgm_file:
+        return "請上傳 Podcast 和 BGM 檔案", None
+
+    # 讀取音檔
+    podcast = AudioSegment.from_file(podcast_file)
+    bgm = AudioSegment.from_file(bgm_file)
+
+    # 調整 BGM 音量
+    bgm = bgm - abs(bgm_volume)  # 降低 dB
+
+    # 是否需要 loop BGM
+    if loop:
+        loop_count = len(podcast) // len(bgm) + 1
+        bgm = bgm * loop_count  # 重複播放
+    bgm = bgm[:len(podcast)]  # 修剪至 Podcast 長度
+
+    # 是否添加淡入淡出效果
+    if fade_in_out:
+        bgm = bgm.fade_in(fade_duration * 1000).fade_out(fade_duration * 1000)
+
+    # 混音
+    mixed = podcast.overlay(bgm)
+
+    # 儲存混音結果
+    output_file = "mixed_podcast.mp3"
+    mixed.export(output_file, format="mp3")
+
+    return "混音完成！點擊下載", output_file
+
+# 建立 Gradio 介面
+with gr.Blocks() as app:
+    gr.Markdown("## 🎙️ Podcast 混音工具 🎵")
+
+    with gr.Row():
+        with gr.Column():
+            podcast_input = gr.File(label="📥 上傳 Podcast MP3", type="file")
+            bgm_input = gr.File(label="🎵 上傳背景音樂 MP3", type="file")
+            bgm_volume = gr.Slider(-30, 0, value=-14, label="🎚️ 背景音樂音量調整 (dB, 越小越小聲)")
+            loop_option = gr.Checkbox(value=True, label="🔁 背景音樂循環")
+            fade_option = gr.Checkbox(value=True, label="🎼 添加淡入淡出效果")
+            fade_duration = gr.Slider(1, 10, value=5, label="⏳ 淡入淡出秒數")
+            process_button = gr.Button("🚀 開始混音")
+
+        with gr.Column():
+            output_message = gr.Textbox(label="📢 處理狀態", interactive=False)
+            audio_output = gr.Audio(label="🎧 預覽混音結果", interactive=True)
+            download_output = gr.File(label="⬇️ 下載混音 MP3")
+
+    process_button.click(
+        fn=mix_audio,
+        inputs=[podcast_input, bgm_input, bgm_volume, loop_option, fade_option, fade_duration],
+        outputs=[output_message, download_output]
+    )
+
+# 執行 Gradio 應用
+app.launch()

requirements.txt

@@ -0,0 +1,2 @@
+gradio
+pydub