Pi Screen Setup Plugin - Display Database Contributions
The Pi Screen Setup plugin now includes over 200 display presets covering 20+ manufacturers. But the Raspberry Pi display ecosystem is vast, and we need your help to expand coverage.
Before You Ask for a New Preset
This database exists because I took time to research, test, and document working configurations. If you want your display added, I ask that you do the same.
A request like “I bought XYZ display, please add it” without any technical details will be ignored.
We are volunteers. We do not have access to every display on the market. You have the display in your hands - you are in the best position to gather the information we need.
HDMI Display Template
Copy and fill in:
Product name: [exact name as printed on box/listing]
Model number: [if available]
Manufacturer: [brand name]
Purchase link: [where you bought it]
Datasheet/wiki link: [manufacturer documentation if available]
Native resolution: [width x height]
Orientation: [landscape native / portrait native]
Refresh rate: [usually 60Hz]
Working config (if known):
hdmi_group: [usually 2]
hdmi_mode: [usually 87 for custom]
hdmi_timings: [if you have working timings]
hdmi_cvt: [alternative to hdmi_timings]
Touch interface: [USB / SPI / I2C / None]
Touch working: [Yes / No / Not tested]
Tested on: [Pi model, e.g., Pi 4B 4GB]
Rotation tested: [which rotations work: 0/90/180/270]
Additional notes: [quirks, power requirements, etc.]
DSI Display Template
Copy and fill in:
Product name: [exact name]
Model number: [if available]
Manufacturer: [brand name]
Purchase link: [where you bought it]
Datasheet/wiki link: [manufacturer documentation]
Native resolution: [width x height]
DSI lanes: [2-lane / 4-lane]
Ribbon cable length: [if relevant]
Working config:
dtoverlay: [overlay name, e.g., vc4-kms-dsi-7inch]
dtparam: [any parameters needed]
Touch controller: [chip name if known, e.g., GT911, FT5x06]
Touch working: [Yes / No / Not tested]
Pi compatibility: [which Pi models work - note CM4 for 4-lane displays]
Rotation tested: [which rotations work]
Additional notes: [power requirements, backlight control, etc.]
DPI Display Template
Copy and fill in:
Product name: [exact name]
Model number: [if available]
Manufacturer: [brand name]
Purchase link: [where you bought it]
Datasheet/wiki link: [manufacturer documentation]
Native resolution: [width x height]
Color format: [RGB666 / RGB888]
Working config:
dtoverlay: [overlay name and parameters]
dtparam: [timing parameters if using generic overlay]
GPIO usage: [which pins, any conflicts]
Touch controller: [chip name if known]
Touch working: [Yes / No / Not tested]
Tested on: [Pi model - note DPI has compatibility limits]
Rotation tested: [which rotations work]
Additional notes: [required overlay files, dependencies, etc.]
How to Find This Information
-
Check the manufacturer website or wiki
- Waveshare, Adafruit, Pimoroni all have documentation
- Look for “Raspberry Pi” or “config.txt” sections
-
Search for your display model + “config.txt” or “hdmi_timings”
- Forums, GitHub issues, and blogs often have working configs
-
Check LCDwiki.com
- Many budget displays use panels documented there
-
Look at the product listing
- Resolution is almost always listed
- Sometimes config instructions are in the description
-
If your display works with another OS/distro
- Check their config files for working settings
What Happens Next
When you submit complete information:
- We verify the config makes sense
- We add it to the database
- You test the preset on your hardware
- Once confirmed working, it ships in the next update
Partial submissions will get a reply asking for the missing details.
Already in the Database
Check if your display is already supported before requesting:
- Open Preset Manager at
http://volumio.local:4567/ - Search by manufacturer or resolution
- Many budget displays are rebrands of Waveshare or LCDwiki panels
If a similar display works, try that preset first. Report back whether it works - that information helps others and may lead to adding your specific model as an alias.
Thank you to everyone who has contributed specs, tested presets, and reported issues. This database grows because of community effort.
Kind Regards,