Setting Up Processing

Downloading Processing

Head to processing.org/download and grab the current release. As of Processing 4.x, the download page detects your operating system automatically, but you can also choose from the dropdown:

• Windows: .zip archive, no installer required
• macOS: .dmg disk image
• Linux: .tgz tarball (64-bit)

Processing 4 bundles its own Java runtime (JDK 17), so you don’t need to install Java separately. This was a significant change from earlier versions — it means one download and you’re done.

Installing on Each Platform

Windows

1. Download the .zip file (e.g., processing-4.3-windows-x64.zip)
2. Extract it somewhere permanent — C:\Program Files\Processing or C:\Users\YourName\Processing both work
3. Double-click processing.exe to launch
4. Optionally, right-click processing.exe and choose “Pin to taskbar” or “Create shortcut” for easy access

Important: Don’t extract into Downloads and run it from there. Move the folder somewhere permanent first, because Processing stores your preferences relative to its install location on some configurations.

macOS

1. Open the downloaded .dmg file
2. Drag the Processing icon into your Applications folder
3. Double-click Processing in Applications to launch
4. On first launch, macOS may warn you it’s from the internet — click “Open” in the dialog

If you see a “damaged” warning on Apple Silicon Macs, open Terminal and run:

xattr -cr /Applications/Processing.app

Linux

1. Download the .tgz file
2. Extract: tar -xzf processing-4.3-linux-x64.tgz
3. Move the folder somewhere permanent: mv processing-4.3 ~/processing
4. Run ~/processing/processing to launch
5. The install.sh script inside creates a desktop launcher entry on most distributions

A Tour of the IDE

When Processing opens, you see the main sketch window. Let’s break it down:

┌─────────────────────────────────────────────┐
│  ▶  ■  ★  ⊕  ↑   [Sketch Title ▾]         │  ← Toolbar
├─────────────────────────────────────────────┤
│                                             │
│   void setup() {                            │
│     size(400, 400);                         │  ← Code Editor
│   }                                         │
│                                             │
│   void draw() {                             │
│   }                                         │
│                                             │
├─────────────────────────────────────────────┤
│  > Processing 4.3                           │  ← Console / Message Area
└─────────────────────────────────────────────┘

The Toolbar Buttons

The sketch name appears at the top of the editor window. Processing auto-generates names like sketch_250716a if you haven’t saved yet — save early to give your sketch a meaningful name.

The Sketch Window

When you click Run, a separate window opens showing your sketch output. This is the canvas where everything you draw appears. You can resize it by calling size() in your code (you’ll learn this shortly). The sketch window closes automatically when you click Stop or close it manually.

The Console

The dark area at the bottom of the IDE shows:

• Compilation errors in red, with the line number causing the problem
• Output from println() calls in your code, useful for debugging
• Status messages like “Sketch uses depecated API” or library load notices

Get comfortable with the console — it’s your first line of debugging.

Preferences

Open preferences via File > Preferences (macOS: Processing > Settings).

Key settings worth changing right away:

Increase the editor font size — the default is often too small. Drag the font size slider up to 16 or 18 for comfortable reading.

Change the sketchbook location — by default, Processing stores sketches in ~/Documents/Processing on most systems. You can point this anywhere you like, such as a folder in your project directory or a cloud-synced folder.

Enable line numbers — check “Show line numbers” to see line numbers in the editor gutter. This is invaluable when debugging compiler errors that reference a specific line.

The preferences window also shows the current sketchbook location at the top — note this path, because it’s where all your sketches will live.

Finding Your Sketchbook Folder

Your sketchbook folder contains one subfolder per sketch. Each sketch folder has the same name as the .pde file inside it (Processing requires the file and folder names to match).

Navigate to your sketchbook location in your file manager and you’ll see something like:

Processing/
├── my_first_sketch/
│   └── my_first_sketch.pde
├── bouncing_ball/
│   └── bouncing_ball.pde
└── libraries/
    └── (installed libraries appear here)

The libraries subfolder is where the Contribution Manager installs add-ons.

The Contribution Manager

Processing has a large ecosystem of libraries, tools, and modes that extend what it can do. The Contribution Manager (Sketch > Import Library > Manage Libraries) is how you install them.

To install a library:

1. Open the Contribution Manager via Sketch > Import Library > Manage Libraries
2. Use the search box to find a library by name
3. Click the library name to see details and documentation links
4. Click Install
5. Processing downloads and installs it to your sketchbook’s libraries folder

Some libraries to be aware of as you advance:

• PDF Export — save your sketches as vector PDFs
• Video — capture from a webcam or play video files
• Sound — play audio files and react to microphone input
• ControlP5 — add sliders, buttons, and other UI controls to your sketch
• Minim — a more advanced audio library

You don’t need to install anything right now. The next tutorial dives straight into writing code.

Verifying Your Setup

Before moving on, do a quick sanity check. Type this into the editor:

void setup() {
  size(400, 400);
  background(50, 100, 200);
}

Click Run. You should see a 400x400 blue window appear. If you do, Processing is installed and working correctly.

If you see a red error in the console instead, the most common culprits are:

• “The sketch name is illegal” — rename the sketch to use only letters, numbers, and underscores, starting with a letter
• “Cannot find a class or type named…“ — you have a typo in a function name
• Permission errors on macOS — re-check the xattr fix above

Everything working? In the next tutorial you’ll write your first real sketch and learn the two functions at the heart of every Processing program.