wbochar

Petmate9 0.9.20 (05/28/26)

PlatformInstallers
Windowsx64
Apple x64 | ARM64
Linux amd64.deb | x86_64.AppImage

PETSCII Support for C64, C128, C128 VDC 80 columns, Vic20, Pet 40/80 columns and C16/Plus4

Colors and Characters:

  • Platforms that have a different display ratio (80 column modes and Vic20) are now supported natively in the Editor
  • All Platforms now support native colors (TED/VicIIx)
  • Color Panel now supports sorting colors by Luminance values.
  • Color Panel now shows color info on rollover, toggling on color numbers over chips
  • Color Panel now can condense down to single line mode for more panel space
  • Character Panel can be forced to a default color
  • Character Panel can now be sorted by pixel density, it also shows the pixel density in the footer of the panel

Ultimate 64 Cartridge Support:

  • Multiple Ultimate Carts IP’s can be configured in preferences.
  • Commodore 64 and 128 Modes supported (this includes VDC)
  • Import and Export Directly to Ultimate (as PRG, through Screen/Color Mem)
  • Send SID’s to Ultimate
  • Reset/Reboot Ultimate
  • Export D64 and auto LOAD”$”,8:LIST for preview on real machine
  • “File -> Ultimate” for all the menu options

New Tools added:

  • DirArt Separators: preconfigured and user updatable line separators
  • Boxes: Create presets that allow indipendant assigned corners and connecting lines with custom patterns
  • Lines: Draw lines and supports 4×4 chunky pixel modes
  • Circles: Draw Circles and supports 4×4 chunky pixel modes
  • Find and Replace: Rectangular selections can replaced by other rectangular selections
  • Texture Generator: Spend hours making crazy patterns… really.
  • Guide Layer and Conversion: You can overlay an image to use a visual guide. You can also convert that guide to PETSCII to get a head start on your image. Conversion supports all platforms (TED/Plus4 100+ colors?), has three conversion engines: Petsciiator, IMG2PETSCII and Pet9scii (I made that one :))

General Editor and Engine Updates/Changes:

  • Prefs now support tweaking the various defaults and settings. Now separated into multiple tabs.
  • TED and VDC mode support BLINK, VDC supports Underline
  • VDC mode has both upper case and lower case ROM’s at the same time, character editor, exports and various tools support this.
  • Open Recent Files works at an application and OS level (Funny, this is my favourite)
  • A bug in the resizer tool codes was fixed, the actual dimensions showup properly
  • File -> New Screen… shows all the various new screen types
  • Tools -> Presets. All tools with save-able presets can now be exported to petmate frames edited and re-imported.
  • Tools-> Color Bars. If you are having issues or bugs with export/import issues load a default color bard image and use that for bug references.
  • LIGHT/DARK Mode actually works now. I wasn’t a fan of the light mode, but its growing on me. If you set it to AUTO it will follow whatever the OS is set to. You can override of course.
  • Select a frame thumbnail, CTRL Left/Right will change its order, frames can also be dragged around to change their order.
  • If you have an ULTIMATE configured in prefs and its online and the petmate computer can connect to it you will see an “ULT 64” or “ULT 128” icon above the gear ICON in the tools area.
  • You can toggle on/off the visibility of the transparency blocks in the menu Image -> Show Transparency

Exporters:

  • Advanced SEQ Import and Export features, support for enhanced PETSCII for TED and VDC modes
  • All platforms support single and animation frame binaries (PRG)
  • C64/128 now supports Single Frame, Animation, Widescreen Scroller, Vertical Scroller and SID tunes
  • Vic20 PRG exporter can be configured for (3, 5, 8, 16, 24 KB) memory expansion.
  • Right click on a frame preview for copy commands, exporting to png/clipboard
  • CBASE BBS prompt export and import (various versions), Characters panel has extended characters for special command codes in prompts

Petmate 9 — Keyboard Shortcuts

On macOS, Cmd is used where Windows/Linux uses Ctrl, except where noted.

File

ActionmacOSWindows / Linux
New 40×25 ScreenCmd+Shift+TCtrl+Shift+T
Open FileCmd+OCtrl+O
SaveCmd+SCtrl+S
Save AsCmd+Shift+SCtrl+Shift+S
Export Petmate Player (.prg)Cmd+Shift+XCtrl+Shift+X
PreferencesCmd+,Ctrl+P

Ultimate (File → Ultimate)

