FamiStudio — Full Operations Manual

1. The 5 NES Channels — Complete Technical Breakdown

The original Nintendo Entertainment System had exactly 5 audio channels generated by the Ricoh 2A03 (NTSC) or 2A07 (PAL) processor. FamiStudio emulates all of them faithfully. Understanding these channels — their capabilities AND their limitations — is understanding the art of 8-bit music.

Pulse Channel 1 & Pulse Channel 2

• Two identical square wave generators. These are the melodic voices of the NES — leads, harmonies, counter-melodies, chords (via arpeggio), and sometimes bass.
• 4 Duty Cycles: Each pulse channel can produce 4 different waveform shapes:
  • 12.5%: Very thin, nasal, buzzy. Low harmonic content. Best for background harmonies, thin secondary melodies, and adding brightness without overpowering. Sounds like a clavinet or thin reed instrument.
  • 25%: Brighter and more present than 12.5%. Strong harmonics. Excellent for leads and counter-melodies. The most commonly used duty cycle for foreground melodies in NES games.
  • 50%: Pure hollow square wave. The most recognizable "8-bit" sound. Equal time high and low. Strong, bold, unmistakable. Mario, Zelda, Mega Man — this is the sound people picture when they think "NES music."
  • 75%: Identical to 25% (inverted phase, same harmonic content). Used interchangeably. Some composers switch between 25% and 75% in duty cycle envelopes for subtle timbral variation.
• Volume: 16 levels (0-15). 0 = silent. 15 = maximum. Volume can be set per frame (60 fps on NTSC) via instrument envelopes for dynamic volume animation.
• Monophonic: Each pulse channel plays ONE note at a time. For harmony, use both channels simultaneously — melody on Pulse 1, harmony on Pulse 2. For simulated chords on a single channel, use arpeggio envelopes (see Section 2).
• Pitch range: A0 (27.5 Hz) to approximately B7 (3951 Hz) with some limitations at extreme registers. Most NES music stays in the A2-C6 range for clean playback.

Triangle Channel

• Generates a triangle wave — softer, rounder than the pulse channels. Used primarily for bass lines and occasionally for low melody.
• Critical limitation: NO volume control. The triangle channel is either ON (full volume) or OFF. There is no quiet triangle — it plays at the same level always. This means:
  • You cannot create dynamics (loud/soft) on the triangle. Every note is equally loud.
  • Composers simulate volume changes using rapid note-offs — alternating between playing and silence at varying speeds creates a perceived fade effect.
  • The "linearity" of the triangle's volume is actually part of its character. The bass sits at a consistent level in the mix, which anchors everything above it.
• The warm NES bass sound: Every bass line in every NES game is this channel. Mario underground theme. Mega Man stage select. Castlevania opening. The triangle's round, warm tone is the sonic foundation of the entire console.
• Octave range: Works best in the bass register (C1-C3). Can play higher but sounds increasingly thin and loses its characteristic warmth above C4.

Noise Channel

• Pseudo-random noise generator — the percussion section of the NES.
• 16 pitch settings: Lower numbers = higher pitched noise (hi-hats, shakers, metallic tics). Higher numbers = lower pitched (kicks, toms, rumble, explosions).
• Two modes:
  • Normal (long): Standard white noise with metallic, buzzy character. The default for hi-hats, snares, and most percussion.
  • Periodic (short): Shorter noise loop creating a tonal, pitched quality. Sounds more like a buzz or hum. Used for unique percussion timbres, tonal noise effects, and certain snare characters.
• Volume: 16 levels like the pulse channels. Allows dynamic percussion — ghost note hi-hats at low volume, accented snares at high volume.
• Length counter: Optional automatic note-off after a specified duration. Creates tight, controlled percussion hits.
• All NES percussion comes from this one channel. Kick drums, snares, hi-hats, claps, cymbal crashes, explosions, wind effects — all from the same noise generator with different pitch settings, volume envelopes, and lengths.

DPCM Channel (Delta Pulse Code Modulation)

