Hugging Face's logo

Spaces:
tbdavid2019
/
BGMixer
Sleeping

App Files Community
BGMixer / README.md
tbdavid2019's picture
tbdavid2019
1st
7a67d26
preview code
|
raw
history blame
3.67 kB
metadata
title: BGMixer
emoji: 🎵
colorFrom: green
colorTo: yellow
sdk: gradio
sdk_version: 5.14.0
app_file: app.py
pinned: false
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️⃣ 本機運行

📌 安裝必要套件 

pip install gradio pydub

📌 執行應用程式 

python app.py

應用程式將會在本機啟動，並提供 Web UI 讓你操作。

2️⃣ 部署到 Hugging Face Spaces

  1. 前往 Hugging Face 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 

pip install gradio pydub

📌 Start the application 

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 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! 🎙️