Parrot Cart pluginsGet a Parrot Cart

Vectrex

Emulator for the vector-based home console

The details page on the cartVECTREX.CVP

On the TV

These are the author’s screenshots, shown pixel for pixel.

Vectrex on the TV, picture 1 of 2
Picture 1256 × 192
Vectrex on the TV, picture 2 of 2
Picture 2256 × 192

README on the cart

This is what the cart shows for this plugin. It’s 114 lines long and 30 characters wide.

On the cart’s details page2,408 bytes

Plain text

VECTREX

Vectrex games on the
ColecoVision. It opens .vec
and .gam files from anywhere
on the card; /VECTREX is its
home folder.

SETTING IT UP

1. VECTREX.CVP into the card's
   /PLUGINS folder.
2. The Vectrex's system ROM
   into /VECTREX. It is one 8K
   file, often named
   exec_rom.bin or Mine Storm
   (1982).vec. The name
   doesn't matter. Without it
   nothing runs, and the
   screen says so.
3. Games anywhere on the card,
   named .vec or .gam. Rename
   a game that ends in .bin.

Started from the Plugins page
with no game, it plays Mine
Storm, the game inside the
system ROM.

CONTROLS

On the ColecoVision
controller:

- Joystick: the stick
- Keypad 1, 2, 3, 4: buttons 1
  to 4
- Left fire: button 3
- Right fire: button 4
- Keypad 0: the picture's
  colour
- RESET on the console: back
  to the menu

On a USB pad:

- Left stick or D-pad: the
  stick
- Left face button (Nintendo
  Y): button 1
- Top face button (Nintendo
  X): button 2
- Bottom face button (Nintendo
  B): button 3
- Right face button (Nintendo
  A): button 4
- L: the picture's colour

NOTES

- USB pads need a powered hub
  on the cart's USB port. A
  Switch Pro Controller or a
  plain HID pad works. The
  first pad is player 1, with
  the console's controller.
  The second is player 2.
  Player 2 needs a USB pad.
- The picture stands upright
  in the middle of the screen,
  as the Vectrex's does. It is
  much coarser than the real
  one. Small text is redrawn a
  little larger so it can be
  read.
- The picture's colour stands
  in for a game's overlay:
  white, blue, green, yellow,
  red or magenta.
- Three voices and noise, as
  the Vectrex has. Its buzzing
  sounds become plain tones.
  Speech and samples play, a
  little rough.
- No 3-D Imager and no light
  pen. Games that need them
  don't work.
- Nothing is saved.

CREDITS

- The Vectrex's VIA, beam and
  cartridge follow MAME's
  Vectrex driver by Mathis
  Rosenhauer and others.
  BSD-3-Clause. Source:
  https://github.com/mamedev/m
  ame
- The 6809 was written for the
  cart's Star Wars plugin and
  checked against MAME's.
- MAME's licence text is in
  the plugin's source.
- TinyUSB by Ha Thach. MIT.
  Source:
  https://github.com/hathach/t
  inyusb
- The plugin itself is by
  Parrot Cart, and it's free.
  Its source is linked next to
  its download.
- It contains no Vectrex ROM.
  The system ROM and the games
  are yours to supply.

cart-readme.txt

README

This is the README.md from release v0.1.3. Images show up as links.

Vectrex

Vectrex games on the ColecoVision. It opens .vec and .gam files from anywhere on the card; /VECTREX is its home folder.

Setting it up

  1. VECTREX.CVP into the card’s /PLUGINS folder.
  2. The Vectrex’s system ROM into /VECTREX. It is one 8K file, often named exec_rom.bin or Mine Storm (1982).vec. The name doesn’t matter. Without it nothing runs, and the screen says so.
  3. Games anywhere on the card, named .vec or .gam. Rename a game that ends in .bin.

Started from the Plugins page with no game, it plays Mine Storm, the game inside the system ROM.

Controls

