PixelDotNet Guide

PixelDotNet User Guide

A friendly, step by step guide to the PixelDotNet raster editor. Learn the screen, paint your first image, make selections, work with layers, and save or export your work.

This guide is written in plain language. You do not need to know anything about pixels, layers, or file formats before you start. Every feature is explained simply, and the main tools and windows are shown in screenshots.

The PixelDotNet main window with the Moonlight sample image open
The main window. The canvas is in the middle, tools are on the left, and the layers panel is on the right.
What this guide covers
  1. What PixelDotNet is
  2. Free and private
  3. Starting the app
  4. A tour of the screen
  5. Your first painting
  6. Saving your first image
  7. Tooltips and the Help menu
  8. Where to find each feature
  9. Words you will see
  10. How to read this guide

What PixelDotNet is

PixelDotNet is a painting and photo editing program. It works with raster images, which simply means pictures made of tiny coloured squares called pixels. You can paint with a brush, erase, draw shapes, add text, cut things out, adjust colours, apply effects, and save the result as an image or as a layered project.

The program is built around a few simple ideas:

Layers are sheets of glass

Each layer holds part of the picture. Layers stack on top of each other. You can hide one, fade it, move it, or paint on just that sheet without touching the rest.

Selections are stencils

A selection limits where your next edit can happen. If you select a circle, painting and effects only change pixels inside that circle.

Tools do one job

The left rail holds every tool. Pick one, look at the options bar across the top, and use the canvas. The options change to match the tool.

Free forever. Private by design.

PixelDotNet is free to use, and it will stay free. There is no paid version, no subscription, no account to create, no ads, and no telemetry. The program does not collect information about you or send usage data anywhere.

Free forever

Every feature in this guide is included. There is nothing to unlock and nothing to buy later.

No telemetry or tracking

PixelDotNet does not record what you do, does not phone home, and does not include analytics or tracking code.

Your files stay yours

Your images are opened, edited, and saved on your own computer. Nothing is uploaded to a cloud service.

The only time PixelDotNet goes online is when you choose to add a font from cdnfonts. That is optional and only happens when you press Add.

Starting the app

If you are running PixelDotNet from the project folder, open a terminal in that folder and run:

dotnet run

If you already have a built copy, start PixelDotNet.exe instead. The app opens with the Moonlight sample image so you have something to explore immediately.

No file open? Choose File > Open Sample to reload the sample at any time. File > New Document starts a blank canvas.

A tour of the screen

The window has six main areas. Once you know these, everything else is just choosing a tool and changing its options.

1. The menu bar

Across the top you will find File, Edit, Image, Layer, Select, View, and Help. These menus hold commands that are not tied to a single tool, such as opening files, resizing the image, adding layers, or turning on tooltips.

2. The options bar

The row under the menu bar belongs to the active tool. With the brush selected you will see size, hardness, and opacity. With the text tool selected you will see the font, size, alignment, and colour controls. Always glance here after picking a tool.

3. The tool rail

The narrow strip on the left holds all the tools. Hover over an icon to see its name. Most tools also have a single letter shortcut, such as B for the brush or E for the eraser.

4. The canvas

The canvas is your picture. The checkerboard pattern behind it means transparency. A transparent area has no pixels at all, not white pixels. You can zoom with Ctrl and the mouse wheel, and pan by holding the space bar or the middle mouse button while dragging.

5. The side panel

The right side has five tabs: Layers, Colour, Adjust, History, and Effects. The Layers tab is the one you will use most. The other tabs are for colour picking, tone changes, undo history, and filters.

6. The status bar

The bottom edge shows the current zoom level, document size, colour under the pointer, the active tool, and a short message telling you what just happened. If an action does not seem to work, read the message here first.

The PixelDotNet window with the Brush tool selected and its options visible
The options bar changes with the active tool. Here the Brush is selected and its size, hardness, and opacity controls are showing.

Your first painting

