etc/furnace
0
0
Fork 0
mirror of https://github.com/tildearrow/furnace.git synced 2024-11-23 13:05:11 +00:00
Code Issues Projects Releases Packages Wiki Activity
Mirror of https://github.com/tildearrow/furnace
379 commits 108 branches 189 tags 200 MiB
C++ 95.8%
C 3.4%
Java 0.5%
CMake 0.1%
Find a file
tildearrow 245a566806 release 0.3 
- all-new Furnace file format
- ability to add multiple sound chips in a single song!
- made more buttons work
- revamped instrument editor
- revamped wavetable editor with custom width/height
- C64 duty/filter macros may now be absolute
- finally! an icon!

after this release, the focus will be on adding features, fixing bugs
and adding new platforms. enjoy!
2022-01-11 03:58:19 -05:00
extern icon fonttttttt 2021-12-21 00:30:55 -05:00
papers prepare for 0.3 2022-01-10 17:30:36 -05:00
res release 0.3 2022-01-11 03:58:19 -05:00
scripts improvements to AppImage release script 2021-12-30 17:58:46 -05:00
src allow moving ins/wave/samples up or down 2022-01-11 03:52:11 -05:00
.gitignore IOJNDKHJGDJLSHFGKJFLAD; 2021-12-29 17:51:51 -05:00
.gitmodules use docking branch 2021-12-13 20:55:40 -05:00
CMakeLists.txt release 0.3 2022-01-11 03:58:19 -05:00
LICENSE add license 2021-05-13 03:37:04 -05:00
README.md update readme 2022-01-11 03:52:26 -05:00

README.md

Furnace

screenshot

this is a work-in-progress chiptune tracker compatible with DefleMask modules (.dmf).

features

  • supports Sega Genesis, Master System, Game Boy, PC Engine, NES, C64, YM2151/PCM and Neo Geo!
  • 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 and ymfm)
  • additional features on top;
    • SSG envelopes in Neo Geo
    • full duty/cutoff range in C64
  • open-source. GPLv2.

downloads

check out the Releases page. available for Windows, macOS and Linux (AppImage).

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 .dmf file.

./furnace -console -view commands <file>

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

./furnace -output audio.wav <file>

this will render a .dmf file to .wav.

notes

how do I use Neo Geo SSG envelopes?

the following effects are provided:

  • 22xy: set envelope mode.
    • x sets the envelope shape, which may be one of the following:
      • 0: \___ decay
      • 4: /___ attack once
      • 8: \\\\ saw
      • 9: \___ decay
      • A: \/\/ inverse obelisco
      • B: \¯¯¯ decay once
      • C: //// inverse saw
      • D: /¯¯¯ attack
      • E: /\/\ obelisco
      • F: /___ attack once
    • if y is 1 then the envelope will affect this channel.
  • 23xx: set envelope period low byte.
  • 24xx: set envelope period high byte.

a lower envelope period will make the envelope run faster.

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).