PLASTIC(1)

✨ NAME ✨

okay so plastic is literally an NES emulator with both a graphical (GUI) and terminal-based (TUI) interface, and this is PLASTIC(1) from the General Commands Manual, section 1, bestie 🫶

🦋 SYNOPSIS 🦋

plastic [rom-file]
plastic_tui [rom-file] [-a]

💖 DESCRIPTION 💖

plastic is an NES emulator written in Rust, designed to run NES games with both a graphical (GUI) and a terminal-based (TUI) interface. no cap, it’s giving “cozy emulator with range” 💅

The graphical interface (plastic) can be launched without any arguments — though it can be started from the terminal with a ROM file — and it provides a user-friendly graphical experience. main character energy, honestly ✨

The terminal-based interface (plastic_tui) lets you run the emulator in the terminal with optional flags for additional control. terminal girlies stay winning 🎀

Saved states are stored at the following path:

~/.local/share/plastic/saved_states

🎀 OPTIONS 🎀

• plastic [rom-file] — launches the emulator with the graphical interface. while arguments are optional, specifying a ROM file as an argument is recommended for immediate gameplay. slay 💅
• plastic_tui [rom-file] [-a] — launches the emulator with the terminal-based interface. the following options are available:
  • rom-file — specifies the NES ROM file to load.
  • -a — disables audio output while running in TUI mode.

🌸 INSTALLATION 🌸

The latest versions of plastic and plastic_tui can be installed using Cargo:

cargo install plastic
cargo install plastic_tui

🎮 KEYBOARD CONTROLS 🎮

• J → B
• K → A
• U → Select
• I → Start
• W → Up
• S → Down
• A → Left
• D → Right
• CTRL-R → Reset

🕹️ GAMEPAD CONTROLS (PS4) 🕹️

• X → B
• O → A
• Select → Select
• Start → Start
• D-pad Up → Up
• D-pad Down → Down
• D-pad Left → Left
• D-pad Right → Right

🌈 EXAMPLES 🌈

Run plastic with the GUI interface:

plastic

plastic path/to/rom.nes

Run plastic_tui with a specific ROM file:

plastic_tui path/to/rom.nes

Run plastic_tui without audio:

plastic_tui path/to/rom.nes -a

⚖️ LICENSE ⚖️

This project is licensed under the MIT License.

👑 CREDITS 👑

plastic emulator is a project by Amjad Alsharafi.

This man page was written by Hadi Chokr.

---

that’s the whole manual, bestie — PLASTIC(1) from the General Commands Manual, section 1. the original footer didn’t hand me a source/version/date, so I’m not inventing one; consider this your cute sign-off instead 💖🎀