Paint 84 Help

Paint 84 User Guide

Everything Paint 84 can do, topic by topic. This is the same guide that ships inside the app (Help > Paint 84 Help), followed by troubleshooting and how to reach support.

Welcome

Welcome to Paint 84

Paint 84 is a paint program for strictly 1-bit pictures: every pixel is black or white, with no gray and no smoothing. It looks and works like a classic Macintosh, with modern additions such as unlimited undo, dithered tones, animation and export to vintage Macs.

The Paint 84 menu

The palette at the left of the menu bar holds About Paint 84 (version, build date and credits, in a window of its own), Preferences and Quit.

Getting started

A new drawing opens when the app starts. Pick a tool in the Tools palette, a pattern in Brush Patterns, and draw in the window. Every change can be undone with Command-Z.

Using this Help

Choose a topic on the left, or use Previous and Next at the bottom to read the topics in order. Scroll with the scroll bar, the mouse wheel or the arrow keys. The left and right arrow keys also move between topics.

Desktop and Windows

The desktop

Everything in Paint 84 lives on a gray desktop with a menu bar along the top. Drawings open in their own windows, and the palettes float above them.

Title bar

Drag the striped title bar to move a window. A dotted outline follows the pointer and the window jumps there when you let go (Preferences can switch on live dragging). Click a window to bring it to the front.

Close box

Closes the window. If the drawing has unsaved changes you're asked whether to save them first.

Zoom box

Makes the window just big enough for the drawing, within the space between the palettes. Click it again to go back to your own size.

Size box

Drag the bottom-right corner to resize the window. The window follows the pointer.

Scroll bars

Click the arrows to scroll a little, the gray track to scroll a page, or drag the white box. The mouse wheel and trackpad scroll too.

Menus

Click a menu title and choose an item, or drag down and let go on the item. The chosen item blinks, as on the original Mac. Every menu is also in the real macOS menu bar, so shortcuts and menu search work. F10 opens the menus from the keyboard: use the arrow keys and Return.

Command key

Shortcuts in menus are shown with this symbol. It means the Command key on your keyboard.

Rest the pointer on any tool, pattern, tone or window control for a moment to see its name.

Selection Tools

Marquee (M)

Drag a rectangle to select part of the picture. Hold Shift for a square. Double-click the Marquee in the palette to select the whole picture.

Lasso (L)

Draw a loop around something. The selection shrinks to fit the drawn shape, so the white around it isn't picked up.

Grabber (H)

Drag to slide the picture around inside the window, or drag a selection to move it. Double-click the Grabber in the palette to open Show Page.

Working with a selection

DragMoves the selection: the pointer turns into the hand over it. The place it came from becomes white.
Option-dragMoves a copy and leaves the original in place.
Command-dragStretches or shrinks the selection.
Shift-dragMoves the selection only horizontally or vertically.
Arrow keysNudge the selection one pixel. Hold Shift to move eight pixels.
DeleteClears the selection to white.
EscapeDrops the selection where it is.

Clicking outside the selection, or choosing another tool, puts the selection down.

Drawing Tools

Pencil (P)

Draws single black pixels. If you start on a black pixel it draws white instead, which makes fixing pixels easy. Hold Shift for a straight horizontal or vertical line. Double-click it in the palette to turn FatBits on or off.

Paintbrush (B)

Paints with the current brush pattern, using the current brush shape. Hold Shift to paint in a straight line. Double-click it in the palette to choose a brush shape.

Spray Can (S)

Sprays dots of the current pattern while you hold the mouse button down.

Eraser (E)

Erases to white. Double-click it in the palette to erase the whole picture (Undo brings it back).

Paint Bucket (K)

Fills the area you click, every connected pixel of the same color, with the current pattern.

Text (T)

Click where the text should start and type. Return starts a new line. Click elsewhere, choose another tool or press Escape to finish. See the Text topic for fonts and styles.

Zoom In and Zoom Out

The two magnifiers under the tools zoom the picture in and out, like Cmd-= and Cmd--.

Line widths

The lines under the tools set the thickness of lines and shape outlines. The box below them shows the brush shape: click it to change it.

Mirrors

Goodies > Mirror Horizontal, Mirror Vertical and Mirror 4-Way repeat your brush strokes as a mirror image across the middle of the picture. No Mirror switches it off.

Lines and Shapes