• The NES's sample playback channel — loads tiny audio samples (1-bit delta-modulated) for sounds that the other channels can't produce.
• Common uses: Kick drum samples (for a heavier kick than noise can produce), vocal stabs ("yeah!", "fire!", character grunts), orchestra hits, sound effects, and occasionally very short melodic samples.
• Sample rates: 16 pitch settings controlling playback speed (approximately 4-33 kHz). Lower rates = more aliasing and crunch (the iconic NES sample sound). Higher rates = cleaner but use more ROM space.
• Size constraints: DPCM samples must be small — they live in the cartridge ROM. Typical samples are 0.5-2 seconds long. The crunch and brevity are intentional artifacts of the hardware.
• Important technical note: The DPCM channel shares hardware timer resources with the Noise channel. Playing DPCM samples can cause slight pitch interference with the Noise channel. Experienced composers plan around this — avoid critical noise hits during DPCM playback, or use the interference creatively.

2. Creating Instruments — Frame-by-Frame Design

NES instruments are not presets or samples — they are custom envelopes designed frame by frame at 60 frames per second (NTSC). Each instrument is a set of instructions telling the channel how to behave over time.

Volume Envelope

• Draw volume values (0-15) per frame. This IS the instrument's amplitude shape.
• Pluck/stab: Frame 1 = 15, Frame 2 = 10, Frame 3 = 6, Frame 4 = 3, Frame 5 = 1, Frame 6 = 0. Fast decay creates a percussive pluck.
• Sustained tone: Frame 1 = 12, then hold at 12 indefinitely (loop). Organ-like sustain.
• Echo/tremolo: 15, 0, 8, 0, 4, 0. Alternating volume creates perceived echo. 12, 8, 12, 8 (looped) creates tremolo.
• Fade-in: 0, 2, 4, 6, 8, 10, 12. Gradual volume increase — string swell, pad entrance.
• Swell + decay: 0, 3, 6, 9, 12, 15, 12, 9, 6, 3, 0. Triangle-shaped volume curve — sounds like a bowed instrument.

Pitch Envelope

• Pitch offset per frame in fine pitch units. Modifies the note's frequency over time.
• Attack blip: Frame 1 = +2, Frame 2 = 0. Starts slightly sharp, bends down to pitch. Gives notes a percussive "blip" attack. Subtle values (+1 or +2) sound natural. Large values (+12) sound like a sci-fi laser.
• Vibrato: +1, 0, -1, 0 (looped). Rapid oscillation above and below the base pitch. Speed depends on how many frames per cycle. Fewer frames = faster vibrato.
• Portamento/slide: Gradual pitch change — +1 per frame slides upward continuously. -1 per frame slides down. Use for sliding bass lines, pitch bends, and connecting notes smoothly.
• Octave jump: +12, 0, +12, 0 (looped). Rapidly alternates between the note and one octave above. Creates a shimmering, doubled quality.

Arpeggio Envelope

• THE technique for faking polyphony on a monophonic channel.
• Cycles between relative pitch offsets at 60 fps. The ear perceives simultaneous notes even though only one plays at a time.
• Major chord: 0, 4, 7 (looped). Root → major third → perfect fifth. Rapid cycling sounds like a C major chord from a single channel.
• Minor chord: 0, 3, 7 (looped). Root → minor third → perfect fifth.
• Power chord: 0, 7 (looped). Root → fifth. Heavy, strong, two-note chord.
• Octave: 0, 12 (looped). Root and octave. Fuller, doubled sound.
• Major 7th chord: 0, 4, 7, 11 (looped). Root → major third → fifth → major seventh. Jazz/dreamy quality.
• Speed matters: At 60 fps, a 3-value arpeggio (0, 4, 7) cycles 20 times per second. The brain blends this into a perceived chord. If you slow it down (by using the speed effect), individual notes become audible as a melodic pattern instead. Fast = chord. Slow = arpeggio sequence.

Duty Cycle Envelope (Pulse Channels Only)

• Cycle between duty cycles per frame: 50%, 25%, 12.5%, 25% (looped).
• Creates timbral animation — the sound's harmonic character changes over time. A static 50% square wave is flat and boring. Cycling duty cycles makes it buzz, shimmer, and breathe.
• This is the difference between amateur chiptune (static single duty cycle) and professional chiptune (animated, evolving duty cycles). Master this technique.

3. Composing

