vice.janicek.co API

Make a JSON URL fragment to pass the desired configuration.

URL's

• http://vice.janicek.co/c64/#
• http://vice.janicek.co/c128/#

Fragment

{
    "controlPort1": "<joystick, paddle>",
    "controlPort2": "<joystick, paddle>",
    "primaryControlPort": "<1, 2>",
    "keys": {"<key code>": "<label>"},
    "docs": "",
    "files": {"<name>": "<base 64 data>"},
    "vice": {"<parameter>": "<value>"}
}

• controlPort1 - what should be plugged into control port 1
• controlPort2 - what should be plugged into control port 2
• primaryControlPort - self evident
• keys - list of keyboard keys with labels to display on screen
• docs - documentation for software, can be text or the name of a file
• files - encoded files that are loaded onto virtual file-system, and can be referenced by other vice commands like -autostart
  • base 64
  • zip files are ok
• vice - All of the standard VICE command line options.
  • start tape, disk, program or snapshot "vice": {"-autostart": "<file name>"}
  • start cartridge "vice": {"-cartcrt": "<file name>"}

C64 Key Codes

LEFT ARROW, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, PLUS, MINUS, POUND, CLR HOME, INST DEL,
CTRL, Q, W, E, R, T, Y, U, I, O, P, @, *, UP ARROW,
RUN STOP, SHIFT LOCK, A, S, D, F, G, H, J, K, L, :, ;, =, RETURN,
CBM, LEFT SHIFT, Z, X, C, V, B, N, M, ,, ., /, RIGHT SHIFT, CRSR UP, CRSR LEFT, CRSR RIGHT, CRSR DOWN,
SPACE, F1, F2, F3, F4, F5, F6, F7, F8 

Example

http://vice.janicek.co/c64/#
{
    "controlPort2": "joystick",
    "primaryControlPort": 2,
    "keys": {"A": "Attack!"},
    "docs": "Press fire button to jump and a to attack.",
    "files": {"disk1.d64": "aHR0cDovL1JldHJvUGxheS5jbw=="},
    "vice": {"-autostart": "disk1.d64"}
}