MUCOMSX

MUCOM88 for MSX·MAKOTO (YM2608)

Compose in MML · Compile on the MSX itself · Play on real hardware · Export MUB

MUCPlaygroundNEW Write MUC (MML) in your browser and hear it right away — nothing to install. 브라우저에서 MUC를 쓰고 바로 듣기 · ブラウザでMUCを書いてすぐに試聴 FM · SSG · rhythm · ADPCM · MSX-MUSIC · PSG · SCC/SCC+ — MDPlayer4Mac channel view, .MUB / .VGM export Open ▶

Update News 업데이트 소식 · 更新情報

All news

About 프로젝트 소개 · 概要

MUCOMSX brings MUCOM88 — the FM music toolchain Yuzo Koshiro (古代祐三) developed for the YM2203 and YM2608 (Sound Board II) of the NEC PC-8801mkⅡSR and later — to the MSX. The whole cycle runs on the machine itself: write MML, compile it, hear it, export it, without ever moving a file to a PC.

한국어

MUCOMSX는 코시로 유조(古代祐三)가 직접 개발한, NEC PC-8801mkⅡSR 이후에 탑재된 YM2203 및 YM2608(사운드 보드Ⅱ)을 대상으로 하는 악곡 제작용 툴인 MUCOM88 프로젝트를 MSX용으로 개발한 프로젝트입니다. MSX로 출시된 YM2608 카트리지인 MAKOTO Cartridge에 대응합니다.

편집·컴파일·연주·내보내기까지 전 과정을 MSX에서 처리합니다. 동작은 실기 및 에뮬레이터 상을 상정하고 있습니다. 사용 방법은 각 툴의 설명서를 참조해 주십시오.

日本語

MUCOMSXは、古代祐三が自ら開発した、NEC PC-8801mkⅡSR以降に搭載されたYM2203及びYM2608(サウンドボードⅡ)を対象とする楽曲制作用ツールであるMUCOM88プロジェクトをMSX用に開発したプロジェクトです。MSX向けに発売されたYM2608カートリッジであるMAKOTO Cartridgeに対応しています。

編集・コンパイル・演奏・書き出しまでの全工程をMSX上で完結できます。動作は実機、及びエミュレータ上を想定しております。使用方法は各ツールの説明書をご参照ください。

English

MUCOMSX is a project that brings the MUCOM88 project — a music production tool originally developed by Yuzo Koshiro for the YM2203 and YM2608 (Sound Board II) chips on the NEC PC-8801mkIISR and later models — to the MSX platform. It supports the MAKOTO Cartridge, a YM2608 cartridge released for the MSX.

Editing, compiling, playback and export all run on the MSX. The tools are intended to run on real hardware or emulators. For usage, see each tool's manual.

See it working 시연 영상 · デモ動画

Short demonstrations of the editor and the standalone player running on MSX.

MUCEdit — editing and compiling on the MSX
MUCEdit 시연 · MUCEdit デモ · YouTube
MUBPlay — playing a finished MUB
MUBPlay 시연 · MUBPlay デモ · YouTube

Thumbnails load from YouTube; the player itself is only loaded once you press play.

Try it in your browser 브라우저에서 바로 · ブラウザですぐに

MUCPlayground is an editor where you type MUC (MML) and hear it at once — nothing to install. It runs MDPlayer4Mac's compiler and chip emulation in the browser: YM2608 FM, SSG, rhythm and ADPCM, plus MSX-MUSIC, PSG and SCC/SCC+. The editor colours MML, suggests commands as you type and checks the song while you write, and can be split to show two places of a long song; while a song plays, each part's current command lights up, or MDPlayer4Mac's channel view shows every chip channel. New starts from a commented template that plays OPNA and every MSX chip (MSX-MUSIC, PSG, the five SCC parts) together. Ready-made templates (basics, one per sound chip, drum libraries, genre songs waiting for a melody; commented in English and Japanese) and every song in the samples folder are one click away, and your song saves as .MUC, .MUB or .VGM. Drag a .MUC, .MUB, .VGM or .VGZ from your computer onto it to play it.

Open MUCPlayground →

한국어

MUC(MML)를 입력하고 바로 들어볼 수 있는 웹 에디터입니다. 설치할 것이 없습니다. 오류는 줄 번호와 함께 표시되고, 저장소의 샘플 곡을 그대로 불러와 고쳐 볼 수 있습니다.

