FCEUX(6)

🎮 fceux — NAME 🎮

okay bestie, gather round, because we're about to talk about fceux — an emulator for the original (8-bit) Nintendo / Famicom game console. 💖

---

🌸 SYNOPSIS 🌸

fceux [options] "filename"

---

✨ DESCRIPTION ✨

So fceux is an emulator for the original (8-bit) Nintendo Entertainment System, aka the NES, aka the cultural moment that raised us all. 👑

She's not just any emulator either — she has a robust color palette rendering engine that is fully customizable, plus excellent sound and joystick support, and she even supports movie recording and playback. It's giving main character energy, fr fr. 🎬

---

💅 OPTIONS 💅

🎀 Misc. Options 🎀

• --no-config {0|1} — when enabled, she uses the default config file and does not save to it. No notes, no receipts. 🙈
• -g {0|1}, --gamegenie {0|1} — turn the emulated Game Genie on or off. ✨
• --nogui {0|1} — enable or disable the GTK GUI.
• --loadlua FILE — loads a lua script from the filename FILE. 🐍

🕹️ Emulation Options 🕹️

• --pal {0|1} — enable or disable PAL mode.

🎮 Input Options 🎮

• -i DEV, --inputcfg DEV — configures input device DEV on startup. Devices: gamepad powerpad hypershot quizking
• --input{1|2} DEV — set which input device to emulate for input 1 or 2. Devices: gamepad zapper powerpad.0 powerpad.1 arkanoid
• --input{3|4} DEV — set the famicom expansion device to emulate for input 3 or 4. Devices: quizking hypershot mahjong toprider ftrainer familykeyboard oekakids arkanoid shadow bworld 4player
• --inputdisplay {0|1} — enable or disable input display.
• --fourscore {0|1} — enable or disable fourscore emulation.

🌈 Graphics Options 🌈

• --newppu {0|1} — enable or disable the new PPU core. > WARNING: May break savestates. bestie I am BEGGING you, save before you mess with this 😭
• --frameskip NUM — set NUM of frames to skip per emulated frame.
• --clipsides {0|1} — enable or disable clipping of the leftmost and rightmost 8 columns of the video output. ✂️
• --slstart SCANLINE — set the first scanline to be rendered.
• --slend SCANLINE — set the last scanline to be rendered.
• --nospritelim {0|1} — 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'. Not me pointing out that this is genuinely chaotic 💀 it's iconic though.
• -x XRES, --xres XRES — set horizontal resolution for full screen mode.
• -y YRES, --yres YRES — set vertical resolution for full screen mode.
• --doublebuf {0|1} — enable or disable double buffering.
• --autoscale {0|1} — enable or disable autoscaling in fullscreen.
• --keepratio {0|1} — keep native NES aspect ratio when autoscaling. (the ratio stays snatched, periodt)
• --{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).
• -b {8|16|24|32}, --bpp {8|16|24|32} — set bits per pixel.
• --opengl {0|1} — enable or disable OpenGL support.
• --openglip {0|1} — enable or disable OpenGL linear interpolation.
• -f {0|1}, --fullscreen {0|1} — enable or disable full-screen mode.
• --noframe {0|1} — hide title bar and window decorations. no chrome, just vibes 🦋
• --special {1-4} — use special video scaling filters. (1 = hq2x 2 = Scale2x 3 = NTSC 2x 4 = hq3x 5 = Scale3x)
• -p FILE, --palette FILE — use the custom palette in FILE. 🎨
• --ntsccolor {0|1} — enable or disable NTSC NES colors.
• --tint VAL — set the NTSC tint.
• --hue VAL — set the NTSC hue.

🎵 Sound Options 🎵

• -s {0|1}, --sound {0|1} — enable or disable sound.
• --soundrate RATE — set the sound playback sample rate (0 == off?).
• --soundq {0|1|2} — set sound quality. (0 = Low 1 = High 2 = Very High)
• --soundbufsize MS — set sound buffer size to MS milliseconds.
• --volume {0-256} — sets the sound volume to the given value, where 256 is max volume.
• --trianglevol {0-256} — sets the sound volume of the triangle wave to the given value, where 256 is max volume. 🔺
• --square1vol {0-256} — sets the sound volume of square wave 1 to the given value, where 256 is max volume. ⬜
• --square2vol {0-256} — sets the sound volume of square wave 2 to the given value, where 256 is max volume. ⬜
• --noisevol {0-256} — sets the sound volume of the noise generator to the given value, where 256 is max volume. 📻
• --lowpass {0|1} — enables or disables lowpass filtering of the sound.
• --soundrecord FILE — record sound to file FILE.

