Scroll to navigation

FCEUX(6) Games Manual FCEUX(6)


fceux - An emulator for the original (8-bit) Nintendo / Famicom game console.


fceux [options] "filename"


FCEUX is an emulator for the original (8-bit) Nintendo Entertainment System (NES). It has a robust color palette rendering engine that is fully customizable, along with excellent sound and joystick support, and even supports movie recording and playback.


Misc. Options

Use default config file and do not save to it, when enabled.
Enable or disable emulated Game Genie.
Enable or disable the GTK GUI.
Loads lua script from filename FILE.

Emulation Options

Enable or disable PAL mode.

Input Options

Configures input device DEV on startup. Devices: gamepad powerpad hypershot quizking
Set which input device to emulate for input 1 or 2. Devices: gamepad zapper powerpad.0 powerpad.1 arkanoid
Set the famicom expansion device to emulate for input 3 or 4. Devices: quizking hypershot mahjong toprider ftrainer familykeyboard oekakids arkanoid shadow bworld 4player
Enable or disable input display.
Enable or disable fourscore emulation.

Graphics Options

Enable or disable the new PPU core. (WARNING: May break savestates)
Set NUM of frames to skip per emulated frame.
Enable or disable clipping of the leftmost and rightmost 8 columns of the video output.
Set the first scanline to be rendered.
Set the last scanline to be rendered.
When set to 0, this disables the normal 8 sprites per scanline limitation. When set to 1, this enables the normal 8 sprites per scanline limitation. NOTE: Yes, this option is 'backwards'.
Set horizontal resolution for full screen mode.
Set vertical resolution for full screen mode.
Enable or disable double buffering.
Enable or disable autoscaling in fullscreen.
Keep native NES aspect ratio when autoscaling.
--{x|y}scale VAL
Multiply width/height by VAL. (Real numbers > 0 with OpenGL, otherwise integers > 0).
--{x|y}stretch {0|1}
Stretch to fill surface on x/y axis (OpenGL only).
Set bits per pixel.
Enable or disable OpenGL support.
Enable or disable OpenGL linear interpolation.
Enable or disable full-screen mode.
Hide title bar and window decorations.
Use special video scaling filters. (1 = hq2x 2 = Scale2x 3 = NTSC 2x 4 = hq3x 5 = Scale3x)
Use the custom palette in FILE.
Enable or disable NTSC NES colors.
Set the NTSC tint.
Set the NTSC hue.

Sound Options

Enable or disable sound.
Set the sound playback sample rate (0 == off?).
Set sound quality. (0 = Low 1 = High 2 = Very High)
Set sound buffer size to MS milliseconds.
Sets the sound volume to the given value, where 256 is max volume.
Sets the sound volume of the triangle wave to the given value, where 256 is max volume.
Sets the sound volume of square wave 1 to the given value, where 256 is max volume.
Sets the sound volume of square wave 2 to the given value, where 256 is max volume.
Sets the sound volume of the noise generator to the given value, where 256 is max volume.
Enables or disables lowpass filtering of the sound.
Record sound to file FILE.

Movie Options

Play back a recorded FCM/FM2 movie from filename FILE.
Pause movie playback at frame FRAME.
Enable or disable movie messages.
Convert fcm movie file FILE to fm2.
Convert movie's subtitles to srt.
Enable or disable subtitle display.

Networking Options

Connect to server SRV for TCP/IP network play.
Use TCP/IP port PORT for network play.
Set the nickname to use in network play.
Set password to use for connecting to the server.
Use string NETKEY to create a unique session for the game loaded.
Set the number of local players.
If enabled, replace Port 2 Start with microphone (Famicom).
Calls mencoder to grab the video and audio streams to encode them. Check the documentation for more on this.?
Mutes FCEUX while still passing the audio stream to mencoder.


FCEUX has a number of commands available within the emulator. It also includes default keyboard bindings when emulating game pads or power pads.

Gamepad Keyboard Bindings

NES Gamepad Keyboard
Up Keypad Up
Down Keypad Down
Left Keypad Left
Right Keypad Right
Select S
Start Enter

Other Commands

Toggle full-screen mode.
Cheat menu (command-line only).
Toggle savestate binding to movies.
Load LUA script.
Toggles background rendering.
Save game state into current slot (set using number keys).
Restore game state from current slot (set using number keys).
Toggle movie subtitles.
Reset NES.
Save screen snapshot.
Beging recording video.
Load recorded video.
Select save state slot.
Select next/previous state.
Decrease emulation speed.
Increase emulation speed.
Hold for turbo emulation speed.
Pause emulation.
Advance a single frame.
Toggle movie frame counter.
Toggle input display.
Toggle movie read-only.
Advance a single frame.
Lag counter display.
Frame advance lag skip display.

VS Unisystem Commands

Insert coin.
Show/Hide dip switches.
Toggle dip switches (when dip switches are shown).

Famicom Disk System Commands

Select disk and disk side.
Eject or insert disk.
The FCEUX project homepage.


This manual page was written by Joe Nahmias <joe _at_>, Lukas Sabota <ltsmooth42 _at_> and Alexander Toresson <alexander.toresson _at_> for the Debian GNU/Linux system (but may be used by others).

June 24, 2012