日本語

MUC(MML)を書いてすぐに試聴できるWebエディタです。インストールは不要です。エラーは行番号付きで表示され、リポジトリのサンプル曲をそのまま読み込んで編集できます。

English

Errors are listed with their line numbers, and the repository's sample songs load straight into the editor. Save your song as a Shift-JIS .MUC to take it to the MSX.

The toolchain 구성 도구 · ツール構成

Four programs cover the MSX side of the workflow. Every manual is available in Korean, Japanese and English. Voices, SCC waves and PCM banks are edited in MUCPlayground.

MUCEDIT.COM

Editor

Full-screen MML editor for the MSX. 80-column, VS Code-style keys, block selection, undo/redo and search. Calls MUCPLAY to compile, play and export without leaving the editor.

MUCPLAY.COM

Compiler & player

Compiles .MUC and plays it, or keeps a song resident in memory so you can recompile and replay without reloading. Exports .MUB. The compiler is built in.

MUC2MUB.COM

Batch compiler

One command, one .MUC in, one .MUB out — no session, no playback, no sound hardware needed. Takes sources up to 64 KiB, returns a DOS exit code, and saves through a temporary file so a failure never destroys the previous .MUB.

MUBPLAY.COM

MUB player

Standalone player for finished .MUB files. Repeat control and a load-test mode for checking a file.

MUCPlayground (web)

FM / SCC / PCM editor

Browser editors for YM2608 FM voices, SCC/SCC+ waves and ADPCM PCM banks, with instant audition. The FM, SCC and PCM banks read and save the #voice, #sccvoice and #pcm files the MSX tools use; PCM banks can be built from WAV. Replaces MUCVOICE, which is no longer in the toolchain ZIP.

MUCPLAY and MUC2MUB share the same compiler, so they accept the same MML and report the same error codes. Which one you reach for depends on what you want back.

Which tool should I use?

If you want to…UseWhy
Write and revise a song, hearing each changeMUCEDIT (+ MUCPLAY)Edit, compile and play without leaving the editor
Hear a .MUC once, right nowMUCPLAYMUCPLAY SONG.MUC compiles and plays in one step
Iterate from the DOS prompt and exportMUCPLAY session/LOAD → /COMPILE → /PLAY → /MUB
Convert a whole album unattendedMUC2MUBOne song per run, driven by a .BAT; exit codes to check
Compile a source too large for the editorMUC2MUBAccepts up to 65,536 bytes; the editor holds 60,000 normalized bytes
Compile on a machine with no MakotoMUC2MUBCompiling needs no sound device — only playback does
Just listen to a finished .MUBMUBPLAYNo compiler involved

File formats

ExtensionWhat it isHow to play it
.MUCMML source text. Human-readable and editable.MUCPLAY SONG.MUC
.MUBCompiled song data, carrying voices, tags and PCM as needed.MUBPLAY SONG.MUB
.VGMA log of chip commands and timing — not an audio recording. The MSX tools no longer write it (since 2026-10-30); MUCPlayground can save one.VGMPLAY SONG.VGM
Why MUB rather than VGM? A VGM records every register write as it happens; a MUB stores the score and lets the player perform it. For the same song a MUB is dramatically smaller — which matters a great deal on a floppy or SD card, especially once PCM is involved.

MUCScope & MUBScope 눈으로 보는 음악 · 音楽を目で楽しむ

Two graphical music players for MSX1 and later. Follow the notes, levels and SCC waveforms on a SCREEN 2 display while listening on real sound hardware.

MUCScope

MUC source → compile → visual playback

Select a .MUC source and let the built-in compiler turn it into music on the MSX. Browse for another song while compiling; replay the current compiled song without compiling again. For listening to your MML collection, not editing it.

.MUC 소스를 선택하면 MSX에서 직접 컴파일한 뒤 시각화 화면과 함께 연주합니다. 컴파일 중에도 다음 곡을 탐색할 수 있고, 같은 곡을 다시 들을 때는 컴파일 결과를 재사용합니다. MML 편집은 MUCEDIT를 사용하세요.