🎬 Movie Options 🎬

• --playmov FILE — play back a recorded FCM/FM2 movie from filename FILE.
• --pauseframe FRAME — pause movie playback at frame FRAME.
• --moviemsg {0|1} — enable or disable movie messages.
• --fcmconvert FILE — convert fcm movie file FILE to fm2.
• --ripsubs FILE — convert movie's subtitles to srt.
• --subtitles {0|1} — enable or disable subtitle display.

🌐 Networking Options 🌐

• -n SRV, --net SRV — connect to server SRV for TCP/IP network play.
• --port PORT — use TCP/IP port PORT for network play.
• -u NICK, --user NICK — set the nickname to use in network play.
• -w PASS, --pass PASS — set password to use for connecting to the server.
• -k NETKEY, --netkey NETKEY — use string NETKEY to create a unique session for the game loaded.
• --players NUM — set the number of local players.
• --rp2mic {0|1} — if enabled, replace Port 2 Start with microphone (Famicom). 🎤
• --videolog c — Calls mencoder to grab the video and audio streams to encode them. Check the documentation for more on this.?
• --mute {0|1} — Mutes FCEUX while still passing the audio stream to mencoder. 🤫

---

⌨️ KEYBOARD COMMANDS ⌨️

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 Up → Keyboard Keypad Up
• NES Gamepad Down → Keyboard Keypad Down
• NES Gamepad Left → Keyboard Keypad Left
• NES Gamepad Right → Keyboard Keypad Right
• NES Gamepad A → Keyboard F
• NES Gamepad B → Keyboard D
• NES Gamepad Select → Keyboard S
• NES Gamepad Start → Keyboard Enter

⭐ Other Commands ⭐

• <Alt+Enter> — Toggle full-screen mode.
• <F1> — Cheat menu (command-line only).
• <F2> — Toggle savestate binding to movies.
• <F3> — Load LUA script.
• <F4> — Toggles background rendering.
• <F5> — Save game state into current slot (set using number keys).
• <F7> — Restore game state from current slot (set using number keys).
• <F10> — Toggle movie subtitles.
• <F11> — Reset NES.
• <F12> — Save screen snapshot. 📸
• Shift+<F5> — Beging recording video.
• Shift+<F7> — Load recorded video.
• 0-9 — Select save state slot.
• PageUp/PageDown — Select next/previous state.
• - — Decrease emulation speed.
• = — Increase emulation speed.
• Tab — Hold for turbo emulation speed. 🔥
• Pause — Pause emulation.
• \ — Advance a single frame.
• . — Toggle movie frame counter.
• , — Toggle input display.
• q — Toggle movie read-only.
• ' — Advance a single frame.
• / — Lag counter display.
• Delete — Frame advance lag skip display.
• <ESC> — Quit FCEUX.

👾 VS Unisystem Commands 👾

• <F8> — Insert coin. 🪙
• <F6> — Show/Hide dip switches.
• 1-8 — Toggle dip switches (when dip switches are shown).

💾 Famicom Disk System Commands 💾

• <F6> — Select disk and disk side.
• <F8> — Eject or insert disk.

🔗 one more link for the road 🔗

• http://fceux.com/ — The FCEUX project homepage.

---

👑 AUTHOR 👑

This manual page was written by Joe Nahmias <joe _at_ nahmias.net>, Lukas Sabota <ltsmooth42 _at_ gmail.com> and Alexander Toresson <alexander.toresson _at_ gmail.com> for the Debian GNU/Linux system (but may be used by others). shoutout to the icons who wrote this 💜

---

and that's the whole page bestie!! 🎀 this came out of the Games Manual for FCEUX(6), dated June 24, 2012 — so yes, it's a vintage baddie, but she still slays. no cap. 💅✨🦋