ActionmacOSWindows / Linux
Send to UltimateCmd+Shift+1Ctrl+Shift+1
Push to Ultimate (no reset)Cmd+Shift+3Ctrl+Shift+3
Import Screen from UltimateCmd+Shift+2Ctrl+Shift+2
Import Charset from Ultimate
Play SID on Ultimate
Export D64 to UltimateCmd+Shift+4Ctrl+Shift+4
Reset Ultimate

Edit

ActionmacOSWindows / Linux
UndoCmd+ZCtrl+Z
RedoCmd+Shift+ZCtrl+Y
Copy FrameCmd+CCtrl+C
Copy Frame as PNGCmd+Shift+CCtrl+Shift+C
Paste FrameCmd+Shift+VCtrl+V
Paste Text (into text tool)Cmd+Alt+VCtrl+Shift+V

Image

ActionmacOSWindows / Linux
Shift Canvas LeftAlt+LeftAlt+Left
Shift Canvas RightAlt+RightAlt+Right
Shift Canvas UpAlt+UpAlt+Up
Shift Canvas DownAlt+DownAlt+Down
Toggle Border On/OffCmd+BCtrl+B
Toggle Grid On/OffCmd+GCtrl+G
Show TransparencyCmd+TCtrl+T
Crop / ResizeCmd+\Ctrl+\
Convert to MonoCmd+Shift+M
Strip Upper 8 Colors
Clear ImageShift+HomeShift+Home

Selection

ActionmacOSWindows / Linux
Select AllCmd+ACtrl+A
Paste to New ImageCmd+NCtrl+N
Clear SelectionCmd+HomeCtrl+Home
Rotate LeftCmd+[Ctrl+[
Rotate RightCmd+]Ctrl+]
Flip HorizontallyHH
Flip VerticallyVV
Invert CharactersCmd+ICtrl+I

Frames/Thumbnails

ActionmacOSWindows / Linux
Align All Frames ×2 ZoomCmd+Alt+9Ctrl+Alt+9
Move Frame Left in StackCmd+LeftCtrl+Left
Move Frame Right in StackCmd+RightCtrl+Right
Duplicate FrameInsertInsert
Remove FrameDeleteDelete

View

ActionmacOSWindows / Linux
Zoom InCmd+=Ctrl+=
Zoom OutCmd+-Ctrl+-
Zoom ×2 (Default)Cmd+9Ctrl+9
Zoom ×1Cmd+0Ctrl+0
Toggle Theme (cycle)Cmd+Shift+DCtrl+Shift+D

Find and Replace

ActionmacOSWindows / Linux
Find and ReplaceCmd+FCtrl+F

Tool Selection (no modifiers, canvas focused)

These are single-key shortcuts active when no modal is open and the text tool cursor is not active.

KeyTool
xDraw (char + color)
cColorize (color only)
0CharDraw (char only)
9Reverse Pen (toggle reverse video)
bBrush / Select
tText / Keyboard Entry
zPan / Zoom
qPrevious color (step down palette)
eNext color (step up palette)
gToggle Guide Layer visibility

Character / Brush Manipulation (no modifiers, canvas focused)

These single-key shortcuts navigate the charset and manipulate the selected character or captured brush. Active when no text cursor is placed and no modal is open.

KeyAction
aMove left in charset grid
dMove right in charset grid
wMove up in charset grid
sMove down in charset grid
fInvert character (toggle reverse)
rRotate character or brush left
hFlip character or brush horizontally
vFlip character or brush vertically

Color Palette Panel

ActionmacOSWindows / Linux
Color Replace: Select a Source color, thenCmd + Click -> Color ChipCtrl + Click -> ColorChip

Color Selection by Number

These shortcuts map number keys to a platforms palette indices.

Colors 0–7 (Alt or Tab + number)

KeyC64 Color
Alt+10 — Black
Alt+21 — White
Alt+32 — Red
Alt+43 — Cyan
Alt+54 — Purple
Alt+65 — Green
Alt+76 — Blue
Alt+87 — Yellow

Colors 8–15 (Ctrl + number)

KeyC64 Color
Ctrl+18 — Orange
Ctrl+29 — Brown
Ctrl+310 — Light Red
Ctrl+411 — Dark Gray
Ctrl+512 — Medium Gray
Ctrl+613 — Light Green
Ctrl+714 — Light Blue
Ctrl+815 — Light Gray

Canvas Mouse Modifier Keys

