virtualjaguar(1)

💖 virtualjaguar(1) 💖

okay bestie, listen. this is the manual page for virtualjaguar, and it lives in section 1 of the General Commands Manual. sit down, grab a snack, we're gonna get you emulating an Atari Jaguar like it's nothing. 🎀

---

✨ NAME ✨

virtualjaguar — an Atari Jaguar emulator, no cap 🦋

🌸 SYNOPSIS 🌸

virtualjaguar [options] [rom image file]

💜 DESCRIPTION 💜

So like, virtualjaguar is literally an emulator for the Atari Jaguar videogame system. that's it, that's the whole vibe. it's giving "your childhood console but make it 2024." 🔥

---

👑 OPTIONS 👑

okay so here's the menu of choices, pick your faves:

• [rom image file] — the name of the file you wanna load. your game, your love, your main character. 🫶
• -a, --alpine — run it in Alpine emulation mode ✨
• -b, --bios — boot it up using the Jaguar BIOS
• --no-bios — do not use the Jaguar BIOS, we're going rogue
• -g, --gpu — turn GPU emulation on 🔥
• --no-gpu — turn GPU emulation off 💀
• -l, --log — create a log file and use it, very "not me keeping receipts" of you
• --no-log — no log file, we're keeping it mysterious
• -h, --help — show the command line help, aka the cheat sheet, iykyk

---

🎧 SOUND 🎧

ngl, DSP emulation is needed for audio output. no DSP, no bops. 🎶

• -d, --dsp — enable DSP emulation ✨
• --no-dsp — disable DSP emulation 😭

---

🌈 VIDEO 🌈

the visual slay section, let's go:

• -f, --fullscreen — start in full screen mode, immersive era 👑
• -p, --pal — PAL mode
• -n, --ntsc — NTSC mode
• -B, --blur — enable the GL bilinear filter, soft focus, dreamy ✨
• --no-blur — disable the GL bilinear filter, crisp and sharp
• -z, --please-dont-kill-my-computer — do not show the emulation of tv static. fr fr, this can be slow on low end CPUs. the flag name is literally a cry for help and honestly? valid. 🙈

---

🎮 CONTROLS 🎮

here's your hands-on-the-controller moment:

• Ctrl-Q — quit virtualjaguar 😭
• Ctrl-I — load a new program
• Esc — pause emulation
• F7 — advance the emulation by a single frame
• F9 — toggle full screen mode

The default keybindings for controller 1 are:

(and psst — keybindings can be changed in the configuration dialog. you're not stuck with these, bestie. 💅)

• S — Up
• X — Down
• A — Left
• D — Right
• P — Pause
• O — Option
• J — Button C
• K — Button B
• L — Button A
• 1 through 0 — Buttons 1 through 0 on the keypad
• = — Keypad *
• - — Keypad #

---

📁 FILES 📁

the where-does-it-live section, let's get into it:

• virtualjaguar.log — the Virtualjaguar log file. it's only written if you gave the log option (-l or --log), okay? and if the file can't be opened, the log gets sent to standard output instead. also it's overwritten on startup, so no hoarding old logs. and note that the file is written to the current directory. 🫶
• ${XDG_DATA_HOME}/virtualjaguar/eeproms/ (typically ~/.local/share/data/virtualjaguar/eeproms/) — so some Atari Jaguar cartridges feature a small writable EEPROM, used for saving game state and score lists. if this directory exists, virtualjaguar will emulate the EEPROM by saving the state in file in this directory. your saves live here, protect them with your life. 💖
• ${XDG_DATA_HOME}/virtualjaguar/software/ (typically ~/.local/share/data/virtualjaguar/software/) — the virtualjaguar GUI for loading software scans this directory, and shows the loadable files, along with information about the program, and a label image if one's included in a zip archive of the software. it's giving organized. it's giving curated. 🎀

---

🧚 AUTHOR 🧚

This manual page was written by Teemu Hukkanen <tjhukkan@iki.fi>. thank you for your service, icon. 🫡

---

and that's the whole page, bestie!! Virtualjaguar — 2012-06-22 — virtualjaguar(1) ✨ mwah, go play some games, you've got this 💅🌸