Docs / Getting Started

Getting Started#

A Commodore 64 that boots in your browser. No install, no plugins, no login. This guide takes you from a blank screen to a running game or demo in a few minutes, then points out the settings worth knowing.

Want a checklist of what the machine can do? See Features. Curious how it works inside? Start at the Architecture map.

1. Set up ROMs#

The first time you open the emulator, a "Setup C64 READY." dialog appears. The C64 cannot boot without its ROM chips. Dismiss it and the screen reads PRESS TO START SETUP; click the screen or POWER to bring it back.

⚠️ The KERNAL, BASIC, CHARGEN and 1541 ROMs are Commodore's copyrighted property. They are not bundled, and you must obtain them legally. The app does not bundle or host ROM files. Downloads happen only when you press FETCH ROMS.

The dialog offers three tabs:

Fetch ROMs opens first. Use the supplied links, where available, or paste your own, then press FETCH ROMS. Each download is checked and saved in this browser. Retry keeps ROMs that have already loaded. Leave the optional 1541 link empty if you do not need it. If a host blocks browser downloads, use a local file instead. The screenshot shows example URLs.

VICE folder lets you press CHOOSE… and pick VICE's top folder. All four images are found inside it. Your browser may call that an upload, but nothing is sent anywhere. This tab is available on desktop browsers with folder selection.

Upload files lets you press LOAD… for each ROM. 🔍 help me find it searches the web for that exact filename. A licensed set is sold at c64forever.com.

KERNAL, BASIC and CHARGEN are required. 1541 DOS is optional, for True Drive Emulation. Any compatible revision works. The search looks for:

• KERNAL: kernal.901227-03.bin (8 KB)
• BASIC: basic.901226-01.bin (8 KB)
• CHARGEN: characters.901225-01.bin (4 KB)
• 1541 DOS: 1541-II.251968-03.bin (16 KB, optional)

Once the three required ROMs are in and downloads have finished, the footer shows only Done. Press it to close setup and power on the C64. You can still add an optional 1541 ROM through the VICE or upload tab. This is a one-time step: ROMs are cached in your browser, and ⚙ OPTIONS ▸ ROM Files shows and clears them. See Specifications on revisions.

Once the ROMs are ready, Choose your look appears once. Pick a card and press APPLY THEME, or KEEP CURRENT. You can reopen it from Options ▸ Theme at any time.

2. Power on#

If Done has not already powered on the C64, press POWER. After the RAM-test pause you land on the light-blue BASIC screen with the blinking READY. cursor. This is a real cold boot, not a picture of one.

• POWER turns the machine on and off. Powering off tears the machine down; powering on builds a fresh one.
• ↺ RESET hard-resets the machine; more in Pause, reset, and save your place.
• Black screen, or an "Awaiting ROM files…" note? The ROMs are missing; go back to Set up ROMs.

3. Load a program#

Drag any supported file onto the screen and it goes to the right place, or use ▶ LOAD ANY on the Media load card.

AUTORUN, on by default, starts disk loads and runs BASIC programs, including machine-code programs with a BASIC SYS stub. A PRG loaded through drive 8 without such a stub stays at READY. for you to start. Turn AUTORUN off in ⚙ OPTIONS ▸ Media to control loading and starting yourself.

Loading a .d64 with TDE off offers to turn True Drive Emulation on when the 1541 ROM is available. Choose Turn TDE on for disk-loader compatibility, or Keep TDE off to continue with the current setting. A .g64 needs the real drive, since its loader and protection live in the raw tracks, so loading one turns TDE on without asking. D71 and D81 turn it off to use the virtual drive. With TDE off, D64/D71/D81 support loading, saving and the command channel.

The drive card lists the disk's directory: click any program to load just that one, or press 🔍 to see the filename artwork many demos hide there.

Everything you open is remembered. 📂 LOAD LIB relaunches it with one click, and moves the whole library between browsers.

Discover demos, intros and music with Assembly64#

Use Assembly64, expanded by default at the top of the right column, to explore demos, intros, music, graphics and diskmags. Demos is selected initially. Enter a demo title or a favorite scene group in Group / producer, choose a Type and Source if needed, and press Enter or the search icon. Click LOAD D64 (or the matching format) for a single compatible file, or click the title to choose from the production's files. EXPLORE opens the full browser; REFINE SEARCH below quick results continues your search there.

Search needs a connection. Leave Save selected file to Library enabled to make the loaded file available later with LOAD LIB, including offline.