.MUC ソースを選ぶと、MSX上でコンパイルして視覚表示とともに演奏します。コンパイル中も次の曲を探せます。同じ曲の再生にはコンパイル済みデータを再利用します。MMLの編集にはMUCEDITをお使いください。

MUCSCOPE SONG.MUC
MUCScope — compile and play a MUC with visuals
MUCScope 시연 · MUCScope デモ · Watch on YouTube

MUBScope

Compiled MUB → visual playback

Play finished .MUB files without compiling. Supports MUB8 and supported muPb/msPb songs, reading voices and embedded PCM from the MUB itself. A graphical way to browse and enjoy a compiled music collection.

완성된 .MUB 파일을 컴파일 없이 바로 연주합니다. MUB8과 지원 범위의 muPb/msPb 곡을 재생하며, 음색과 내장 PCM은 MUB에서 읽습니다. 컴파일된 음악 모음을 탐색하고 감상하기 위한 그래픽 플레이어입니다.

完成した .MUB をコンパイルなしで演奏します。MUB8と対応範囲内のmuPb/msPb楽曲を再生し、音色と内蔵PCMはMUBから読み込みます。コンパイル済みの音楽コレクションを探して楽しむためのグラフィカルプレーヤーです。

MUBSCOPE SONG.MUB
MUBScope — visual music player demo
MUBScope 시연 · MUBScope デモ · Watch on YouTube

English

See channel keyboards, note names, levels, chip pages and SCC waveforms. Tab switches between channel and spectrum views; C switches sound-chip pages. The spectrum is estimated from playback data, not an audio FFT.

Browse drives and folders with F, select with the arrows and Return, and adjust master or sound-group volume with V. ONCE, LOOP and RANDOM modes, pause, fade-out and playback-speed controls make album listening easy.

Choose from 40 channel-view skins, 40 spectrum skins and six toolbar styles. Open the skin picker with Shift+F5 or Ctrl+L.

한국어

채널별 건반·음이름·레벨과 칩별 화면, SCC 파형을 보여줍니다. Tab으로 채널/스펙트럼 화면을, C로 사운드 칩 화면을 전환합니다. 스펙트럼은 연주 데이터로 추정하며 실제 오디오 FFT 분석은 아닙니다.

F로 드라이브와 폴더를 탐색하고 방향키와 Return으로 곡을 선택합니다. V로 전체·음원 그룹별 음량을 조절합니다. ONCE·LOOP·RANDOM, 일시정지, 페이드아웃과 재생 속도 조절을 지원합니다.

채널 화면 40종, 스펙트럼 화면 40종의 스킨과 툴바 6종을 제공합니다. Shift+F5 또는 Ctrl+L로 스킨을 고르세요.

日本語

チャンネル別の鍵盤・音名・レベル、音源別ページ、SCC波形を表示します。Tabでチャンネル/スペクトラム表示、Cで音源ページを切り替えます。スペクトラムは演奏データからの推定で、音声のFFT解析ではありません。

Fでドライブやフォルダーを開き、方向キーとReturnで選曲。Vで全体・音源グループ別の音量を調整できます。ONCE・LOOP・RANDOM、一時停止、フェードアウト、再生速度の変更に対応します。

チャンネル表示40種、スペクトラム表示40種のスキンと、6種類のツールバーを用意。Shift+F5またはCtrl+Lでスキンを選べます。

Scope player setup: MSX1 or later, 16KB VRAM, MSX-DOS2/Nextor and a RAM mapper; 512KB or more is recommended. Install the separate Scope package with its matching COM/BIN modules and complete SKINS folder. These players are separate from the four-tool toolchain ZIP.

설치 환경: MSX1 이상, VRAM 16KB, MSX-DOS2/Nextor와 RAM 매퍼가 필요하며 512KB 이상을 권장합니다. 기존 5종 툴체인 ZIP과는 별도 패키지입니다. 같은 버전의 COM/BIN 모듈과 SKINS 폴더를 함께 설치하세요.

動作環境:MSX1以降、VRAM 16KB、MSX-DOS2/NextorとRAMマッパーが必要です。512KB以上を推奨します。既存の5ツール入りZIPとは別パッケージです。同じ版のCOM/BINモジュールとSKINSフォルダーをまとめて配置してください。

