A FamiStudio project contains:
- A list of Songs
- A list of Instruments
- A list of DPCM samples
Songs are made of Patterns, which are on one of the five Channels supported by the NES. Patterns contain Notes which are played by an Instrument (DPCM samples do not require an instrument). Instruments may have some of their attributes (pitch, volume, arpeggio) modulated by Envelopes.
Most of the operations are performed with the mouse. In general:
- The left mouse button adds stuff, double-clicking something edits properties (songs, patterns, instruments, DPCM)
- The right mouse button removes stuff. Right clicking in the header of the Sequencer or Piano Roll selects.
- The middle mouse button pans when you press it and zooms and you use the mouse wheel.
Alternatively, if your mouse does not have a middle mouse button or mouse wheel:
- All actions requiring pressing the middle mouse buttons can be done with Alt+Left click.
- All actions requiring the mouse wheel can be performed with Alt+Right click, then dragging up/down.
If you are working on a trackpad, please check out how to enable Trackpad controls in the configuration dialog.
The UI was designed to be a simple as possible, there are almost no context menus.
The main window has 4 main components:
- The Toolbar (on top)
- The Project Explorer (on the right) is where you add/remove/edit songs and instruments.
- The Sequencer (below the toolbar) is where you schedule your patterns on one of the 5 channels. It gives a high-level view of the song.
- The Piano Roll (below the sequencer) is where you edit your patterns.
At any given moment there is always:
- A selected channel, in bold in the sequencer
- A selected song, in bold in the project explorer song list
- A selected instrument, in bold in the project explorer instrument list.
The sequencer and piano roll will display the information for the currently selected song. When pressing the keys on the piano roll, it will play notes for the currently selected instrument, and output it on the currently selected channel. The same applies if you have a MIDI keyboard connected.
The main toolbar contains your usual stuff: file operation, undo/redo, timecode and play control.
Keyboard shortcuts or special actions are always displayed as tooltips in the upper-right corner of the toolbar. Please keep an eye on it to learn new functionalities.
Playing/pausing the song
Besides the toolbar, space bar is used to play/pause the song. Ctrl-space plays in pattern loop mode, Shift-space plays in song loop mode.
Changing the looping mode
There are 3 looping modes:
- Song: loops the entire song
- Pattern: loops at the end of the current pattern
- None: stops at the end of the song
Saving the project
Clicking on the icon save the project, right-clicking is a "save as..." and will prompt you for a new filename.
Exporting to various formats
Please see the Import/Export section for details on how to export to various formats.
Please see the Cleanup section for details on how to cleanup your project.
Please see the Configuration section for details on how to configure FamiStudio.
The project explorer displays the list of songs and instruments in the current project.
The sequencer is where you organize the high-level structure of the song: which patterns play and when they play. The thumbnails of the patterns in the sequencer are by no mean accurate. Please visit the Editing Patterns section for more details.
The piano roll is where you editing the actual notes of the song, the instrument envelopes, as well as some special effects.
Please check out the Editing Notes section for more details.
Here is a list of useful keyboard shortcuts:
- Space: Play/stop the stop
- Ctrl+Space: Plays from beginning of current pattern.
- Shift+Space: Plays from beginning of the song.
- Home: Seeks back to beginning of the song.
- Ctrl+Home: Seeks to beginning of the current pattern.
- Esc: Stops any stop, clears the selection.
- Ctrl+Z: Undo
- Ctrl+Y: Redo
- Ctrl+N: New project
- Ctrl+S: Save
- Ctrl+E: Export
- Ctrl+O: Open
- Delete: Delete selected patterns or notes.
- Escape: Deselects patterns or notes, stops any sound that is stuck playing.
- 1...5: Changes the active channel (more than 5 if you have expansion audio enabled).
- Ctrl+1...5: Force display a channel. (more than 5 if you have expansion audio enabled).
Some keyboard shortcuts specific to the sequencer:
- L+Click: Sets the loop point at the clicked pattern.
Some keyboard shortcuts specific to the piano roll:
- Ctrl+Click: Adds a stop note.
- Shift+Click: Adds a release note.
- S+Click (and drag): Creates or edit a slide note.
- A+Click: Toggles the attack of a note.
- ~ (Tilde): Expand/collapse the effect panel.
- Shift+S: Toggles snapping.