FAQ is out of date

Hi.

Just a note that the pinned (and Locked) FAQ post https://volumio.org/forum/faq-and-the-answers-for-t1545.html is out of date.

The SSH section (enabled by default) is inaccurate.
The which devices are supported section is out-of-date.

Happy to help update/change the post. I have a couple of additions I’d like to add for users of volumio 2.4 and up having trouble connecting CIFS shares.

Hi Rob, thanks. Please paste here what you think can be useful, and I’ll be really glad to integrate them

thanks :wink:

Hi michelangelo. Here’s an attempt at some updates for the FAQ. Happy to work with you to help further improve any of these. Others have any suggestions? Reply to the thread and suggest changes and additions.

First, a new one, which I feel is going to be a pretty common question until the setup procedure is fixed:

“Trouble Connecting to CIFS/SMB Shared Drive”

  1. Navigate to your volumio.local (or IP Address) on your network in your web browser.
  2. Open the main menu via the Gear Icon in the upper right of the screen, select My Music.
  3. In the Network Drives setting, click “Add New Drive”
  4. Enter a name for the new drive (something easy and identifiable, e.g., network or My-Computer-Name-Music-Drive)
  5. Enter the IP address of the share.
  6. Enter the share name of the drive, e.g., “music”.
  7. Under “Advanced” make sure “File Share Type” is set to CIS
  8. Enter Username and Password (if Guest connection isn’t available)
  9. Under Options, enter “vers=1.0” or “vers=2.0” (without quotes) if having connection troubles.

“Adding a Webradio”

  1. Navigate to your volumio.local on your network in your web browser.
  2. Go to Browse and select Web Radios.
  3. Click the menu button to the right of “My Web Radios” and select “Add Web Radio”.
  4. Enter the URL of the network stream (The URL can be either a stream URL or a M3U or PLS remote file) and click Add.
  5. Radio station should now appear in your My Web Radios section of the library.

“Change UPNP Name”

  1. Navigate to your volumio.local on your network in your web browser.
  2. Open “System” in the main menu (gearbox icon)
  3. Enter new name in your Player Name field.
  4. Restart Volumio from the Gear menu.

“Music on NAS not showing up in library”

Section out-of-date and no longer applicable. (I have 18k+ entries in my library and they all seem to be showing up)

“Which devices are supported”

add: Raspberry Pi 3 Model B, Raspberry Pi 3 Model B+, Raspberry Pi Zero, Raspberry Pi Zero W.
Maybe others?

“Access via SSH (with putty etc.)”

Access is disabled by default.
See instructions in Documentation to enable it.

“Formating[sic] a SD card quick and easy”

is this really a FAQ? Feels like this is well handled by Etcher for installation.

“Raspberry Pi B+ playing <44kbs”

Still relevant? Maybe Raspberry Pi B+ isn’t fully supported.

“No shares visible (volumio 1.5 non-Raspberry-Pi)”

Still relevant? Lot of references to 1.5 here. Not sure how many are still on the old platform in 2018.

“Symbolic link to your music (external drive / SD)”

Feels like a 1.5 thing.

“Updating MPD”

Is this still relevant or does Volumio’s built-in updater take care of that for us now?

While I’m generally in favor of pointing people to the actual documentation, the docs themselves refer back to the FAQ on the forum. :unamused:

volumio.github.io/docs/

Screen Shot 2018-07-15 at 9.35.53 AM.png

@robcee
You’re right ! Thank a lot for pointing that. I’m going to correct it.
We are working to improve docs, and any contribution is welcome ! So if you are familiar with github, you can submit a PR with improvement/correction you’d like to see .https://volumio.github.io/docs/Good_to_Knows/Contribute_to_this_Doc.html
If you are not github, just write here.
A good documentation is important to make Volumio as attractive as possible. But it takes a lot of time to do something readable and to keep it up to date. :wink:

hey @balbuze. Absolutely right. I’m still delving through the various github repos that make up Volumio. I’ll certainly help by sending PRs for the documentation if I spot anything.

I still don’t see any mention of trying to add SMB/CIFS Version options to the network drive. It’s a personal setup peeve of mine and am seeing a number of users here in the Help section having similar problems. It might be worth adding a section in the FAQ section (which is looking very good, btw!) to cover this and provide a central place we can point users to.

If I have time today I’ll send a PR.

cheers!

It’s a relatively new issue, and wasn’t causing problems when the initial FAQ in ‘docs’ was produced at the beginning of the year, but yes it certainly needs adding (plus a lot more really; the initial content was to stimulate ideas for inclusion, which didn’t happen).

I haven’t scanned the Github issues yet, but I’d even suggest adding a default version string to the options in volumio’s New Network Storage UI. And yes, if anybody has any other suggestions for Frequently Asked Questions, feel free to paste them in here as replies and I’ll help merge them into the docs if possible.

edit: Pull request sent. Will see about creating a pull request for the UI, though I don’t have a spare 'pi around for setting up a full dev environment yet.

cheers!