Provide every chip the song uses: PSG, MSX-MUSIC/OPLL, OPNA such as MAKOTO, or SCC/SCC+. Heavy songs may slow down on a normal Z80. Supported Panasonic fast modes and Turbo R acceleration are automatic; /N disables them.

곡에서 사용하는 PSG·MSX-MUSIC/OPLL·MAKOTO 등의 OPNA·SCC/SCC+ 하드웨어가 필요합니다. 고부하 곡은 일반 Z80에서 느려질 수 있습니다. 지원 Panasonic 고속 모드와 Turbo R 가속은 자동 적용되며 /N으로 해제합니다.

曲が使用するPSG・MSX-MUSIC/OPLL・MAKOTOなどのOPNA・SCC/SCC+を用意してください。高負荷の曲は通常のZ80では遅くなる場合があります。対応Panasonic機の高速モードとTurbo Rの加速は自動で有効になり、/Nで無効にできます。

How a song moves through the tools 작업 흐름 · 作業の流れ

There are two routes from source to song: an interactive one you work in, and a batch one you script.

   ┌─────────────┐
   │  SONG.MUC   │   MML source — write it in MUCEDIT, or any text editor
   └──┬───────┬──┘
      │       │
      │       └──────────────────────────────┐
      │                                      │  MUC2MUB SONG.MUC
      │  MUCPLAY /LOAD → /COMPILE            │  (one shot, no session,
      │  (or F1→2 inside MUCEDIT)            │   no sound hardware)
      ▼                                      │
   ┌─────────────┐                           │
   │   session   │  compiled song, resident  │
   └──┬───┬───┬──┘  in mapper RAM            │
      │   │                                  │
  /PLAY  /MUB              (F1→3, F1→4)      │
      │   │                                  │
      ▼   ▼                                  ▼
   listen  SONG.MUB                      SONG.MUB
              └────────────┬─────────────────┘
                           ▼
                  MUBPLAY SONG.MUB
Saving, compiling and playing are three different actions. Saving updates the .MUC on disk. Compiling turns what is currently in memory into playback data. Playing performs the most recent compile. Edit and press play without compiling in between, and you will hear the previous version.

The batch route has no such state. MUC2MUB always reads the .MUC as saved on disk — so if the editor still holds unsaved changes, it will not see them.

Requirements 동작 환경 · 動作環境

The table below describes the core toolchain environment. For the MSX1-compatible graphical players, see MUCScope & MUBScope above.

MachineMSX2 or later with an 80-column text screen. MSX2+ class recommended; turbo R is taken into account.
OSMSX-DOS 2, or Nextor providing the same functionality
MemoryAt least 512 KiB mapper RAM, with enough allocatable free segments
SoundMAKOTO cartridge (YM2608) — for playback. Compiling with MUC2MUB needs no sound device
StorageA writable disk or storage device — compiling uses temporary files
Installed RAM and usable free RAM are not the same thing — DOS, resident programs and any song session you are holding all consume memory. A build for Neotron-B (YM2610B) is in preparation and is a separate executable; please do not mix it with the MAKOTO build.

Quick start 빠른 시작 · クイックスタート

Just listen to a song

CD SONG
MUCPLAY SONG.MUC

Press any character key or Esc to stop.

Edit, hear, repeat

MUCEDIT SONG.MUC

Inside the editor: F1 2 to compile → read the result → F1 3 to play. Like what you hear? Ctrl+S to save. You do not have to save before compiling — MUCEDIT compiles the buffer in memory.

Work from DOS and export

MUCPLAY /LOAD SONG.MUC      ← read the source into memory
MUCPLAY /COMPILE            ← compile it (nothing is written to disk yet)
MUCPLAY /PLAY               ← listen
MUCPLAY /MUB SONG.MUB       ← export compiled song data
MUCPLAY /RELEASE            ← free the session when you are done

Edited the .MUC in another editor? Run /LOAD again — /COMPILE alone recompiles the copy already in memory.

Convert without playing — one song, or a whole album

MUC2MUB SONG.MUC              ← writes SONG.MUB
MUC2MUB SONG.MUC TEST.MUB     ← or name the output yourself

For a whole album, let DOS drive it. Put this in BUILD.BAT:

@ECHO OFF
MUC2MUB SONG01.MUC
MUC2MUB SONG02.MUC
MUC2MUB SONG03.MUC

MUC2MUB returns 0 on success and 1 on failure, so a shell can check each song. It does not stop the batch by itself when one song fails — and a .MUB left over from an earlier run will still be sitting there, so never count files to decide whether a batch succeeded.

MML at a glance

ChannelSound source
A B CFM 1–3
D E FSSG 1–3
GRhythm
H I JFM 4–6
KADPCM / PCM

FM is not a continuous run from A to F — D, E, F are SSG, and FM continues at H.

#mucom88 1.7
#title First Steps
#composer ToughkidCST

D T120 C128 o4 l8 v10 q0 cdef gab>c4 r4
E C128 o3 l4 v8 c r g r c r g r
F C128 o2 l2 v7 c g c g

Case matters: c is a note but C sets the base clock; t225 is a raw Timer-B value while T120 is BPM.

Two gotchas worth knowing up front

/L does not mean the same thing everywhere.

Command/L5 means
MUCPLAY SONG.MUC /L5play 5 times, then stop
MUBPLAY SONG.MUB /L5play 5 times, then stop
MUBPLAY SONG.MUB /L0loop until a key is pressed

Source, editor, page and total DATA limits are separate. These are the current extended-build limits; adding RAM does not automatically raise them.

LimitValueApplies to
Editing buffer60,000 bytesMUCEDIT after newline normalization, four 16 KiB banks
Source file65,536 bytes (64 KiB)MUC2MUB / MUCPLAY input, including tags, comments and line endings
One page stream59,546 bytes OPNA / 59,106 bytes native MSXSeparate from total DATA
Compiled music DATA98,304 bytes (96 KiB)Notes, structures and FM voices together
Final .MUBMay exceed 96 KiBHeader + DATA + tags + PCM; format, loader and free-memory limits still apply

A 40 KiB source is within the editor's size limit. Macro expansion can still exceed a page or total DATA limit. Ordinary songs retain MUB8; OPNA extensions use muPb 0100, native MSX targets use msPb0100, and SCC/SCC+ SSG extension uses msPb0101. A–K each support pages 0–9 sharing one physical YM2608. A 512 KiB mapper does not guarantee that every large song fits with other sessions resident.

Documentation 문서 · ドキュメント

Every manual is available in all three languages. The MUCEdit manual is the broadest introduction — the editor, the MML syntax, every compile error code, the source warnings, and troubleshooting. The MUC2MUB manual goes deepest on the compiler itself: the full error and warning reference, filename and memory rules, and safe saving and recovery. No MD5 calculation or verification is required or provided.

Tool한국어日本語English
MUCEdit — editor MUCEdit.md MUCEditJ.md MUCEditE.md
MUCPlay — compiler & player MUCPlay.md MUCPlayJ.md MUCPlayE.md
MUC2MUB — batch compiler Muc2Mub.md Muc2MubJ.md Muc2MubE.md
MUBPlay — MUB player MUBPlay.md MUBPlayJ.md MUBPlayE.md
MUCPlayground — voice, SCC wave and PCM editing MUCPLAYGROUND.md MUCPLAYGROUND.ja.md MUCPLAYGROUND.en.md
MucoMSX chip extensions — SCC/SCC+, OPLL, PSG readme.ko.md readme.ja.md readme.md
MUCScope / MUBScope — visual players MUCScope · MUBScope

Wiki — writing the music 음악 만들기 · 音楽づくり

The manuals describe the tools. The wiki describes the music — how MUCOM88 MML is actually written, and how the voices, rhythm patterns and PCM banks a song depends on are prepared. FM voices, SCC/SCC+ waves and PCM banks (including WAV conversion) are edited in MUCPlayground in a web browser.

Open the wiki →
Page한국어日本語English
Home — what the wiki covers, and where to begin Home-ko Home-ja Home
Workflow — Windows → MSX, end to end Workflow-ko Workflow-ja Workflow

Read the mucomDotNET command guide, native MSX targets, SSG extension, MUCPlayground and memory and file limits.

Downloads 다운로드 · ダウンロード

Find downloads on the releases page. The current package layout is MucoMSX_YYMMDD.zip for all four tools with their .MXR modules, starter voice data and quick help, plus MucoMSX_Docs_YYMMDD.zip for complete Korean, English and Japanese manuals. Optional .sha256 files check download integrity. Earlier releases may contain only the original four tools; check each release's contents.

