Rpi-imager: Make advanced options discoverable

Created on 22 Mar 2021  ·  19Comments  ·  Source: raspberrypi/rpi-imager

I submitted two issues (#178 and #179) to do automatic setup of SSH and wifi. Turns out that feature already exists, which is fantastic!

Unfortunately it's completely undiscoverable. There's no way to know it exists unless you magically already know.

There should be some visual indication that the option is available - "do you want to set up advanced options?" sort of thing.

Most helpful comment

OK, thanks for that explanation regarding Mac.

So to clarify, is a button with a very clear warning really off the table? Such a button could be small and placed in the bottom corner to reduce the chance of being accidentally pressed. Something like this:

Screenshot from 2021-03-31 14-14-04

If someone still feels this could lead to anyone accidentally changing the advanced options, what if one of the advanced options was to always show this button? So then you only have to remember/lookup the magic shortcut once. If that is still somehow disagreeable, you could have the button hidden unless the --show-advanced-options command line option is used (for the benefit of non-Mac OS users only).

I'm really struggling to see how this adjustment makes the tool noticeably more confusing for new users. And it's much better for those other users who do want to easily enable SSH, change the hostname, configure WiFi etc.

Would you accept a pull request with such a change?

All 19 comments

I have to say you guys make a lot of disappointingly user-hostile decisions. You don't let users resize the window (a very standard feature), you hide the option to set the freaking wifi password. That is so beginner unfriendly!

This got discussed in the blog-comments

If by "discussed" you mean "almost everyone agreed it was bone-headed", then sure. Look at the comments from your users!

But why o why continue to make it so hard? A little button ‘Advanced’ was still too much?

What you call Advanced, most of us call More Options.

As probably already people suggested, please add some button to open the advanced Settings. I really like being able to set a few things (as Jeff Geerling already stated), but for sure I won’t remember the key combination in a few weeks.

Mmmmm. A GUI interface with keyboard-only functions. That makes so much sense (not).

Extremely valuable new optionst they should not be accessible in a so esoteric and only way like an Easter egg (key combination). If a program HAS a feature it has to be exposed. Just appropriately labelled as hard, or for experts or extra, but still exposed.

I'd also like to reply to one of the two (that I counted) replies in favour:

Advanced options are for advanced users. If you can’t remember CTRL-SHIFT-X then you probably shouldn’t be messing with the advanced settings.

Well for a start you literally just forgot the shortcut!, but secondly how are you supposed to remember the shortcut if you never even knew it existed?

This goes against basically every UX principle ever. I could understand it if the options were super dangerous, but we're talking about setting up wifi here! What world are you living in where you think people with a Raspberry Pi are intimidated by wifi?

Anyway I'll leave you to your crazy designs.

@maxnet / @ghollingworth Is it worth mentioning the magic advanced-mode key-combo in https://github.com/raspberrypi/rpi-imager/blob/qml/README.md ?

If you actually want users to know about this very useful feature then just put a button for it in the app. Very few people will read the Readme but everyone uses the app.

If you don't want users to know about this feature then you should think hard about why, because it's clearly insane to write a feature that you don't want anyone to actually discover.

Yes, everybody working at Raspberry Pi is clearly insane :stuck_out_tongue_winking_eye: Welcome to the madhouse :upside_down_face:

It's not even been 2 weeks and I just had to look up the key combo already. To do that I had to first find the blog post. I'll accept I have a poor memory but that aside, this was by no means resolved in the blog comments. I fully appreciate these extra options might be overwhelming/confusing to our newest users and we absolutely don't want that, but I think there is a middle ground here. Could we discuss what that might look like?

but I think there is a middle ground here

The shortcut sort of was the middle ground.
Between team #we-are-targetting-beginners rejecting the concept of a button, and team #experts coming up with a command line option (which is non-trivial to use on say Mac OS X).

A command line option? Like rpi-imager --show-advanced-options? And listing that option flag in the output of rpi-imager --help? That sounds like an improvement.

I don't use a Mac so I don't know why that is non-trivial but I'll take your word for it. Could we add the command line option alongside the magic keyboard shortcut? Then those young Mac users with their reliable memories can deal with remembering the cheat-code they need to enter. Everyone else can start the program in a mode that has a helpful button.

Personally I think a button with an informational message at the top would suffice. New pi users should still be able to read a warning message.

I don't use a Mac so I don't know why that is non-trivial but I'll take your word for it.

Well, on Mac the application executable is not in the path.
And yes, you do can actually cd into .app containers, but I doubt many users know that.
Would require entering something like: /Applications/Raspberry\ Pi\ Imager.app/Contents/MacOS/rpi-imager --option
Which may be harder to remember than the shortcut.

Keyboard combo was also changed to "shift" + "ctrl" + "X", to be able to have the same combination on MacOS.
Even though ctrl+alt+x may be easier to remember, MacOS lacked "alt".

OK, thanks for that explanation regarding Mac.

So to clarify, is a button with a very clear warning really off the table? Such a button could be small and placed in the bottom corner to reduce the chance of being accidentally pressed. Something like this:

Screenshot from 2021-03-31 14-14-04

If someone still feels this could lead to anyone accidentally changing the advanced options, what if one of the advanced options was to always show this button? So then you only have to remember/lookup the magic shortcut once. If that is still somehow disagreeable, you could have the button hidden unless the --show-advanced-options command line option is used (for the benefit of non-Mac OS users only).

I'm really struggling to see how this adjustment makes the tool noticeably more confusing for new users. And it's much better for those other users who do want to easily enable SSH, change the hostname, configure WiFi etc.

Would you accept a pull request with such a change?

So, would you accept a pull request with such a change? If not, what could we adjust to make it more apealing to those in charge here?

For the moment we've already made our decision about how we're going to support this functionality. As said many times before we do not want to change the user interface at the moment since this is the easiest way for people to image SD cards.

When an easier way appears we may then make this a more complex interface for more advanced users, but until then we will not be changing it.

You are free to build and distribute your own version (as long as you remove the Raspberry Pi logos and wordmark from the front page.)

Disappointing but of course that's your decision to make. Thanks for taking the time to reply.

Hey,

You are free to build and distribute your own version

@ghollingworth

Er - I am actually considering making my own version, since there are about 6 standing [OS Request] issue with no answers (filter to requests).
Does it make sense to you guys there? I don't want to step on anyone toes, though it seems like all other users in the thread might welcome a "unofficialpi" fork.
I am also in the works of adding json generation in CustomPiOS (related https://github.com/guysoft/CustomPiOS/issues/151 ). And knowing what is the stand on that would help me decide if a fork is worth having.

(I was actually got here thinking we could join efforts and make a smoother CI/CD using github actions or something more accessible)

In general, those requests have sat idle while I think about how best to put them in. In the end, the more images that do the same thing (home automation or 3D printer for example), I'm just going to add in a secondary list. For example:

Other Specific Purpose OSs
  -> OctoPi
  -> Other 3D printer OSs
      --> ABC
      --> Simply etc

Nice work guysoft! @raspberrypi why did you delete his message? If there's a good reason then you should probably say before people make assumptions. If there isn't then I would strongly consider reinstating it ASAP before people realise!

Hey, just to update that I spoke to Gordon and all is good. No need to make any assumptions :)
I might start working on a "packed with distros rpi-imager" once I get OctoPi and FullPageOS RCs out.

Hold the phone, has this feature now been added ?

Yeh. It was. Great. Thanks.

Was this page helpful?
0 / 5 - 0 ratings