Let us make a simple drawing on top of the sample. This uses a new layer so the original picture stays safe.

  1. Add a layer. Choose Layer > New Layer or press Ctrl+Shift+N. A new empty layer appears at the top of the Layers panel.
  2. Pick the brush. Press B or click the brush icon in the tool rail.
  3. Choose a colour. Click the foreground colour swatch near the top right, or open the Colour tab on the right and pick a colour from the spectrum.
  4. Set the brush size. Drag the Size slider in the options bar, or press [ and ] to change it while painting.
  5. Paint. Drag on the canvas. The stroke appears on the new layer. If you make a mistake, press Ctrl+Z to undo.
  6. Soften the edge. Lower Hardness for a soft airbrush look. Lower Opacity to build colour slowly instead of covering everything at once.
A good habit Keep different kinds of work on separate layers. Put line art on one layer, colour on another, and text on a third. It makes every later change easier.

Using the brush like a pro

Saving your first image

There are two different ways to save, and they are both useful.

Save a normal image

Choose File > Save... or press Ctrl+S. The in-app file browser opens. Pick a folder, type a name, choose PNG, JPEG, BMP, or TGA, and press the save button. PNG is the best default because it keeps transparency and crisp pixel edges.

Save a layered project

Choose File > Save Project.... This writes a .pxd file. A project keeps every layer, mask, group, guide, layer style, smart object, shape, and text layer so you can reopen it later and keep editing. A PNG or JPEG flattens everything into one picture.

Important If you close the app after saving only a PNG, your layers are gone. Save a project as well if you might want to edit the picture again.
The in-app Save Image file browser
The in-app file browser. Pick a folder on the left, type a file name, choose a format, and save.

Tooltips and the Help menu

Tooltips start disabled so the interface stays quiet while you work. Choose Help > Enable Tooltips to turn them on. When they are on, hovering a tool or button shows its name, and some controls show a small chevron. Click the chevron to open a help card with more detail.

Even with tooltips disabled, the tool rail still shows the name of each tool when you hover it. That way you can always identify an icon without turning on the full help system. Choose Help > Disable Tooltips when you know your way around.

Learning a new tool Turn tooltips on, hover the tool, and read the help card before you use it. Turn them off again once the tool feels familiar.

Where to find each feature

I want to...Go toRead more
Paint, erase, clone, or healTool rail and options barTools
Cut out a subject or protect part of the imageSelection tools, Select menuSelections
Move, hide, group, mask, or style a layerLayers panel, Layer menuLayers
Draw an editable shape, path, or textShape tools, Pen tool, Text tool, Layers panelShapes, paths and text
Change brightness, colours, or apply a filterAdjust and Effects tabs, Image menuAdjustments
Open, save, batch convert, or use SVGFile menuFiles
Learn a keyboard shortcutAnywhereShortcuts

Words you will see

WordPlain meaning
PixelOne tiny coloured square in a picture. A 768 by 576 image has 442,368 pixels.
RasterA picture made of a fixed grid of pixels. Painting and photo editing usually work on raster images.
VectorArtwork described by shapes and lines rather than a fixed grid. It stays sharp when scaled.
LayerOne sheet in the stack that makes up the picture. Each layer can be edited on its own.
SelectionA stencil that limits where the next edit can happen.
MaskA black and white image attached to a layer that hides or reveals parts of it.
OpacityHow see-through something is. 100 percent is solid. 0 percent is invisible.
Blend modeA rule for how a layer mixes with the layers below, such as Multiply or Screen.
AnchorA point on a path. Dragging an anchor changes the path's shape.
HandleA control point that bends the curve between two path anchors.
Anti-aliasingSoftening the edge of a shape so it does not look jagged. The brush does this automatically.
AlphaThe transparency channel. A pixel with low alpha is mostly see-through.
PXDThe PixelDotNet project file. It keeps layers and editable content.
SVGA vector file format that can be opened in browsers and design programs.

How to read this guide

Commands look like this: Layer > New Layer. That means open the Layer menu and choose New Layer. Keys look like this: Ctrl+Z. That means hold Ctrl and press Z.

Some sections use these boxes:

NoteExtra detail that is useful but not strictly required.
TipA faster or friendlier way to do something.
WarningSomething that can lose work or produce an unexpected result.

Ready to begin? Start with Tools, or jump straight to the area you need.

Next: Tools >