Synopsis
Description
Furnace is a chiptune tracker that supports many systems and sound chips from the 8/16-bit era.Usage
Starting Furnace without arguments will start the graphical user interface (GUI), as long as Furnace has been compiled with GUI enabled. Passing the path to a file will open that file at start-up. If Furnace cannot open that file, it will report an error and quit.General Parameters
Display help information.
Enable command-line interface (CLI) player. See the CLI section below for controls.
Set the logging level.Options:
error: Critical errors onlywarning: Errors and warningsinfo: Errors, warnings, and useful informationdebug: All of the above, including debug informationtrace: Like debug, but with even more details (default)
Get information about a song. You must provide a file, otherwise Furnace will quit.
Display version information.
View warranty disclaimer.
Engine Parameters
Override audio backend.Options:
sdl: SDL (default)jack: JACK Audio Connection Kitportaudio: PortAudio
Set visualization of data.Options:
pattern: Order and patterncommands: Engine commandsnothing: Guess (default)
Set number of loops.
-1 means loop forever.Set sub-song to play.
Enable safe mode (software rendering without audio).
Enable safe mode (software rendering with audio).
Run performance test and output total time.Options:
render: Measure render timeseek: Measure time to seek through the entire song
Audio Export
Export audio in .wav format to the specified path. You must provide a file, otherwise Furnace will quit.
Set audio export output mode.Options:
one: Single file (default)persys: One file per chip (_sXXwill be appended to file name, whereXXis the chip number)perchan: One file per channel (_cXXwill be appended to file name, whereXXis the channel number)
VGM Export
Output VGM data to the specified path. You must provide a file, otherwise Furnace will quit.
Enable VGM export direct stream mode. This mode is useful for DualPCM export.
Other Export Formats
Output command stream dump to the specified path. You must provide a file, otherwise Furnace will quit.
Output ROM file export to the specified path. You must provide a file, otherwise Furnace will quit.
There must be an available ROM export target for the system.
Set a configuration parameter for
-romout in key=value format. You may use this multiple times to set multiple parameters.Output text file export to the specified path. You must provide a file, otherwise Furnace will quit.
ROM Export Configuration
Amiga Validation
No parameters.Commander X16 ZSM
zsmrate: Tick rate (Hz), default:60loop: Loop song, default:trueoptimize: Optimize size, default:true
Atari 2600 (TIunA)
baseLabel: Base song label name, default:songfirstBankSize: Max size in first bank, default:3072otherBankSize: Max size in other banks, default:4048sysToExport: TIA chip index, default:-1(find first)
Atari 8-bit SAP-R
No parameters.Command Line Interface
Furnace provides a command-line interface (CLI) player which may be activated through the-console option.
CLI Controls
The following controls may be used:| Key | Action |
|---|---|
Left / H | Go to previous order |
Right / L | Go to next order |
Space | Pause/resume playback |