Go to file
tildearrow dcbb41bc2f add IBM Plex license info 2021-12-11 21:18:53 -05:00
extern GUI: instrument selector 2021-12-11 16:44:02 -05:00
papers add IBM Plex license info 2021-12-11 21:18:53 -05:00
src GUI: prepare for standard ins editor 2021-12-11 17:49:55 -05:00
.gitignore update gitignore 2021-12-07 13:48:54 -05:00
.gitmodules GUI: instrument selector 2021-12-11 16:44:02 -05:00
CMakeLists.txt GUI: a rough FM ins editor 2021-12-11 17:41:32 -05:00
LICENSE add license 2021-05-13 03:37:04 -05:00
README.md aaaaa 2021-12-11 13:41:37 -05:00

README.md

Furnace

this is a player for DefleMask module files (.dmf).

features

  • supports Sega Genesis, Master System, Game Boy, PC Engine, NES, C64, YM2151/PCM and Neo Geo!
  • clean-room design (zero reverse-engineered code and zero decompilation; using official DMF specs, guesswork and ABX tests only)
  • bug/quirk implementation for increased playback accuracy
  • accurate emulation cores whether possible (Nuked, MAME, SameBoy, Mednafen PCE, puNES, reSID and ymfm)
  • open-source. GPLv2.

dependencies

  • CMake
  • SDL2
  • zlib
  • JACK (optional)

SDL2 and zlib are included as submodules for Windows and macOS.

compilation

your typical CMake project. clone (including submodules) and:

Windows using MSVC

from the developer tools command prompt:

mkdir build
cd build
cmake ..
msbuild ALL_BUILD.vcxproj

macOS and Linux

mkdir build
cd build
cmake ..
make

usage

./furnace <file>

this will play a .dmf file.

./furnace -view commands <file>

this will play a .dmf file and enable the commands view.

./furnace -loops 0 <file>

this will play a .dmf file and not loop it.

./furnace -output audio.wav <file>

this will render a .dmf file to .wav.

notes

my song plays different after looping!

that's because Furnace does not reset channel status when looping.

my song sounds very odd at a certain point

file a bug report. use the Issues page.

it's probably another playback inaccuracy.

extremely high CPU usage in arcade platform

yep, that's how accurate Nuked is. I'll add an ymfm-based core soon.