#music #language #nes #macro #parser #famicon

ffmml

Famicon (a.k.a. NES) Flavored Music Macro Language

3 releases

0.1.2 Jan 16, 2023
0.1.1 Dec 27, 2022
0.1.0 Dec 25, 2022

#318 in Audio

36 downloads per month
Used in ffmmlc

MIT/Apache

1.5MB
3K SLoC

ffmml

ffmml Documentation Actions Status License

Parser and player of Famicon Flavored Music Macro Language (FFMML).

Famicon is also known as NES (Nintendo Entertainment System).

🎵 Web Player

📝 VSCode Extension

The language specification of FFMML is based on MCK. But there are (known) differences between FFMML and MCK as follows:

  • FFMML doesn't support the following features:
    • #INCLUDE directive
    • #OCTAVE-REV directive
    • @n command (direct frequency select)
    • n command (direct note select)
    • y command (direct memory entry)
    • DPCM channel
  • FFMML features #CHANNEL <CHANNEL_NAME> <OSCILLATOR> directive that defines custom channels:
    • <CHANNEL_NAME>: A..=Z
    • <OSCILLATOR>: 1 (pulse wave), 2 (triangle wave), or 3 (noise)

Examples

The following example parses an MML script and generates audio data:

let mml = r#"; From https://www.nesdev.org/mck_guide_v1.0.txt
#TITLE My First NES Chip
#COMPOSER Nullsleep
#PROGRAMER 2003 Jeremiah Johnson

@v0 = { 10 9 8 7 6 5 4 3 2 }
@v1 = { 15 15 14 14 13 13 12 12 11 11 10 10 9 9 8 8 7 7 6 6 }
@v2 = { 15 12 10 8 6 3 2 1 0 }
@v3 = { 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 }

ABCD t150

A l8 o4 @01 @v0
A [c d e f @v1 g4 @v0 a16 b16 >c c d e f @v1 g4 @v0 a16 b16 >c<<]2

C l4 o3 q6
C [c e g8 g8 a16 b16 >c8 c e g8 g8 a16 b16 >c8<<]4

D l4 @v2 @0
D [@v2 b @v3 e @v2 b @v3 e @v2 b @v3 e @v2 b @v3 e8 @v2 b8]4"#;

let music = mml.parse::<ffmml::Music>().unwrap_or_else(|e| panic!("{e}"));
let mut player = music.play(48000);
let audio_data = (&mut player).collect::<Vec<_>>();
player.take_last_error().map(|e| panic!("{e}"));

To play the music defined by the above MML script, run the following commands:

$ cargo install ffmmlc
$ cat examples/music01.mml | ffmmlc > music01.wav
$ play music01.wav

References

About MML

Abount Famicon sound

Dependencies

~4MB
~87K SLoC