Skip to content

mistydemeo/ruby-mdxplay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ruby-mdxplay

Introduction

ruby-mdxplay is a simple Ruby player for the Japanese X68000 computer's MDX music format. It's based on BouKiCHi's libmdxmini library and Daisuke "Breeze" Nagano's mdxplay.

MDX?

The X68k had a powerful FM synthesizer (YM2151 to the geeks), which was capable of some amazing synthy tones. Think of it as the big brother to the Sega Genesis. It is sweet, my friends.

If you need some tunes, you can grab the (almost) complete set at MDXOnline: http://www42.tok2.com/home/mdxoarchive/

Requirements

Not many.

Usage

mdxplay songname [opts]

Options:

-l, --loops        Number of song loops
-q, --quiet        Don't print song name or show visualizer
-h, --help         Display help
-v, --version      Display version information

TODO (AKA: How can I help?)

This player won't see substantial revisions from hereon out. I wrote ruby-mdxplay as a way to learn FFI. I'm starting work soon on a new, cleaner, more awesome chiptune player that will support many more formats, more OSs, and all around be a greater experience. I recommend you try it when it exists.

Known issues:

  • Certain song names can't be decoded, presumably because they use X68k-specific additions to the Shift JIS character set. If you wanted to help out, adding an X68k SJIS encoding would not go amiss.
  • Certain songs (such as the Nostalgia 1907 soundtrack) cause CoreAudio errors. I'm unsure whether this is a bug in ruby-mdxplay, libmdxmini, or in the ruby-coreaudio gem.

FAQ

Q: That ASCII piano is awesome.
A: Why thank you!

Q: That ASCII piano sucks.
A: Use -q to silence printing of song names, playtime, and the piano.

Q: This song says it's going to play for 20 minutes. That seems like a long time.
A: Some songs have buggy loop handling. Try adding -l 1 to your commandline arguments.

Thanks

License

ruby-mdxplay is licensed under the GPL v2 or later.

About

Simple commandline MDX chiptune player

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages