projectM-visualizer / projectM-visualizer/frontend-sdl-cpp

[APP BUG] "No available displays" error when running headless x11 on linux

Open
#114 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
C++
Stars
116
Forks
64
PR merge metrics
No merged PRs in 30d

Description

Please confirm the following points:
  • This report is NOT about the Android apps in the Play Store
  • I have searched the project page to check if the issue was already reported
Affected Application

projectM Standalone SDL2 Frontend (includes the Steam app)

Affected Version

No response

Operating System

Linux (Desktop)

Additional Application Details

Application version: 2.0.0
Built/running with projectM4 version: 4.1.0 / 4.1.0
Built against SDL version: 2.26.5 (running with 2.26.5)

Type of Defect

Graphical issue (rendering glitches, black screen, heavy flickering)

Log Output
Initializing subsystem: SDL2 Rendering Window
Could not create SDL rendering window. Error: No available displays
Exception: Could not create SDL rendering window. Error: No available displays
Describe the Issue

Debian12, running headless X11, SDL gives an error that there are "No available displays"

An effective workaround is to set the enviornment variable SDL_VIDEO_X11_XRANDR=0

Fixed in SDL 3.1.10+
https://github.com/libsdl-org/SDL/commit/71099149b8fc062ea0ece232ccdd9f0ee9b3588b

Contributor guide

No contributing guide indexed for this repository

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

Start by locating the SDL2 rendering-window initialization and the project's SDL dependency configuration. Reproduce the failure on headless Debian 12 with X11, then compare behavior with SDL_VIDEO_X11_XRANDR=0 and the referenced upstream SDL fix. Done means the standalone frontend handles this environment without the reported error, or the supported workaround is clearly documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp, linux
Domain
desktop, operating-systems
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.