These modify drawing behavior while using the mouse on the canvas.

ModifierEffect
Alt+clickEyedropper — picks char + color at cursor
Ctrl+clickPicks color only (most draw tools)
Right-clickErases (draws space character / current color)
Ctrl+Right-clickDraws transparent character
Spacebar (hold)Temporarily activates Pan/Zoom (all tools except Text)
Shift+dragLocks drawing to horizontal or vertical axis

Brush / Stamp Modifier Keys

When a brush is captured and you are stamping it:

ModifierEffect
(no mod)Stamp chars + colors
CtrlStamp chars only
AltStamp colors only
Ctrl+AltStamp raw (chars + colors, bypasses color remapping)
Right-clickColor stamp mode

Border Toggle Modifier Keys

When clicking the Border On/Off icon in the toolbar:

ModifierEffect
(no mod)Toggle current screen border
Cmd/CtrlEnable border on all screens
Cmd/Ctrl+ShiftDisable border on all screens
AltFlip border state on all screens

Guide Layer and Conversion Tool

When a guide image is loaded and visible:

ModifierEffect
Cmd/Ctrl + Spacebar (HOLD)Guide image placement mode
- Click and drag mouseMove guide image freely
- Scroll WheelZoom In/Out guide image

Text Tool

When the Text tool is active and the cursor is placed:

KeyAction
Any printable keyType character at cursor, advance cursor right
Shift+keyType uppercase variant
CapsLockToggle RVS Mode
BackspaceDelete character, move cursor left
ArrowLeft/RightMove cursor horizontally
ArrowUp/DownMove cursor vertically
EnterMove cursor to start of next line
HomeMove cursor to top-left of screen
` (backtick)Toggle VDC alternate charset (VDC screens only)
EscapeDeactivate cursor (first press), then exit to Draw tool (second press)

Escape Key — Tool Exit

Escape exits the current tool and returns to Draw in these cases:

ContextEffect
Brush tool (no brush captured)Exit to Draw
Flood Fill toolExit to Draw
Separators / Boxes / Circles toolReset brush, exit to Draw
Textures tool (brush captured)Clear brush (return to selection mode)
Textures tool (no brush)Exit to Draw
Find/Replace tool (brush captured)Clear brush
Find/Replace tool (no brush)Exit to Draw
Freehand Lines tool (line active)Cancel active line
Freehand Lines tool (no line)Exit to Draw
Fade / Lighten toolExit to Draw
Reverse Pen toolExit to Draw
Text tool (cursor active)Deactivate text cursor
Text tool (cursor inactive)Exit to Draw
Any modal openClose the modal

Texture Tool — Preset List

When the texture preset list has focus:

KeyAction
ArrowUpSelect previous preset
ArrowDownSelect next preset
Ctrl+ArrowUpMove selected preset up in list
Ctrl+ArrowDownMove selected preset down in list
InsertDuplicate selected preset
DeleteDelete selected preset
nFocus preset name input (select all)

Navigation

KeyAction
ArrowLeftPrevious screen tab (when no text cursor active)
ArrowRightNext screen tab (when no text cursor active)

Application (macOS only)

ShortcutAction
Cmd+HHide Petmate 9
Cmd+Shift+HHide Other apps
Cmd+MMinimize window
Cmd+WClose window
Cmd+QQuit

Dev / Tools

ShortcutmacOSWindows / Linux
Toggle Full ScreenCtrl+Cmd+FF11
Toggle Developer ToolsCmd+Alt+ICtrl+Alt+I
Reload (dev builds only)Cmd+RCtrl+R
Open DocumentationF1
Search IssuesCtrl+F1



Github Repo: Petmate 9
Changelog: CHANGELOG.md
Issue/Bugs: Petmate 9 issues


Petmate is a cross-platform PETSCII drawing program that was developed by Janne Hellsten (nurpax).
The last release by Janne was 0.8.4.

Starting in 2020, I started making bugfixes to my own version, then started adding new features. So I asked Janne if I could continue work on his project and he agreed. So, I am starting at v9 and the project is called Petmate 9.

Version 9x can be installed side by side with Janne’s version, so you can use both.

After installing you are getting an error like: “[33954:0224/200626.651433:FATAL:gpu_data_manager_impl_private.cc(415)] GPU process isn’t usable.” try adding –no-sandbox to the program shortcut or executing command. Ex: “petmate9 –no-sandbox”.

If you want to report bugs and other issues, use the Github repo issues: here