Download from Releases →

Related, from the original PC-8801 project

MUCOM88 for Windows Runs standalone, nothing else required. 【ONION software】
MUCOM88 / ALPHA-DOS / VoiceEditor / SDK PC-8801 disk images and SDK — see the official MUCOM88 site

Questions & issues 문의와 제보 · 質問と報告

Found a bug, hit something the manuals don't cover, or have an idea for the tools? Please open a ticket on the repository's issue tracker. Search the existing issues first — someone may have hit the same thing. Korean, Japanese and English are all welcome.

Open an issue on GitHub →

What to include in a playback or compile report

Which tool and buildMUCEDIT.COM / MUCPLAY.COM / MUC2MUB.COM / MUBPLAY.COM, and its size or the date you obtained it
MachineReal MSX model, or emulator + machine settings; CPU mode
SystemMSX-DOS2 or Nextor version, memory mapper, cartridges, storage
The exact commandThe full command line you typed
The songFilename, and if possible the .MUC plus its voice and PCM files
What happenedThe error or warning text in full, or the section where it sounds wrong — and what you expected instead
A small file that reproduces the problem is worth more than a long description. If you can't share the music, a minimal example with nothing sensitive in it works just as well. Each tool's manual has a fuller checklist in its troubleshooting chapter.

한국어

버그를 발견하셨거나, 설명서에 없는 상황을 만나셨거나, 개선 아이디어가 있으시면 저장소의 이슈 게시판에 남겨 주세요. 먼저 기존 이슈를 검색해 보시면 같은 문제가 이미 올라와 있을 수 있습니다. 한국어·일본어·영어 모두 환영합니다.

문제를 알려주실 때는 위 표의 항목 — 사용한 툴과 빌드, 기종, 시스템 구성, 입력한 명령 전체, 곡 파일, 오류 문구와 기대한 결과 — 를 함께 적어 주시면 원인을 훨씬 빨리 좁힐 수 있습니다.

日本語

バグを見つけた、説明書に載っていない状況に遭遇した、あるいは改善のアイデアがある場合は、リポジトリのIssueへお寄せください。まず既存のIssueを検索してみてください。同じ問題がすでに報告されているかもしれません。韓国語・日本語・英語のいずれでも歓迎します。

問題を報告される際は、上の表の項目 — 使用したツールとビルド、機種、システム構成、入力したコマンド全体、曲のファイル、エラーの文言と期待した結果 — を併せて記載いただけると、原因をはるかに早く絞り込めます。

English

Found a bug, hit something the manuals don't cover, or have an idea? Open a ticket on the issue tracker. Search the existing issues first — someone may have hit the same thing. Korean, Japanese and English are all welcome.

When reporting a problem, the items in the table above — tool and build, machine, system configuration, the exact command, the song files, and the error text versus what you expected — narrow the cause down fastest.

License 라이선스 · ライセンス

한국어

MUCOM88은 ALPHA-DOS 상에서 동작하는 FM 음원 드라이버와 음악 제작 툴의 총칭입니다 (License: CC BY-NC-SA 4.0). ALPHA-DOS는 8bit PC인 NEC PC-8801 시리즈 상에서 동작하는 운영체제입니다 (License: CC BY-NC-ND 4.0). MML로 작성된 악곡을 내장 FM 음원 및 사운드 보드 II 음원 상에서 연주할 수 있습니다.

日本語

MUCOM88は、ALPHA-DOS上で動作するFM音源ドライバーと音楽製作ツールの総称です (License: CC BY-NC-SA 4.0)。ALPHA-DOSは、8bitパソコン・NEC PC-8801シリーズ上で動作するオペレーティングシステムです (License: CC BY-NC-ND 4.0)。MML記述による楽曲を、内蔵FM音源、及びサウンドボードII音源上で演奏させることが可能です。

English

MUCOM88 is a collective term for an FM sound driver and music production tools that run on ALPHA-DOS (License: CC BY-NC-SA 4.0). ALPHA-DOS is an operating system for the 8-bit NEC PC-8801 series computers (License: CC BY-NC-ND 4.0). It enables music written in MML to be played on the built-in FM sound source and Sound Board II.