• Piano roll interface: Draw notes on a grid per channel. All 5 (or more with expansion) channels visible as horizontal rows simultaneously. See the full score at a glance.
• Select an instrument from the instrument list before drawing notes. Different instruments on the same channel produce different sounds (different envelope behaviors).
• Per-note effects (columns next to each note):
  • Speed: Change playback speed mid-song for tempo variations, ritardandos, accelerandos.
  • Pitch slide (portamento): Slide from one note to another over a specified number of frames. Creates smooth connected bass lines, vocal-like glides, and expressive transitions.
  • Volume slide: Gradual volume change per note. Crescendo/decrescendo within a single held note.
  • Vibrato: Periodic pitch oscillation with configurable speed and depth. Adds expression and life to sustained notes.
  • Arpeggio (inline): Rapid cycling between pitch offsets without using an instrument arpeggio envelope. Quick chord effects on specific notes.
  • Note delay: Offset a note's start by specified frames. Creates swing/groove feel. Delay value of 2-3 frames on alternating notes = subtle human-like timing variation.
  • Note cut: Cut a note after specified frames. Creates staccato effects — the note starts but is forcibly silenced before the next note begins.
• Pattern system: Songs are built from reusable patterns (typically 16-64 rows). Each pattern can be placed at multiple positions in the song. Edit one instance and ALL copies update. This saves memory (authentic to real NES cartridge constraints) and speeds up composition enormously.

4. Mobile vs Desktop

Desktop (Windows / Mac / Linux)

• Mouse + keyboard for fastest editing. Full keyboard shortcuts. MIDI input from MPK Mini IV for real-time note entry. Larger screen shows more channels and patterns. Better for complex compositions with expansion chips.

Mobile (Android / iOS)

• Touch interface — tap to place notes, drag to move, pinch to zoom. Portable composition — write chiptune anywhere. Smaller screen requires more scrolling. No MIDI input. Best for sketching ideas to refine on desktop.

Cross-Platform Workflow

• Same file format on all platforms. Start on mobile → transfer to desktop via cloud/email → continue editing. Ideas captured anywhere, refined at the desk.

5. Quantize

• FamiStudio's piano roll IS the quantize grid. Notes snap to row positions when placed.
• Resolution depends on Speed setting. Default speed 6 gives 8 rows per beat ≈ 1/32 note resolution at standard tempos.
• Swing feel: Use the Note Delay effect on alternating notes. Delay value 2-3 frames pushes notes slightly late. Creates groove/shuffle within the rigid NES timing grid.

6. Transpose

• Select notes → drag up/down on the piano roll. Or Transpose function for exact semitone values.
• Pattern-level: Transpose an entire pattern without editing individual notes. Change key for chorus or bridge.
• Instrument-level: Constant pitch offset in the arpeggio envelope acts as instrument transposition. All notes played with that instrument shift by the offset.

7. Looping

• Patterns loop automatically during editing playback.
• Song loop point: Set a loop marker in the song. Playback jumps back when it reaches the end — exactly how NES game music works. Intro plays once → main section loops forever.
• Pattern reuse = looping. Place the same pattern at multiple song positions. It plays identically each time. Edit one instance → all update.
• Making channels stop: Create empty patterns for channels that should be silent at certain points. Place the empty pattern where silence is needed while other channels continue.

8. Expansion Audio — 6 Additional Sound Chips

Certain NES/Famicom cartridges contained additional sound hardware. FamiStudio supports all major expansion chips:

• VRC6 (Konami): +2 pulse channels (with full duty cycle control including sawtooth!) + 1 sawtooth channel. Used in Castlevania III (Japan) and Madara. The sawtooth channel gives a completely new timbral option — buzzy, bright, aggressive. 8 channels total with VRC6.
• VRC7 (Konami): +6 FM synthesis channels. Used in Lagrange Point. Each channel uses 2-operator FM — the same mathematical principle as the Yamaha DX7 but simpler. 15 built-in instrument presets (piano, guitar, flute, etc.) plus 1 user-definable custom instrument. 11 channels total. FM adds electric pianos, organs, and timbres impossible with pulse/triangle.
• FDS (Famicom Disk System): +1 wavetable channel. Custom 64-sample waveforms allow ANY waveshape. Draw your own waveforms for unique timbres impossible with standard square/triangle. Used in many FDS games (Zelda, Metroid, Kid Icarus on FDS). 6 channels total.
• N163 (Namco): Up to +8 wavetable channels (typically 1-4 used due to CPU constraints). Each channel has its own custom waveform. Used in late Namco games. Massive sound expansion — up to 13 channels total. The most channels available on any NES expansion.
• S5B (Sunsoft 5B): +3 square wave channels with hardware envelope generator (automatic volume shapes without software envelopes). Based on the AY-3-8910 chip. Used in Gimmick! — one of the best-sounding NES games ever made. 8 channels total.
• EPSM (Extended Platform Sound Module): YM2612 FM synthesis — the SEGA GENESIS sound chip! Full 6-channel FM synthesis with 4-operator algorithms. Design FM patches with the same engine that powered Sonic the Hedgehog, Streets of Rage, and every Genesis game. Combine NES pulse/triangle channels with Genesis FM for a hybrid sound nobody has heard before. This is the wildest expansion option — two console architectures in one composition.

