🎹 myMiniKeyboard

一個用 Python 寫的迷你鋼琴鍵盤，支援 128 種 GM 音色，讓你隨時隨地彈奏任意樂器。

---

功能特色

• 畫面上有一組 C4～C5 的鋼琴鍵，可用滑鼠點擊或鍵盤按鍵演奏
• 支援 128 種 GM 標準樂器（鋼琴、吉他、小提琴、長笛、鼓…等應有盡有）
• 可自由調整八度（Octave），擴展音域
• 音色庫（GeneralUser GS SF2）已內附於本專案，無須額外下載

---

鍵盤對應

白鍵：  A  S  D  F  G  H  J  K
        C  D  E  F  G  A  B  C(高)

黑鍵：  W  E     T  Y  U
        C# D#    F# G# A#

---

安裝與執行

前置需求

1. 安裝 Python 套件

   pip install pyfluidsynth

2. 確認專案檔案完整

   確保以下檔案都放在同一個資料夾中：

   • myMiniKeyboard.py
   • GeneralUser_GS.sf2
   • 以下 FluidSynth 相依 DLL（共 11 個）：
     • libfluidsynth-3.dll
     • libglib-2.0-0.dll
     • libgobject-2.0-0.dll
     • libgthread-2.0-0.dll
     • libinstpatch-2.dll
     • libsndfile-1.dll
     • libintl-8.dll
     • libstdc++-6.dll
     • libgcc_s_sjlj-1.dll
     • libgomp-1.dll
     • libwinpthread-1.dll

執行

python myMiniKeyboard.py

音色庫檔案（GeneralUser_GS.sf2）已包含在專案中，啟動即可使用。

---

使用方式

1. 啟動程式後，等待音色庫載入完成
2. 從上方的下拉選單選擇喜歡的樂器音色
3. 用鍵盤（ASDFGHJK / WETY U）或滑鼠點擊琴鍵來彈奏
4. 透過八度調整按鈕，可以彈更高或更低的音

---

依賴項目

套件 / 工具	用途
Python 3.8+	執行語言
tkinter	GUI 介面（Python 內建）
pyfluidsynth	MIDI 音色合成
FluidSynth	底層音色引擎（需另行安裝）
GeneralUser GS SF2	音色庫（已內附於本專案）

---

致謝

音色庫使用 GeneralUser GS by S. Christian Collins，以 MIT/CC 授權免費共享。這份優質的免費 GM 音色庫讓本專案能夠提供豐富的 128 種樂器音色，非常感謝作者的無私分享。