First Time Install

[gene96817]

Is your feature request related to a problem? Please describe.
Many new users are not familiar with the concepts for configuring their devices. Some of these users can only succeed with a lot of hand-holding. Even with very technical users helping the setup process, this task is very difficult and tedious in times of social distancing.

Describe the solution you'd like
A stand alone quick start utility/application to step the new user through the steps needed for a successful first jam session.

Tasks might include (but not be limited to):

1. down load ASIO4ALL if needed for the OS
2. help the user select the proper microphone (confirmed by Jamulus VU meter)
3. help the user select the microphone (OS) volume control
4. help the user select the proper sound output (built-in, USB, add-in board, audio interface, etc.)
5. note that often plugging in a headset with a microphone is not properly detected by the OS
6. quick intro to the Jamulus UI controls for their channel
7. configure the user profile
8. quick intro to the Settings Window and why they may need to change the settings
9. show the user how to find and connect to a server (and confirming everything is working)

Additional notes

• Dependency? There is some demand for enabling additional control over Jamulus via some kind of API. A "wizard" would be a great use case for this (First Time Install #991 (comment))
• The utility must run on first start after installation but be dismissable.
• The utility should be available from the main Jamulus UI at any time.
• The utility probably needs to "branch" according to the type of user (eg "Do you have: a mic only, a mic and an acoustic instrument, ..." etc.) since there are different actions/advice in each case.
• We need to expect hardware surprises through this process (e.g. bad wiring, bad connection, bad microphone, headphone with a microphone on/off switch/volume control)
• How should/can we deal with another application making changes to the audio settings?
• A quick start utility introduces the possibility of version compatibility between the utility and Jamulus.
• It would be great for an indication in the Settings window if the quick start utility was used (vs. manually configured). Sadly sometimes semi-experienced users aren't completely truthful.
• All of the requirements described would be a great value to all the Jamulus users providing help to new non-technical users.

[ann0see]

Thanks for the great write-up.

I think the next question here is:

Where should this be included? Can the installer do it (I don't really think this would help). Or should Jamulus do it? (I'd vote for Jamulus)

Afterwards:

I think there are two problematic areas:

1. UI of ASIO4ALL (contacted the dev about this issue, I hope he implements the ideas)
2. Bugs or difficulties in Jamulus (something we can solve)

~~

Just adding my (unrelated) thoughts (I'm currently testing ASIO4ALL with my machine and try to do as much as possible wrong. That's how I found #796).

note that often plugging in a headset with a microphone is not properly detected by the OS

Also had a conversation to somebody via mail about this issue. It might be possible to solve it by re-loading the ASIO driver interface.
What I found is that you can in fact reset ASIO4ALL by clicking on the diamant icon. Some devices might show up after a reload. Can Jamulus do this somehow?

[gene96817]

I only discussed the quick start as a utility because I thought I saw a developer bias for this to be separate from Jamulus. I personally think packaging this module in Jamulus is a much better user experience. Then there is just the Jamulus client and they either have it all or not. In this packaging as part of Jamulus, we can keep a history of what path was used to configure Jamulus. (first install or repeat of a quick start, manual install, etc.)

[ann0see]

The question is:

Would it be possible to make the most important first time use functions visible in the area where the mixing board is (in "off" state this is just wasted space). We could also give brief explanations, show a help text if ASIO4ALL is detected and hide this text after specific things are set.

But another question here is: do we even need to remove these texts for new users?

I have the feeling that adding a real first run wizard will not be accepted and a separate utility will just add overhead or not even be installed.

[gene96817]

Wow, being able to highlight the UI element with the first-time-instructions makes a first-rate impression.

Keeping or removing text for new users is a question about clutter. As we work through the implementation, we may discover ways to make things smile and clear for everyone. KISS usually improves things for everybody.

I also am biased against a first-run wizard. Should we change the "Describe the solution" from "Create a quick start utility" to "Create a quick\ start process"?

[pljones]

OK, my view on this:

• I don't like the idea of this inside Jamulus. For most users, for most of the time they'll be using Jamulus, the code won't be used at all. Inherently, that means it's function is not core to what Jamulus is.
• There is some demand for enabling additional control over Jamulus via some kind of API. A "wizard" would be a great use case for this: effectively having an extra pair of hands controlling Jamulus is just what we're suggesting here. What this does mean is that the existing client UI and client core code need to work with this new client API. It also means the API needs exposing safely on the client computer but not necessarily any further than that (at the Jamulus client core level).

Remember, lots of people use Jamulus in lots of different ways. Any "quick start" is never going to cover all those cases -- and it must NOT get in the way once someone discovers it's not offering a solution to their use case.

[gilgongo]

Just a minor point: in user testing (websites and mobile apps, general consumer screener, even splits of sex, age 18-65), I have yet to see much significant initial use of "first start" or "onboarding" UI. Almost everyone apart from older people will dismiss, skip or barely pay it attention. They instead just give the app a go. People seem to just want things to be easy :-) HOWEVER, it is common to see people a little later seek out the thing they initially dismissed.

Those systems that have eg a prominent floating question mark icon (or similar) that re-starts the first-time UI usually see better SUS scores.

[gene96817]

@gilgongo I am willing to concede many people will just give it a go and hope for the best. Some of them can recover with a second more thoughtful try. It's the ones that ask for help to dig them out of their mess that is the most annoying. If we have a well structured first start process, the second try should be easy, and hopefully, it won't need assistance. Interestingly, the older, self-aware, tech paranoid user will follow the instructions carefully.

[gilgongo]

@gene96817 Yes, that's what I'm trying to say. We shouldn't be discouraged if we see a first time install being ignored, as long they can easily get to it later after dismissal.

[pljones]

"Help -> Setup Assistant", perhaps? ("Setup" not "Set up", as it's not to set up an assistant... :) )

[mulyaj]

Would it be possible to have some kind of collapsable help widget? It could contain specific first-start guides.

[gilgongo]

@mulyaj Yes, if the UI was structured to support that. This is part of the discussion here #958 (comment) in which I'm suggesting that the UI needs to be re-done so as to scale to support current and future (and as yet unknown) features and functions. I think this is somewhat of a separate issue to this ticket though, perhaps.

[pljones]

I'd rather detailed support information was on the web site, to be honest. More people nowadays "look it up in Google" than Help->User Guide.

[gilgongo]

Yes - probably just a link as we have now. Just in a different (more obvious?) form.

[gilgongo]

@gene96817 (and everyone else)

It would be good to get this defined so that it can exist as an agreed backlog item to be worked on. Given the initial discussion here, and @pljones #991 (comment) do we agree that:

1. It would be a stand alone feature outside of Jamulus exhibiting at least some of the things you list.
2. That it would invoke on first run, and thereafter be available from the UI (eg the Help menu).

If so, I can alter that in the ticket and mark this as specced.

If not, we can move this over to a Discussion until such time as we've worked it out.