troubleshooting: Windows off the screen

Open Beginner friendly
#46 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
72/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Domain
documentation

Research direction

Start by locating the appropriate troubleshooting page in the Cockpit-docs repository and review the linked discussion for context. Document the Windows off-screen workaround from the issue, including the steps for restoring Cockpit to the laptop display and the external-monitor cause.

Written by the indexing model from the issue text.

Description

Some tips from Sietse:

It usually happens after Cockpit has been opened on an external monitor. After disconnecting the monitor, Windows sometimes still thinks Cockpit should open on that now-nonexistent display. In your video, the brief white flashing animation appears to show Cockpit opening on this “virtual” external screen.

A workaround that consistently works for me is:

Open Cockpit, even though its window is not visible.

Open any other application.

Activate Windows’ split-screen function by dragging the visible application to the side or corner of the display.

aWindows should then show Cockpit as one of the available applications for the other half of the screen.

Select Cockpit.

Once Cockpit is visible again, close the second application and maximise Cockpit.

Cockpit should then return to the laptop’s main display and can be used normally again.

Dominant language
JavaScript
Stars
4
Forks
3
PR merge metrics
No merged PRs in 30d

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.

More from bluerobotics/Cockpit-docs

All issues in bluerobotics/Cockpit-docs

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.