9. Mixing

FamiStudio doesn't have a traditional mixer — the NES chip handles audio internally. But mixing control exists:

• Volume envelopes ARE the mix. Each instrument's volume envelope determines its loudness. Louder instruments = higher envelope values. Background parts = lower values.
• Channel balance: The relative volume of channels is controlled by instrument design. Make the lead pulse loud (values 12-15) and the harmony pulse quieter (values 8-10) for depth.
• Expansion chip volumes: Some chips (VRC6, N163, FDS) have per-channel volume control. Adjust during composition for dynamic balance.
• Volume slide effects: Fade channels in/out during the song. Build tension with crescendos. Create space with diminuendos.
• Stereo panning (export only): When exporting to WAV, FamiStudio can pan channels left/right for a stereo mix. Real NES is mono, but WAV exports can be stereo for modern listening.

10. Exporting

• WAV: Standard audio file. Use anywhere — SoundCloud, YouTube, BandLab, import into any DAW.
• NSF: Native NES Sound Format. Playable on NES emulators AND real NES hardware via flash cartridges (EverDrive N8 Pro, PowerPak). The authentic format.
• MIDI: Each NES channel → MIDI channel. Import into Cubase, Ableton, Bitwig, FL Studio. NES compositions become MIDI data assignable to any synth plugin.
• ROM: Actual NES ROM file. Load onto a flash cartridge → insert into a real NES console → the music plays on real hardware. The ultimate output — original music on original hardware.
• Video: Export with animated piano roll visualization showing every note as it plays. Channel colors, note movements, scrolling timeline. Ready for YouTube — these videos consistently get strong views in the chiptune community.
• FamiTracker Text: Import/export compatibility with the classic FamiTracker format for sharing with other chiptune composers and legacy project conversion.

11. Keyboard Shortcuts

12. Pro Tips — The Kokumo Method

• Study NES soundtracks — they are the textbook. Load NSF files from Mega Man 2, Castlevania III, Super Mario Bros 3, Kirby's Adventure, Silver Surfer, Journey to Silius, Shatterhand, Sunsoft Batman. Each game demonstrates different composition techniques within the same 5-channel constraints. These composers were geniuses — study their work.
• Arpeggios are your polyphony. Can't play chords? 0-4-7 cycling at 60 fps sounds like a major chord. 0-3-7 for minor. This is THE foundational technique of NES harmony. Without arpeggios, you have monophonic melody. With them, you have implied harmony from a single channel.
• The Triangle channel is sacred. It's the only bass. No volume control. Give it space — don't clutter it with fast runs. Let the bass breathe. The bass grounds the entire composition. Respect it.
• Duty cycle envelopes separate amateur from professional. A static 50% square wave is flat. Cycling between 50% → 25% → 12.5% → 25% per frame adds timbral animation — the sound moves, breathes, has character. This one technique transforms flat chiptune into living music.
• Use expansion chips when needed. VRC6 adds sawtooth bass (freeing Triangle for melody). VRC7 adds FM pianos and organs. EPSM adds the entire Genesis sound palette. Don't limit yourself to 5 channels if the music needs more.
• Export to ROM. Flash cartridges exist. Put original music on a real NES cartridge. Hand it to someone. Watch their face when original composition plays on real 1985 hardware. There is no cooler flex in all of music production.
• FamiStudio is free and open source. No trial. No feature locks. No subscription. Download it, learn it, master it. The entire chiptune community — from hobbyists to professional game composers — uses this tool.