Shape tools come in pairs: hollow on the left, filled on the right. Filled shapes are filled with the current pattern and outlined in black. Press a shape's key again to switch between hollow and filled.

Line (N)

Drag from one end to the other. Hold Shift to keep the line horizontal, vertical or at 45 degrees.

Rectangle (R)

Drag from one corner to the opposite corner. Hold Shift for a square.

Rounded Rectangle (U)

Like the rectangle, with rounded corners.

Oval (O)

Drag out the oval's bounding box. Hold Shift for a circle.

Freeform Shape (F)

Draw any shape by hand. When you let go it closes itself.

Polygon (G)

Click each corner. Double-click, click the first corner or press Return to finish. Escape cancels. Hold Shift to keep sides at 45-degree steps.

Filled shapes

The right-hand column draws the same shapes filled with the current brush pattern.

Line thickness comes from the line widths under the tools.

Brush Patterns

Brush Patterns palette

The 38 patterns along the bottom are what the Paintbrush, Spray Can, Paint Bucket and filled shapes paint with. Click one to use it. The large box on the left shows the current pattern.

Editing a pattern

Double-click a pattern, or choose Goodies > Edit Pattern, to edit its 8 by 8 pixels. Click or drag on the grid. Patterns belong to the drawing and are saved with it.

Load Pattern SetLoads a saved set, or takes the patterns out of a MacPaint document.
Save Pattern SetSaves the drawing's 38 patterns as a .p84pat file to share or reuse.
Reset PatternsPuts back Paint 84's original patterns.

Brush shapes

Brush Shape

Goodies > Brush Shape (or a click on the brush box under the tools) picks the Paintbrush's shape: round, square, slanted, lines or dots, in several sizes.

Patterns line up with the picture's grid, so neighbouring strokes of the same pattern join without seams.

Dither Tones

Dithering makes shades of gray out of black and white dots. The tone tools paint a gray level (0 to 100 percent) and turn it into dots as they go, so the picture stays 1-bit.

Dither Tones palette

Click one of the 17 steps or drag the slider for any level. Click the line of text under it to open Tone Settings.

Dither Brush (D)

Paints the chosen tone.

Shade Brush (A)

Makes what's already there one tone darker for each stroke. Hold Option to make it lighter instead.

Soft Dither Brush (W)

A dithered airbrush: full tone in the middle, fading towards the edge. Hardness sets how soft the edge is.

Dither Stipple Brush (Q)

Scatters random dots; the tone sets how many.

Dither Eraser (X)

Lightens down to the chosen tone instead of erasing to white.

Gradient (J)

Drag across a closed area, or across a selection, to fill it with a dithered gradient from the start of the drag to the end.

Tone Bucket (Y)

Fills the area you click with the chosen tone.

Settings

Tone SettingsThe dither method (Bayer, blue noise, Atkinson, Floyd-Steinberg, halftone dots, line screen, stipple, threshold), the tone, and the halftone dot size, angle and shape.
Gradient SettingsLinear, radial, diamond or shape-burst, and the gray stops, for example 0, 60, 20.
Brush SettingsSize, hardness, spacing and jitter for the tone brushes, and what pen pressure controls.

Atkinson and Floyd-Steinberg need a whole area, so they're used for fills, gradients, stamps and Re-dither. The brushes use Bayer 8x8 with those methods.

Editing

These Edit menu commands work on the selection. With nothing selected they work on the whole picture.

Undo, RedoStep back and forward through every change. Undo is unlimited unless Single undo is set in Preferences.
Cut, Copy, PastePaste puts the clipboard in the middle of the window as a selection you can drag into place. Copied pictures also paste into other apps.
Clear, Select AllClear empties the selection to white. Select All selects the whole picture.
Transparent PasteWhen checked, the white parts of a moved or pasted selection let the picture show through.
InvertSwaps black and white.
FillFills the selection with the current pattern.
Trace EdgesTurns shapes into outlines.
Flip, RotateFlip Horizontal, Flip Vertical and Rotate 90 degrees.
Drop ShadowAdds a dithered shadow under the selection, with offset, softness and tone.
Re-dither SelectionWorks out the gray levels in the selection and dithers them again with another method.
Invert TonesMakes light areas dark and dark areas light, keeping them dithered.

Pictures from elsewhere

Image Stamp

Goodies > Image Stamp (or pasting a picture copied from another app) turns any image into black and white. Adjust brightness, contrast, gamma, size and dither method (Threshold to start with) in the preview, then place it like a selection. You can also drop image files on the desktop.

