| 
				 | 
			||
|---|---|---|
| demos | ||
| extern | ||
| papers | ||
| res | ||
| scripts | ||
| src | ||
| .gitignore | ||
| .gitmodules | ||
| CMakeLists.txt | ||
| LICENSE | ||
| README.md | ||
Furnace
this is a work-in-progress chiptune tracker compatible with DefleMask modules (.dmf).
features
- supports the following systems:
- Sega Genesis
 - Sega Master System
 - Game Boy
 - PC Engine
 - NES
 - Commodore 64
 - Yamaha YM2151 (plus PCM)
 - Neo Geo
 - AY-3-8910 (ZX Spectrum, Atari ST, etc.)
 - Microchip AY8930
 - Philips SAA1099
 - Amiga
 - TIA (Atari 2600/7800)
 
 - multiple sound chips in a single song!
 - 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, Stella and ymfm)
 - additional features on top:
- SSG envelopes in Neo Geo
 - full duty/cutoff range in C64
 - ability to change tempo mid-song with 
Cxxxeffect (xxxbetween000and3fff) 
 - open-source. GPLv2.
 
downloads
check out the Releases page. available for Windows, macOS and Linux (AppImage).
help
check out the documentation. it's mostly incomplete, but has details on effects.
developer info
dependencies
- CMake
 - SDL2
 - zlib
 - JACK (optional)
 
SDL2 and zlib are included as submodules.
compilation
your typical CMake project. clone (including submodules) and:
Windows using MSVC
no longer tested! as of now tildearrow uses MinGW for Windows builds...
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
this opens the program.
./furnace -console <file>
this will play a compatible file.
./furnace -console -view commands <file>
this will play a compatible file and enable the commands view.
notes
how do I use Neo Geo SSG envelopes?
the following effects are provided:
22xy: set envelope mode.xsets the envelope shape, which may be one of the following:0: \___decay4: /___attack once8: \\\\saw9: \___decayA: \/\/inverse obeliscoB: \¯¯¯decay onceC: ////inverse sawD: /¯¯¯attackE: /\/\obeliscoF: /___attack once
- if 
yis 1 then the envelope will affect this channel. 
23xx: set envelope period low byte.24xx: set envelope period high byte.25xx: slide envelope period up.26xx: slide envelope period down.
a lower envelope period will make the envelope run faster.
how do I use C64 absolute filter/duty?
on Instrument Editor in the C64 tab there are two options to toggle these. also provided are two effects:
3xxx: set fine duty.4xxx: set fine cutoff.xxxrange is 000-7ff.
my song sounds very odd at a certain point
file a bug report. use the Issues page.
it's probably another playback inaccuracy.
my song sounds correct, but it doesn't in DefleMask
file a bug report here. it still is a playback inaccuracy.
my C64 song sounds terrible after saving as .dmf!
that's a limitation of the DefleMask format. save in Furnace song format instead (.fur).
how do I solo channels?
right click on the channel name.