On the ColecoVision controller:

  • Joystick: the stick
  • Keypad 1, 2, 3, 4: buttons 1 to 4
  • Left fire: button 3
  • Right fire: button 4
  • Keypad 0: the picture’s colour
  • RESET on the console: back to the menu

On a USB pad:

  • Left stick or D-pad: the stick
  • Left face button (Nintendo Y): button 1
  • Top face button (Nintendo X): button 2
  • Bottom face button (Nintendo B): button 3
  • Right face button (Nintendo A): button 4
  • L: the picture’s colour

Notes

  • USB pads need a powered hub on the cart’s USB port. A Switch Pro Controller or a plain HID pad works. The first pad is player 1, with the console’s controller. The second is player 2. Player 2 needs a USB pad.
  • The picture stands upright in the middle of the screen, as the Vectrex’s does. It is much coarser than the real one. Small text is redrawn a little larger so it can be read.
  • The picture’s colour stands in for a game’s overlay: white, blue, green, yellow, red or magenta.
  • Three voices and noise, as the Vectrex has. Its buzzing sounds become plain tones. Speech and samples play, a little rough.
  • No 3-D Imager and no light pen. Games that need them don’t work.
  • Nothing is saved.

Credits

  • The Vectrex’s VIA, beam and cartridge follow MAME’s Vectrex driver by Mathis Rosenhauer and others. BSD-3-Clause. Source: https://github.com/mamedev/mame
  • The 6809 was written for the cart’s Star Wars plugin and checked against MAME’s.
  • MAME’s licence text is in the plugin’s source.
  • TinyUSB by Ha Thach. MIT. Source: https://github.com/hathach/tinyusb
  • The plugin itself is by Parrot Cart, and it’s free. Its source is linked next to its download.
  • It contains no Vectrex ROM. The system ROM and the games are yours to supply.

Build it yourself

You need the Raspberry Pi Pico SDK 2.1.1, an Arm GNU toolchain, CMake, Ninja, Python 3, sjasmplus and picotool. Releases are built with the Arm GNU Toolchain 9-2019-q4 (GCC 9.2.1) and picotool 2.3.1. With those you get the same file, byte for byte.

cmake -B build -G Ninja -DPICO_SDK_PATH=$HOME/pico-sdk
ninja -C build

This makes build/VECTREX.CVP. Copy it into the /PLUGINS folder on the card.

On Ubuntu, tools/ci/setup.sh installs the same tools that GitHub uses to build each release.

CART-README.md is the text the cart shows on the plugin’s page. It is the start of this README.

License

The plugin is under the BSD 3-Clause license (LICENSE). THIRD-PARTY.md lists the parts that came from elsewhere, and their licenses.

Release details

We read these from GitHub when the plugin was listed.

Release
v0.1.3, 2026-11-18
Image
171,776 bytes, loaded into RAM
Plugin API
1
GitHub
plasticbugs/parrot-plugin-vectrex
Source
Code at v0.1.3
License
BSD 3-Clause "New" or "Revised" License
Credits
The Vectrex’s VIA, beam and cartridge follow MAME’s Vectrex driver by Mathis Rosenhauer and others. BSD-3-Clause. Source: https://github.com/mamedev/mame; The 6809 was written for the cart’s Star Wars plugin and checked against MAME’s.; MAME’s licence text is in the plugin’s source.; TinyUSB by Ha…
SHA-256
db7034d91f9818916f1efd693e6247e917bc2815ee9b2c038fe4178011632f95

Release notes

The newest version is first.

  • 0.1.3

    2026-11-18, v0.1.3

    First release.

Put it on your cart

  1. Download VECTREX.CVP

    The SHA-256 is above if you want to check the file.

  2. Copy it to /PLUGINS

    That folder is on the cart’s microSD card.

  3. Put your files in /VECTREX

    Your .vec .gam files go in this folder.

  4. Start it

    Pick one of your files on the SD card and press A.