Drag outDrag a selection past the edge of the Paint 84 window to drop a copy into another app, or into Finder as a PNG file. The selection goes back where it was.

Text

Typing text

Choose the Text tool, click and type. Font, size and style changes apply to the text you're typing until you finish it.

Font menuPlaka and Plaka Mono are Paint 84's own pixel fonts. Below them are classic fonts installed on this Mac, such as Geneva, Monaco, Courier, Helvetica and Times.
Other FontLists every font on this Mac, with a search box and a preview.
FontSize menuPlaka comes in multiples of 9. Other fonts come in sizes from 9 to 72. One point is one pixel of the picture.
FontStyle menuPlain, Bold, Italic, Underline, Outline and Shadow, in any combination.

All fonts are drawn in pure black and white. Once you finish typing, text becomes part of the picture, so a drawing looks the same on any Mac even if it doesn't have the font.

Viewing

The Window menu changes how you see the picture; it never changes the picture itself.

GridShows a grid between pixels when you zoom in close.
FatBitsZooms right in to edit single pixels, with a small window showing the area at actual size.
Show PageA small window with the whole picture. Drag the dotted frame to move the view; double-click to close it.
Zoom In, Zoom OutDoubles or halves the magnification.
Reset ZoomBack to one picture pixel per pixel of the Paint 84 desktop: the classic look.
Real PixelsOne picture pixel per pixel of your screen, the true size of the picture on a modern display.
Classic Export PreviewOutlines the 576 by 720 page that vintage Mac export uses.
Normal, Large InterfaceHow big the whole Paint 84 desktop is drawn. Large makes menus, windows and palettes half as big again, with less room for drawings. The Paint 84 window grows to fit the menu bar at Large; on a screen too small for that, the interface stays at the largest size that fits.
Full ScreenFills the screen with the Paint 84 desktop. The same item exits full screen.

The View menu

Lists your open drawings, and shows or hides the Tools, Brush Patterns and Dither Tones palettes.

Goodies

Canvas SizeChanges the picture's width and height, for every frame.
Desktop PatternChooses or edits the desktop's background pattern.
Night ViewShows everything white on black. Files aren't affected.
CRT FilterAdds old-monitor scanlines on screen only.

Image and Transparency

The Image menu holds what goes with the drawing without being part of it: a picture to trace, tile mode and a transparency layer.

Reference ImageShows a picture under the drawing as light dots, to trace over. It fills the canvas without stretching, hides while an animation plays, and is never saved. Show Reference hides it for a moment; Remove Reference drops it.
Tile ModeFor seamless patterns, desktop patterns and game tiles. Copies of the picture fill the window around it, with a dotted line around the real one, so you can see the seams. Anything drawn off one edge comes back in on the opposite edge, and you can paint on the copies too; the Paint Bucket fills across the edges. You can scroll half a window past each edge of the tile. Tile mode is saved with the drawing. Patterns join up best when the width and height are multiples of 8.

Transparency layer

For game sprites and anything else that needs a see-through background. The transparency layer sits on top of the drawing and only matters when you export: marked pixels come out transparent. It's separate from the drawing, so painting never changes it, and the Eraser still makes white.

Transparency (C)

Drag to mark pixels with the Paintbrush shape; Option-drag unmarks. Command-click marks the whole connected area under the pointer, such as the white around a sprite or the hole in a ring; Option-Command-click unmarks it. Double-click the tool to mark everything around the drawing.

On screenMarked white pixels show a gray checker. When you zoom in, a marked black pixel gets a white dot: it won't show in the export. Show Transparency Layer hides the marks while you look at the drawing.
Add Transparency LayerGives every frame an empty layer. Using the tool or one of the menu commands adds it too.
Mark Outside TransparentMarks the white connected to the edges of the frame, so the inside of a closed shape stays solid. Mark Outside in All Frames does every frame.
Make Selection Transparent, SolidMarks or unmarks the selected area.
Clear, RemoveClear Transparency Layer empties the current frame's layer. Remove Transparency Layer takes it off every frame.
FramesEach frame has its own layer. New frames, Next Frame with Transform, Tween and Cycle Pattern bring it along; moving a selection doesn't.
ExportPNG, TIFF, GIF, PDF, SVG, animated GIF, APNG, spritesheets and numbered frames have a “Use transparency layer” checkbox, on when the drawing has a layer. MacPaint and the other vintage formats can't hold transparency and show the pixels underneath.

