After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 743362 - Give a nicer welcome
Give a nicer welcome
Status: RESOLVED FIXED
Product: gnome-music
Classification: Applications
Component: general
3.14.x
Other Linux
: Normal normal
: 3.18
Assigned To: Vadim Rutkovsky
gnome-music-maint
Depends on:
Blocks:
 
 
Reported: 2015-01-22 17:15 UTC by Allan Day
Modified: 2015-06-17 11:08 UTC
See Also:
GNOME target: ---
GNOME version: 3.13/3.14


Attachments
screenshot (712.55 KB, image/png)
2015-01-23 17:17 UTC, Allan Day
Details

Description Allan Day 2015-01-22 17:15:48 UTC
When someone launches Music for the first time, and they don't have any content, this is what they see:

https://wiki.gnome.org/Design/Whiteboards/InitialStates?action=AttachFile&do=get&target=music.png

It's not very interesting, cool, fun, or welcoming. Instead, it would be better to show something with richer graphics and a more positive text. Mockups for this can be found here:

https://wiki.gnome.org/Design/Whiteboards/InitialStates#Initial_States

And there's an asset that can be used here - https://raw.githubusercontent.com/gnome-design-team/gnome-mockups/master/initial-app-states/assets/music-alt.png

This uses a photograph that is licensed under CC-BY-SA [1], so there needs to be an appropriate CREDITS file and mention in the about dialog.

[1] https://www.flickr.com/photos/_spy_/12270839403
Comment 1 Vadim Rutkovsky 2015-01-23 14:30:42 UTC
See new commits from https://git.gnome.org/browse/gnome-music/log/?h=wip/empty-state
Comment 3 Allan Day 2015-01-23 17:17:57 UTC
Created attachment 295293 [details]
screenshot

I just tried a work in progress implementation from wip/empty-states. A screenshot is attached. In general it looks good. There are a few minor issues though:

 * There are some quirks with the rendering of the image (I suspect that this is specific to my jhbuild install, but I thought I'd mention it).
 * The view switcher isn't shown - it should be (but be insensitive), to give the user an idea of how the app will work.
 * The link didn't work (could also be a jhbuild issue).
Comment 4 Vadim Rutkovsky 2015-02-28 17:16:06 UTC
(In reply to Allan Day from comment #3)
>  * There are some quirks with the rendering of the image (I suspect that
> this is specific to my jhbuild install, but I thought I'd mention it).
>  * The link didn't work (could also be a jhbuild issue).

I'll prepare a package to make sure jhbuild issues are not affecting this.

>  * The view switcher isn't shown - it should be (but be insensitive), to
> give the user an idea of how the app will work.
Fixed in https://git.gnome.org/browse/gnome-music/commit/?h=wip/empty-state&id=853f786bbf08701ab628b238b8cbdf88a996e947
Comment 5 van.de.bugger 2015-03-04 21:03:03 UTC
Hi,

Adding a nice welcome screen is a good idea but it is not enough. Documentation must be updated too. Now (Gnome 3.14.3) help on gnome-music is VERY limited. There is absolutely no information how add songs/albums/music to the application. 

    A simple and elegant replacement for using files to show the music directory.

Is a nice statement but it is not clear where "the music directory" is. If I understand correctly, its default name is "Music" and depends on user's locale. Moreover, it can be renamed (~/.config/user-dirs.dirs).
Comment 6 Matthias Clasen 2015-03-05 13:11:18 UTC
(In reply to van.de.bugger from comment #5)
> Hi,
> 
> Adding a nice welcome screen is a good idea but it is not enough.
> Documentation must be updated too. Now (Gnome 3.14.3) help on gnome-music is
> VERY limited. There is absolutely no information how add songs/albums/music
> to the application. 
> 
>     A simple and elegant replacement for using files to show the music
> directory.
> 
> Is a nice statement but it is not clear where "the music directory" is. If I
> understand correctly, its default name is "Music" and depends on user's
> locale. Moreover, it can be renamed (~/.config/user-dirs.dirs).

Well, I think that is why it is 'music directory' (a generic term) and not 'the “Music” directory' (a reference to a specific directory name).
Comment 7 Vadim Rutkovsky 2015-03-05 13:15:52 UTC
(In reply to van.de.bugger from comment #5)
> Adding a nice welcome screen is a good idea but it is not enough.
> Documentation must be updated too. Now (Gnome 3.14.3) help on gnome-music is
> VERY limited. There is absolutely no information how add songs/albums/music
> to the application. 
Please file a bug on that, we'll ask docs team to take a look

> Is a nice statement but it is not clear where "the music directory" is. If I
> understand correctly, its default name is "Music" and depends on user's
> locale. Moreover, it can be renamed (~/.config/user-dirs.dirs).
The new design from wip/empty-state shows a link to current Music directory
Comment 8 Matthias Clasen 2015-03-05 13:46:55 UTC
In that case, 

g_get_basename (g_get_user_special_dir (G_USER_DIRECTORY_MUSIC));

should give you the string to show for the link.
Comment 9 Vadim Rutkovsky 2015-06-17 11:08:11 UTC
Fixed in https://git.gnome.org/browse/gnome-music/commit/?id=d8cab8b.

Test instructions: in jhbuild shell edit ~/.config/user-dirs.dirs, update XDG_DOWNLOAD_DIR and XDG_MUSIC_DIR and run gnome-music. Unset 'did-initial-state' in gsettings to show initial screen again