Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Switchres has sorely inadequate documentation

Open
#946 9 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 4 days

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Documentation
Clarity
Needs clarification
Activity status
Stale
Domain
documentation

Research direction

Start with the linked docs.libretro.com/guides/crtswitchres/ guide and review the reported RTX 3080, Radeon 5450, CRTEmudriver, and RetroArch cases. Map which current CRT and VGA-monitor setups need coverage, then consider the work done when the guide clearly explains setup and expected behavior for the supported configurations.

Written by the indexing model from the issue text.

Description

bug

Description

Switchres doesn't work because I don't know how to make it work. All tutorials are outdated by years, and the documentation explains extraordinarily little about how to actually get it to function properly.

Expected behavior

I expect to be able to find a resource that can explain to me very clearly how to get switchres to work on any television CRTs or VGA monitors I have connected to my computer.

Actual behavior

I've spent an entire week trying to get it to work. On an RTX 3080, switchres does nothing. On a Radeon 5450 and CRTEmudriver, it causes Retroarch to crash.

Steps to reproduce the bug

Literally just go here and read it and come away still knowing nothing: https://docs.libretro.com/guides/crtswitchres/

Dominant language
TeX
Stars
348
Forks
864
Avg merge
4d 5h
Merged PRs (30d)
14

Getting set up

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 libretro/docs

All issues in libretro/docs

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.