processing / processing/processing4

"Run sketch on display" fails to place window on secondary display on macOS when the sketch window would have to cross the task bar

Open
#1,361 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug help wanted
Dominant language
Java
Stars
494
Forks
183
Avg merge
4h 39m
Merged PRs (30d)
3

Description

Most appropriate sub-area of Processing 4?

I'm not sure

Processing version

4.4.10

Operating system

macOS 15.6.1 (24G90)

Bug description

On macOS, the Run sketches on display preference fails to place the sketch window on a secondary display when that display is positioned above the primary display in the system display arrangement.

Instead of appearing on the selected display, the sketch window opens on the primary display, right below the task bar.

I suspect Processing attempts to position the window on the secondary display but it gets stuck against the task bar.

Preferences

Opening on Primary display

Image

Attempting to open on secondary display (not shown)

Image

Display arrangement

When the secondary display is positioned above the primary display, the issue occurs:

Image

When the displays are positioned side by side, sketches open on the selected display as expected:

Image
Steps to reproduce this
  1. Plug in a second monitor
  2. Open System Settings → Displays → Arrange
  3. Position the secondary display above the primary display
  4. Open Processing → Preferences
  5. Set "Run sketches on display" to the secondary display
  6. Run any sketch
snippet

n/a

Additional context

No response

Would you like to work on the issue?

No, I’m just reporting the issue

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the issue from Processing → Preferences with a secondary display above the primary display, then trace the Run sketches on display preference through the sketch-window placement entry point. Done means a sketch opens on the selected secondary display in the above-primary arrangement while the existing side-by-side behavior continues to work; no source file or test is named in the report.

Written by the indexing model from the issue text.

Assessment

Tech stack
java, macos
Domain
desktop
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.