Animation

A drawing can have many frames. The timeline appears under the picture as soon as there's more than one frame (Animation > Show Timeline shows it any time).

New frame

Adds a copy of the current frame after it.

Delete frame

Removes the current frame.

Play / Pause

Plays the animation in the window.

Onion skin

Shows earlier and later frames as faint ghosts while you draw. They're never saved.

Frame thumbnails

Click a frame to edit it. Drag it to another place to reorder. Double-click it to set its timing. The comma and period keys step back and forward.

Animation menu

Next Frame with TransformAdds frames that move, rotate, scale, flip or invert the frame (or just the selection), for example 2 pixels right, 8 times, for a walk.
TweenSelect something in a frame, then give its position in a later frame: the in-between frames are made for you, with optional easing.
Cycle PatternAdds frames that shift the selection a step at a time and wrap around, for water or conveyor belts.
Mirror FramesAdds the frames again backwards, for a back-and-forth loop.
Loop HelperShows the first frame as a ghost while you edit the last one, so the loop joins up.
Frame TimingEach frame's duration, the frame rate and the loop mode: Loop, Ping-Pong or Play Once.
ExportSpritesheet (PNG with JSON or SpriteKit plist), animated GIF, APNG, or numbered frames, with transparency when the drawing has a transparency layer.

Files

NewScreen (512 by 342, the original Mac screen), Page (576 by 720, the MacPaint page), Square or a custom size.
New SpriteSmall square sizes from 8 by 8 to 128 by 128, opened zoomed in.
OpenPaint 84 documents, MacPaint files (.mac, .pntg, MacBinary .bin), PICT files, HFS disk images, pattern sets, and any picture, which is converted to black and white.
Save, Save AsSaves a Paint 84 document (.p84) with all frames, patterns, timing and the transparency layer.
Revert to SavedGoes back to the last saved version.
Import ImageOpens any picture through the Image Stamp converter.
ExportPNG, TIFF or GIF of the current frame, or PDF and SVG. PDF and SVG trace the black pixels as vector shapes, so every pixel stays a sharp square at any zoom and in any app. With a transparency layer, marked pixels can be left transparent.
ShareSends the picture with the macOS share menu.
PrintPrints the current frame at its classic size, 72 pixels to the inch, with every pixel a sharp square. A picture bigger than the paper is shrunk to fit.

You can drop files on the Paint 84 window to open them. While a file is being written the pointer turns into a ticking wristwatch, and you can carry on working.

Finder and iCloud

Finder shows the picture itself as the icon of Paint 84 documents and MacPaint files, and pressing Space on one shows it full size. In App Store versions, Save As starts in the Paint 84 folder in iCloud Drive, so drawings appear on all your Macs.

Vintage Mac

Paint 84 can send drawings to real classic Macs and emulators such as Mini vMac and Basilisk II, where they open in the original MacPaint and other paint programs.

Export for Vintage Mac

Saves the drawing as a MacPaint document. MacBinary (.bin) keeps the classic file type so it opens with a double-click after transfer; plain PNTG, PICT and BinHex are also offered.

Page sizeMacPaint pages are always 576 by 720. Bigger drawings can be cropped (drag the frame), scaled to fit or split into numbered pages. Smaller ones go top-left or centred.
Spritesheet pageFor animations: all frames laid out on one page.
File namesClassic names are shortened to 31 characters, colons are replaced and other alphabets are converted to Latin letters. You can edit the name.
Export Vintage Mac Disk ImageWrites an 800K floppy disk image with your drawings on it: this drawing, all open drawings, or every frame as its own file. Use it in an emulator, or on a real Mac through a floppy emulator.
Open Disk ImageLists the files on a classic disk image so you can open a drawing from it.

Preferences sets the creator code that decides which classic app opens the files, and can make Paint 84 the app that opens MacPaint files on this Mac.

Preferences

Paint 84 > Preferences

Settings that are kept between launches.

