MIDI Guide，一個開放且「全面」的MIDI CC與NRPN資料集，已遠遠超出其最初的用途。

最近，我合併了一位首次貢獻者的作品，讓MIDI Guide的資料集超過了300款樂器。這次拉取請求完整記錄了一款我從未聽過的合成器——L.L. Electronics的RozzBox One V2的MIDI CC實作（我個人覺得有些獨特），這又是MIDI Guide社群帶給我的另一個酷炫合成器。

三百款樂器！來自52位貢獻者，幾乎全是陌生人。而且至少有3款實體硬體設備使用這個資料集（它採用CC-BY-SA 4.0授權，歡迎你也在專案中使用）。

就在加入第300個定義之前，我們發布了MIDI Guide的起源應用程式：Condukt，一款適用於iOS、iPad和macOS的表演用MIDI控制器與序列器。但一款2026年發布的應用程式，怎麼會在2019年催生出一個社群專案呢？這是一個被擱置七年的熱情專案，如何孕育出有用的成果，並最終推出的故事。

2019年初，我和我的共同創辦人從半個十年的Windows軟體開發中醒來。是時候重新拿起iPad，嘗試在真正的App Store與大廠競爭了。在思考要做什麼時，我們重新發現了購買甚至使用合成器的樂趣。

那是一個瘋狂的時代開始收集合成器：#dawless標籤承諾即使沒有電腦也能提高生產力與快樂，而OP-1重新發行版以1,299美元的荒謬價格被譏為業餘玩具。值得注意的是，Eurorack當時仍侷限於實驗室，尚未出現在都市廢水監測中。

我們的第一批合成器購買之一是Elektron Analog Four MKII。它可能仍是我最喜歡的合成器，因為它不僅是合成器：有序列器與四軌，我可以不靠其他設備完成一段即興演奏。但最吸引我們的是它的表演模式。完成作曲後，A4能將旋鈕映射到多個可自訂參數，一鍵多變。當時我們想，如果iPad應用程式能為多台合成器同時做到這點，該有多好？

我們設想Condukt成為一款單一應用，像A4的表演旋鈕一樣，控制整個錄音室。於是我們打造了它！至少是Beta版。這是它在iPadOS 12上的運作畫面：

對兩個生疏的開發者來說，製作應用程式本身就是挑戰，但也發現使用我們的應用程式本身就是一道門檻。系統需求很高：

於是我們決定擱置Condukt。夏天期間，我們轉而開發Penbook——現在是App Store編輯推薦——但我已經記錄的MIDI CC實作該怎麼辦？

MIDI文件不會過期；我用過40年前的掃描資料來補充這個專案。老實說，我對我們設計的MIDI CC與NRPN文件格式有點自豪。我認為這格式在兩個常常對立的目標間取得了不錯的平衡：

CSV檔案是關鍵。許多我認識的「真實」音樂人都有Excel，但沒有人知道YAML是什麼（請別跟我說可讀性）。事實證明，很多貢獻是透過電子郵件寄來的，郵件裡常帶著可愛又謙虛的抱歉，說不會用git，好像那是他們的錯。

這是我在網路上表達意見的機會，我也知道怎麼做網站。MIDI Guide的第一版誕生了。

我在我們開發公司的子網域上推出了簡單的網頁應用，並用來自17家製造商的50款合成器資料初始化倉庫。這是個不錯的開始，至少涵蓋了我所有的合成器。

我以前從未參與過開源專案，更別說負責一個。這對我來說是個重要時刻！責任重大……

早期的貢獻令人振奮。沒有人過度挑剔我的設計決策，只有設備新增與修正。偶爾的元討論也很有建設性：建議更嚴謹的規範、可新增而不破壞現有客戶端的欄位等等。有些貢獻者甚至分叉倉庫，打造自己的客戶端：MIDI圖書館、控制器、序列器、玩具。雖然是小眾，但這資料集有真實用戶。

