FAQ

Q: OctoScreen doesn't work, or doesn't install, or doesn't display correctly, what's wrong?

A: It's impossible to know. The best getting started resource I know of is Chris Riley's video, OctoScreen - Octoprint Raspberry Pi -Touch Screen Plugin - Chris's Basement

Q: My screen is 480x320. When I run, the screen "resizes" and shifts things around, and some of the controls are "beyond the screen" and don't fit.

A: This is a known issue, and it's being looked into. What's happening is that your screen is 480x320 but OctoScreen is requiring 548x348 (ish) pixels. OctoScren is built using GTK (a Linux GUI library) and when a control takes up more space than what's available, instead of clipping the window, GTK expands the entire window. This causes your 480x320 to expand to 548x348, but it's still only able to display 480x320. One can scale their display, but it seems to be hit-or-miss... some users have reported that configuring their display to scale works, while others have reported that it doesn't work. The "jury is still out" on this, and this is something that's being looked into.

Q: How do I invert the Z-axis button?

A: You need to install the OctoPrint-Z-Bolt-OctoScreen plugin (https://github.com/Z-Bolt/OctoPrint-Z-Bolt-OctoScreen), and then go into OctoPrint's settings, navigate to the OctoPrint-Z-Bolt-OctoScreen plugin, and then check the invert Z-axis button.