furnace/doc/2-interface/menu-bar.md

menu bar

the menu bar allows you to select from five menus: file, edit, settings, window and help.

items in italic don't appear in basic mode and are only available in advanced mode.

file

• new...: creates a new song.

• open...: opens the file picker, allowing you to select a song to open.

  • see file formats for a list of formats Furnace is able to open.

• open recent: contains a list of the songs you've opened before.

  • clear history: erases the file history.

• save: saves the current song.

  • opens the file picker if this is a new song, or a backup.

• save as...: opens the file picker, allowing you to save the song under a different name.

• export: allows you to export your song into other formats, such as audio files, VGM and more. see the export page for more information.

• manage chips: opens the Chip Manager dialog.

• restore backup: restores a previously saved backup.

  • Furnace keeps up to 5 backups of a song.
  • the backup directory is located in:
    • Windows: %USERPROFILE%\AppData\Roaming\furnace\backups
    • macOS: ~/Library/Application Support/Furnace/backups
    • Linux/other: ~/.config/furnace/backups
  • this directory grows in size as you use Furnace. remember to delete old backups periodically to save space.
  • do NOT rely on the backup system as auto-save! you should save a restored backup because Furnace will not save backups of backups.

• exit: closes Furnace.

edit

• ...: does nothing except prevent accidental clicks on later menu items if the menu is too tall to fit on the program window.

• undo: reverts the last action.

• redo: repeats what you undid previously.

• cut: moves the current selection in the pattern view to clipboard.

• copy: copies the current selection in the pattern view to clipboard.

• paste: inserts the clipboard's contents in the cursor position.

  • you may be able to paste from OpenMPT as well.

• paste special...: variants of the paste feature.

  • paste mix: inserts the clipboard's contents in the cursor position, but does not erase the occupied region.
  • paste mix (background): does the same thing as paste mix, but doesn't alter content which is already there.
  • paste with ins (foreground): same thing as paste mix, but changes the instrument.
  • paste with ins (background): same thing as paste mix (background), but changes the instrument.
  • paste flood: inserts the clipboard's contents in the cursor position, and repeats until it hits the end of a pattern.
  • paste overflow: paste, but it will keep pasting even if it runs over another pattern.

• delete: clears the contents in the selection.

• select all: changes the selection so it covers a larger area.

  • if the selection is wide, it will select the rows in a column.
  • if the selection is tall, it will select the entire column.
  • if a column is already selected, it will select the entire channel.
  • if a channel is already selected, it will select the entire pattern.

• operation mask: toggles which columns will be affected by the listed operations. more information here.

• input latch: determines which data are placed along with a note. more information here.

• note/octave up/down: transposes notes in the current selection.

• values up/down: changes values in the current selection by ±1 or ±16.

• transpose: transpose notes or change values by a specific amount.

• interpolate: fills in gaps in the selection by interpolation between values.

• change instrument: changes the instrument number in a selection.

• gradient/fade: replace the selection with a "gradient" that goes from the beginning of the selection to the end.

  • does not affect the note column.
  • Nibble mode: when enabled, the fade will be per-nibble (0 to F) rather than per-value (00 to FF).
    • use for effects like 04xy (vibrato).

• scale: scales values in the selection by a specific amount.

  • use to change volume in a selection for example.

• randomize: replaces the selection with random values.

  • does not affect the note column.

• invert values: 00 becomes FF, 01 becomes FE, 02 becomes FD and so on.

• flip selection: flips the selection so it is backwards.

• collapse/expand amount: allows you to specify how much to collapse/expand in the next two menu items.

• collapse: shrinks the selected contents.

• expand: expands the selected contents.

• collapse pattern: same as collapse, but affects the entire pattern.

• expand pattern: same as expand, but affects the entire pattern.

• collapse song: same as collapse, but affects the entire song.

  • it also changes speeds and pattern length to compensate.

• expand song: same as expand, but affects the entire song.

  • it also changes speeds and pattern length to compensate.

• find/replace: shows the Find/Replace window.

• clear: opens a window that allows you to mass-delete things like songs, unused instruments, and the like.

settings

• full screen: expands the Furnace window so it covers your screen.
• lock layout: prevents you from dragging/resizing docked windows, or docking more.
• basic mode: toggles Basic Mode.
• visualizer: toggles pattern view particle effects when the song plays.
• reset layout: resets the workspace to its defaults.
• settings...: shows the Settings window. these are detailed in [settings.md].

window

all these menu items show or hide their associated windows.

• song information

• subsongs

• speed

• instruments

• wavetables

• samples

• orders

• pattern

• mixer

• grooves

• channels

• pattern manager

• chip manager

• compatibility flags

• song comments

• piano

• oscilloscope

• oscilloscopes (per-channel)

• clock

• register view

• log viewer

• stats

help

• effect list: displays the effect list.
• debug menu: this menu contains various debug utilities.
  • unless you are working with the Furnace codebase, it's not useful.
• inspector: this option shows the Dear ImGui Metrics/Debugger window.
  • unless you are working with the Furnace codebase, it's not useful.
• panic: this resets all chips while the song is playing, effectively silencing everything.
• about...: displays the About screen.

at the end of the menu bar, more information may be shown:

• during editing, information about the data under the cursor will be shown here:
  • note or note modifier.
  • instrument number and name.
  • volume in decimal, hex, and percentage.
  • effect type and description.
• during playback, these values will be displayed:
  • speed/groove @ tick rate (BPM) | order | row | elapsed time
• if any changes or edits have been made but not yet saved, "modified" will appear.