許多尊重的路過者提出問題，幫助我定義專案的範圍：能否記錄sysex？能否改用JSON？能否實作特定API設計？這些討論釐清了專案範圍，也讓它更強大。

最棒的是感覺到我選擇解決的問題對其他人也有價值且普遍。當你著手解決問題時，很難說服別人問題存在。這些人不需要聽這些，他們也覺得翻手冊查數字很蠢。

隨著專案網站流量增加，我們意識到沒有專屬網域會讓潛在貢獻者卻步。將專案移至midi.guide，讓資料集有了品牌，也讓專案更容易被討論。

這三年來，我只新增或合併了來自4家製造商的14個樂器定義。當時我覺得合理：專案網站有穩定的自然流量，靜靜地發揮作用，主機費用也不高。這階段多加定義會幫助專案嗎？還是這類資料集的需求本來就不大？

專案的轉捩點是Bacara生成式MIDI插件背後團隊的持續貢獻，極大提升了設備涵蓋範圍與品質。更多眼睛幫我清理了些陳舊角落，也為接下來的發展鋪路。

這是我們所知首款實體設備採用MIDI Guide資料集。它不只是一般設備，而是一件令人印象深刻的裝置，能將現場合成器表演提升到讓人誤以為是DJ的水準。這正是我一直希望MIDI Guide能被用來的用途。

作為軟體開發者，看到硬體專案使用我的資料，感覺就像被徵召進入大聯盟。

當資料集達到200款樂器時，感覺像是機制啟動了。倉庫的更新節奏加快，我們聽說越來越多硬體與軟體專案使用這資料集。

我們自己的應用Beta版也帶來一些資料集新增請求。回應這些請求很簡單：一項工作讓兩個專案都更好。

專案網站設計基於2019年已顯老態的Bootstrap 4。資料集字體選用的怪異自訂字型也無助於美觀。雖然簡單定義呈現良好，但複雜或冗長定義會拉伸表格、出現奇怪的滾動區域，整體凌亂。是時候重構了。

有許多容易改進的地方。我嘗試重新設計設備頁面（呈現特定樂器MIDI實作的頁面），遵循以下原則：

我也開始為每個樂器繪製簡單的單色輪廓圖。從Elektron設備開始，因為他們的旋鈕最容易畫。

截至目前，約有三分之二的設備有圖示。你可能會想，這很枯燥吧？沒錯！但數量本身就是一種品質，當我製作本文頂部的旋鈕展示時，這付出得到了回報。

Reliq這款帶木質飾邊的合成器/錄音室/數位音樂工作站/收藏品/便攜神器，內建定期更新的MIDI Guide資料集用於控制其他硬體。這讓人感到肯定，但真正的價值在於Reliq用戶開始請求新增合成器，並回饋定義給資料集。這就是成功的感覺嗎？

這不難吧？只花了七年。這個月我們迎來第300款樂器。

資料集包含21,262個參數，321款樂器，來自98家製造商，由56位社群成員貢獻（2026年4月）。

至於Condukt，其發布比我們預期更成功。它在App Store音樂類排名第8。快來看看吧：

我新增合成器的速度變快了，但興趣不減。在這些樂器中，80%是我不熟悉的：具備尖銳MIDI實作的吉他效果器、2010年的DIY合成器套件、你聽過但叫不出名字的機架合成器、一本200頁的合成器手冊，而該合成器只賣出40台。

透過閱讀手冊接觸小眾合成器，與在店裡亂轉旋鈕相反，更像是在讀食譜。請求新增某款合成器，暗示了它的音色特色。經常會有忘卻的合成器請求，隔天又有另一個相同請求，這時我才意識到這款「被遺忘」的合成器是瀕危音色的唯一來源。

感謝你閱讀我的勝利之旅！下個里程碑再見。

此資料集採用創用CC 姓名標示-相同方式分享 4.0 國際授權條款提供。