Larger cursorsDoubles the size of the pointer.
Live window draggingMoves windows as you drag instead of showing an outline.
Startup screenShows the Welcome box when the app starts.
Reopen drawings and windowsWhen Paint 84 starts, it reopens the saved drawings that were open when it quit, with their windows where they were, at the same zoom and frame, and puts the palettes back. Untitled drawings and MacPaint or PICT files aren't reopened. On by default.
Sound effectsPlays small original sounds for alerts, menus and closing windows.
CRT and Night viewThe same as the CRT Filter and Night View in Goodies.
Single undoUndo goes back only one step, as in the original MacPaint.
Never show the gridKeeps the pixel grid off at every zoom.
Pen pressureWith a graphics tablet or Force Touch trackpad, pressure can change the brush size or the tone.
Vintage creator codeThe classic app that exported files open with (MPNT is MacPaint).
MacPaint filesMakes Paint 84 the app that opens .pntg and .mac files when you double-click them.

Keyboard Shortcuts

Tools (no modifier keys)

M L HMarquee, Lasso, Grabber
P B S EPencil, Paintbrush, Spray Can, Eraser
K T NPaint Bucket, Text, Line
R U O F GRectangle, Rounded Rectangle, Oval, Freeform, Polygon (press twice for filled)
D A W Q XDither, Shade, Soft and Stipple brushes, Dither Eraser
J Y CGradient, Tone Bucket, Transparency
, .Previous and next frame

Menus

Cmd-N Cmd-ONew, Open
Cmd-S Cmd-WSave, Close
Cmd-Z Shift-Cmd-ZUndo, Redo
Cmd-X C V ACut, Copy, Paste, Select All
Cmd-ETrace Edges
Opt-Cmd-I Opt-Cmd-RInvert, Rotate 90 degrees
Cmd-F Shift-Cmd-MFatBits, Show Page
Cmd-= Cmd--Zoom In, Zoom Out
Cmd-0 Cmd-9Reset Zoom, Real Pixels
Shift-Cmd-GGrid
Shift-Cmd-FFull Screen
Opt-Cmd-1 Opt-Cmd-2Normal Interface, Large Interface
Cmd-P Cmd-D Cmd-TPlay, New Frame, Next Frame with Transform
Cmd-B Cmd-I Cmd-UBold, Italic, Underline
Shift-Cmd-TTone Settings
Cmd-?This Help
F10Open the menus from the keyboard

System Requirements

macOS 14 Sonoma or later.

No account or internet connection is needed. Vintage Mac export works with any classic Macintosh that runs MacPaint (System 1 to 7), and with emulators such as Mini vMac and Basilisk II.

Troubleshooting

Double-clicking a MacPaint file opens Preview

macOS gives its own Preview app first claim on .pntg files. Open Paint 84 > Preferences and click Open MacPaint Files with Paint 84, or select a file in Finder, choose File > Get Info, pick Paint 84 under "Open with" and click Change All.

Finder doesn't show drawings as pictures

Make sure Paint 84 is in your Applications folder and has been opened at least once. If the icons still look blank, relaunch Finder (hold Option, right-click Finder in the Dock and choose Relaunch).

The old Mac doesn't recognise an exported file

Classic Macs need a file's type and creator, which plain files lose when they're copied from a modern Mac. Export as MacBinary (the default) and let your transfer tool unpack it, or export a disk image, which keeps everything in place.

Text looks thin or gray

Every pixel is pure black or white, but light fonts at small sizes have one-pixel strokes and lots of space, so they read as lighter. Choose Bold, a bigger size, or a heavier font such as Geneva or Plaka.

The interface looks too small or too big

Paint 84 draws its desktop at a fixed size so every pixel stays sharp. Make the window larger or use Window > Full Screen. To change how big the drawing looks, use Zoom In, Zoom Out, Reset Zoom or Real Pixels.

Your Files and Data

Your drawings are ordinary files, saved where you choose. Paint 84 only opens files you pick in an Open or Save dialog, or drag onto it.

Settings (preferences, the desktop pattern) are stored on your Mac in ~/Library/Containers/com.mastorakis.paint84.

Removing Paint 84: quit it and drag it from Applications to the Trash. To remove its settings too, choose Go > Go to Folder in Finder and delete the folder above. Your drawings stay where you saved them.

iCloud Drive: drawings saved in the Paint 84 folder in iCloud Drive sync to your other Macs through iCloud, and stay there until you delete them.

Contact Support

Still stuck, found a bug or have an idea? Email support@mastorakis.com. It helps to include:

Your Paint 84 version (Paint 84 > About Paint 84), your macOS version and Mac model.

What you did, what you expected and what happened instead.

A screenshot, or the drawing or classic file involved, if you can share it.

Every message is read. For what Paint 84 does with data (short answer: nothing leaves your Mac), see the Privacy Policy.