4. Type and use the keyboard#

Just start typing: your keyboard is wired straight into the C64 keyboard matrix. A few keys are remapped so the C64-only ones are reachable:

Not sure where a symbol lives? KEY MAP shows a clickable on-screen keyboard, and the Key Map reference lists the full mapping. Need to get a BASIC listing in quickly? 📋 PASTE types your clipboard into the machine.

5. Play with a joystick, mouse, or paddle#

The C64 has two control ports. Assign each on the Control Ports card:

• Joystick: a USB or Bluetooth gamepad. Browsers only reveal a pad once it sends input, so press a button first, then pick which pad drives which port.
• Touch Joystick (phones and tablets): a stick lower left, two buttons lower right.
• Key Joystick 1 / 2: two keyboard sticks, so two people can share a keyboard. 1 is the arrow keys with J / K to fire, on Port 2 where most games expect it; 2 is WASD with C / V.
• Mouse (1351): the proportional GEOS-style mouse. Click the screen to capture the pointer; left button fires, right is up.
• Mouse (NEOS) and Paddle for software that expects them. None leaves the port empty.

SWAP PORTS exchanges the two assignments in one click.

6. Pause, reset, and save your place#

Open MONITOR in Controls to explore the running machine. Click its small live display to pause and inspect the latest completed frame in Video. See the Monitor walkthrough.

• ⏸ PAUSE freezes and mutes the machine where it is; press again to resume.
• ↺ RESET does a hard reset, the same as a power-cycle. Use it if a demo wedges.
• 💾 SAVE STATE freezes the whole machine (RAM, every chip, and whatever disk, tape or cartridge is inserted) into a named slot with a thumbnail. Pick it up later with 📂 LOAD STATE. Save is available while a program runs.

Save states live in this browser, survive reloads, and can be exported to a file and imported elsewhere, so you can hand a mid-game snapshot to someone on another machine. A save state is a permanent bookmark; PAUSE is a temporary freeze.

7. Make it look and sound right#

On the Controls card, SIZE cycles 1X / 2X / 2.5X / 3X / MAX and ⛶ FULL goes fullscreen, always keeping the C64's own proportions. VIBES opens Retro Vibes full-screen: a 3D C64 whose TV plays the live picture, with 🎬 to cycle scenes and 🥽 Enter VR if you have a headset.

In ⚙ OPTIONS:

• Display: 🖥 CRT cycles the display looks, from scanlines to a rolling mains-hum bar. ATTRACT MODE toggles the powered-off animation.
• Video: the VIC-II, 6569 (original PAL) or 8565 (later C64C), and the palette, Colodore (modern) or Pepto (2001 measurements).
• Sound: the SID, 6581 (warmer filter) or 8580 (cleaner), volume with mute, and DRIVE SOUND for 1541 motor hum and head clicks. The row below enables SID 2, selects its model and address, and chooses stereo or mono. Leave SID 2 off for a standard C64; two-SID files configure it automatically while they play.

All of these persist across reloads.

8. True 1541 drive (TDE)#

TDE is on by default: a real emulated 1541, with its own CPU and DOS, runs alongside the C64, so cracked intros, fastloaders, demos and copy-protection tricks behave like the real thing. It needs the 1541 ROM from Set up ROMs; without one the toggle stays disabled.

Off, you get the fast built-in load: instant, fine for plain games, but no SAVE and no fastloaders. The toggle is on Disk drive 8.

9. On phones and tablets#

The emulator is a Progressive Web App: choose Add to Home Screen in your browser's menu to run it like a native app, offline included.

Tap the screen to bring up the device keyboard, assign Touch Joystick on the Control Ports card to play, and turn to landscape with ⛶ FULL for the biggest picture. Switching away and back is safe: the machine pauses and mutes, then resumes where it was with no audio blip and no catch-up stutter.

Where to next#

• User Guide: the full reference for every control, card and dialog.
• Command line: work with media, run programs and export IEC printer output as SVG or printable HTML.
• Features: everything the emulator supports, from the user's side.
• Known Issues: something looks wrong? Check here first: it may be the real machine being itself.
• Architecture: how the machine is wired together, and the way into every chip's deep-dive.
• IEC Devices: install IEC Printer or another serial-bus plugin, select an address and CONNECT. Drives 8 and 9 keep their own controls, and a user port modem can stay connected at the same time. IEC Printer's Preview / Print button opens the browser print dialog for printing or saving as PDF.