ubuntubudgie / budgie-welcome

Welcome app for Ubuntu Budgie

Budgie Welcome

Welcome screen application to greet new users on their first login.

Translators

We need to translate budgie-welcome into your language/locale. Please help-out - visit:

https://www.transifex.com/ubuntu-budgie/budgie-welcome/

Installation

sudo apt install gir1.2-webkit2-4.1 python3-notify2 node-uglify sassc
git clone https://github.com/UbuntuBudgie/budgie-welcome.git

cd budgie-welcome

uglifyjs -o data/js/bootstrap.min.js data/js/bootstrap.js
uglifyjs -o data/js/baguetteBox.min.js data/js/baguetteBox.js
uglifyjs -o data/js/popper.min.js data/js/popper.js

bash sassc-compile.sh

Testing

cd budgie-welcome
./budgie-welcome -d

To test the live session

./budgie-welcome --force-session=live -d

To test a language or locale

./budgie-welcome --locale=pl

change "pl" to your language i18n shortcode

Screenshot

Live session

Normal session

LICENSES

The project contains files with a variety of licenses. For the complete list of licenses, see debian/copyright file.

budgie-welcome's Issues

uplift to bootstrap alpha 4

bootstrap.js is now at alpha 4

however bootstrap.min.css is alpha 2

investigate moving bootstrap.min.css to alpha 4 - or later

Improve panel transparency for Material Design theme

After switched to Material Design using Welcome app, Budgie panel is almost fully transparent.
Currently Transparent amount is 0.1, I think least 0.3 would be better.

And when Panel is Transparent, Turning off Panel shadow will make it better.

Use alternate Material Design theme upon detecting low-res screen

Currently, we use Adapta theme when Material Design mode is selected. We should also calculate the screen resolution; for lower resolution screens we should be using Adapta-Eta or Adapta-Nokto-Eta instead of Adapta (all available under the same repo in the same adapta-gtk-theme package).

Allow users to disable budgie-welcome on startup

Currently, the users aren't able to disable the budgie-welcome as an application that runs each time when booting into system. To disable startup users need to install gnome-tweak-tool. Disabling via builtin setting for startup items doesn't work since the budgie-welcome is not available as option to disable.

The reason for this proposition is because after first use, the budgie-welcome becomes redundant since it isn't dynamic app. It should be however accessible from main menu as it is now.

keyboard shortcuts

place-holder issue.

Need to validate all of the listed shortcuts - most look like "GNOME2" rather than budgie/GNOME-Shell.

It mentions "Compiz" - obviously not applicable for budgie-desktop

budgie-desktop specific shortcuts e.g. raven alt+N
applications alt +f2
ctrl+alt+del - exit the desktop

Global network status - Opinion required

Currently Welcome App shows "Not Connected" message in some pages if network is not available. You can check this using command line argument --force-no-net.

What is is your opinion about replacing these messages with a global network icon as shown in figure?

Additional change

• Disable all install buttons if network is not available

Advantage

• Reconnect action can be initiated from any page.

Modify the look and style

ok,

with regards to the actual welcome screen

@Udara-U3 any chance you can do a .png for the header "budgie-remix"?

Installation Help #1 is removed

I think the button colours should be the same as chat-room & community.

Maybe only use "dark arc themed" buttons for "Getting Started" and "Get Involved" - two areas we want people to definitely click.

Is there anyway we can get the icons to line up - it looks messy currently. Maybe indent icons from the left and right align text? @Udara-U3 what do you think?

Is there a way to get either the Install/software buttons to appear in the center below the logo?

@HEXcube are there moka icons that we can use to replace the current icons in the picture?

Obviously need to display "install" in live CD mode and "Software" in installed mode - will raise a separate issue about changing the python script running the app.

Arc theme should use Pocillo icons instead of Moka

as per the title - we should reset the icon themes to Pocillo not Moka.

Add icon to desktop entry

initial look-see

.desktop file doesnt have an icon associated with it - looks odd in the menu

the .desktop needs a "OnlyShowIn=Budgie;" so that it only launches for a budgie-desktop session

display version info

we need to add somehow a visual and/or command line method to display the version of budgie-welcome.

This is needed to ensure the debian file matches whatever we state as being "stable".

Current debian version is v0.3.9

Add facebook group and page to social icons.

As suggested by @Udara-U3 add facebook group and page icons in social icons.

This should a popover menu similar to G+ page and community.

Install apps error

You will get a error wile trying to install apps from recommendation tab in ubuntu 16.04.1

Recommendations page should be sorted

If possible with a bit of JavaScript - we should sort the div sections so that those recommendations already installed should appear at the bottom of the page. Those options not installed should be at the top.

Reference: https://stackoverflow.com/questions/34913953/move-an-element-one-place-up-or-down-in-the-dom-tree-with-javascript

Switch to Material Design fails

add skippy-xd as a recommendation

currently just packaging and testing skippy-xd (allows you to spread windows graphically) - this will be an optional install for xenial and yakkety users.

Would like to offer this as a recommended package to be installed via budgie-welcome

sudo apt install skippy-xd

Show the budgie-remix logo in the system Details screen

We need help to fix A small C based patch which is required to allow us to show the budgie-remix logo in the system Details screen. At the moment, it is hard-coded with the Ubuntu GNOME logo.

Add hover popup for social icons

like the G+ popup - from a consistency point of view consider adding a hover popup for the other social icons

Fix animation glitches

Fix animation glitches while changing pages

packaging issues from Ubuntu review

Daniel Holbach (Canonical)

"It looks like the debian/copyright file isn't quite right:
http://paste.ubuntu.com/22681254/

There are also no COPYING or LICENSE files shipped with the budgie-
welcome source. Could they be added?
"

add a switch to the language screen

ok - for the language screen we should add a big button to allow the user to switch to their keyboard entry of choice - IBUS (it is the default currently) to FCITX

This button needs to install the fcitx package

To switch to FCITX run "im-config -n fcitx"

update screenshot applet screenshot

Stefan (author of the screenshot applet) loves the recent video which showed his screenshot-applet picture.

He has requested that the screenshot be updated to this recent version:

• https://github.com/cybre/budgie-screenshot-applet/blob/master/screenshot.png

Fix problem in steam installation script

Update steam installation script to automatically accept EULA.

recommendation - flatpak for yakkety

flatpak is available in the repos without the need for a PPA.

project is wrongly named

ok - belatedly realised the project is wrongly named! We need a consistent name moving forward from budgie-remix to Ubuntu Budgie.

Suggest Budgie Welcome (budgie-welcome for package name)

To-Do:

1. change the github project name (I'll do that)
2. change the debian branch control and changelog file
3. change the .desktop file
4. change anywhere that refers to the .desktop file

show only on first run

For 17.04 we'll have budgie-welcome as part of the Plank launchers on first startup and also we'll add budgie-welcome as a pinned icon for users using the icon task list.

This makes budgie-welcome always running on startup a little redundant.

Lets introduce a first run capability - on the very first run of budgie-welcome - remember this so that budgie-welcome is not run on a subsequent logon UNLESS they have manually requested this on the bottom right radio/checkbox.

add budgie-desktop --version

lets add budgie-desktop --version results to the about box so that we have an easy way for users to display what version of the desktop they are using.

Material Desktop - UI Improvements

• Budgie Panel shadow has to be turned off for better UI look & feel
• Panel height is better with 32px

• With Material Design, only Budgie Panel dark mood doesn't do the job, Able get better look by enabling Gnome Global dark mood by gnome-tweak-tool we can use dconf settings to do this job.

update snap instructions

some new stuff we should make clear in our snap instructions

http://www.omgubuntu.co.uk/2016/08/command-sudo-snap-find-error-not-a-bug

hide "show this dialog" option on live CD

future enhancement:

this option is not applicable for a live CD - lets hide it.

replace about labelled button with an about icon

the labelled button looks a little odd - probably should be a "help-about-symbolic" icon

Changes required for the Python base app

Some notes to work through:

1. The app should use a headerbar to match GNOME 3 style
2. The app should work slightly differently between live CD mode and installed mode. Software button should be displayed on installed mode. Install button should be displayed on "live mode".
3. Worried that antegros base uses the obsolete webkit. 😟 Should be at least using webkit2. Need to have a look at this.
4. Do we really need to use simple-json module? Seems to be an unnecessary dependency. 😕 Coz, json should already been installed. Need to check this.
5. Various hard-coded "antegros" statements in the python code. Need to replace these.

Ask confirmation when launching installer.

When user clicks on INSTALL NOW button, show a popup dialog to ask the user this:

This will close Welcome App and launch installer. Do you want to continue?

• If user selects 'YES', close Welcome App and open Ubiquity Installer
• If user selects 'NO/CANCEL', close popup box

multiple panels on undo

https://bugs.launchpad.net/budgie-remix/+bug/1636800

ProblemType: Bug
DistroRelease:Budgie remix 16.10
Package: Budgie v10.2.8
Uname: Linux 4.8.0-26-generic
Architecture: 64 bit

When using the Budgie Welcome->Default Settings->Restore panels->Reset Budgie panel and then undo reset it will multiply the panel/s every time.
The single way to fix this is to restart the system.

Screenshots as per the bug report

Missing copyright information

placeholder:

there are lots of files not accounted for in the copyright section of the debian package.

Will copy and paste the list here later

reset panel code needs to use official method

from budgie-desktop later than v10.2.8 there is an official method to reset the panel

budgie-desktop --reset --replace &

i.e. the replaces the previous dconf method.

Fix alignment of buttons.

As suggested by @Udara-U3 fix alignment of buttons.

Desired features

This is a TODO list of features which needs to be implemented after releasing first preview(App in budgie-remix 16.04.1)

1. Option to switch between default themes Arc and Vertex. --> DM: kind of duplicates Raven. We've talked about Arc vs Material i.e. wholesale change (default wallpaper/theme/font/lock screen/greeter screen/plymouth) - if we aim for this, this would be better.
2. Installation queue. Currently, if we click on install/remove button when another installation/removal is in progress, it will show a well formatted error message saying another installation/removal is in progress and apt was unable to get lock.. Instead of this, we should maintain a queue and each request to install/remove software should be added to this queue.
3. Translation support.
4. Modification to work on low resolution screen. Currently app width is 992px. What to do if screen resolution is below that? --> DM: haven't looks at the webkit API - but should be able to scale/zoom the web-pages if the screen res is lower.

Include the ability to reset Budgie shell/panels

Like unity --reset and similar options provided by desktop shells, Budgie should have the ability to do a full reset.

Upstream Budgie doesn't have such an option currently. However, we can add a big button somewhere in the Budgie Welcome app together with a command line option.

To do a reset, kill the budgie-panel process, then reset gsettings:

dconf reset -f /com/solus-project/budgie-panel/

and finally relaunch budgie-panel:

nohup budgie-panel --replace &

For the command line variant, lets add a --reset argument to Budgie Welcome to do the above.

Material theme suggestions

In order to implement a user-based option to switch between Material Style and Arc Style, we need to find out a good theme that follows Material Design guide lines.

A few suggestions are listed here. Please update this list if you know some other themes and share your opinion on best theme.

Theme type	Available themes
GTK Theme	Paper, Adapta, Flat-Plat
Icon theme	Paper, Frosting
Cursors	Paper
Background	Use a wallpaper in standard package or something different?

Paper Theme(GTK, Icon, Cursor)

browser ballot

suggestion - web-browsers are the most often area where people need to customise their desktop

Lets investigate a nice simple ballot screen so that people can easily install their favourite web-browser.

i.e. add external repository for chrome, opera, pale-moon
+chromium

i.e. we should only offer browsers that are regularly updated - firefox and chromium are the only browsers directly from the repos that are updated. All others are effectively static for 6 months.

17.04 users need to install skippy-xd via PPA

skippy-xd will (not via us) be included in the main repositories ... however budgie-welcome can and will be installed through the main repositories.

We need (for 17.04 and later) users to add the budgie-remix PPA when someone selects to install skippy-xd found in the recommendations page.

various hyperlinks and button links dont work

1. System Specifications there is a hyperlink that doesnt seem to do anything - "Why do I see two units"
2. similarly "Raven" in Recommendations - should this be a hyperlink?
3. all the hyperlinks on the "Get Involved" page crash and burn.
4. Raven Control Center button on Getting Started - Customisation doesnt do anything

Restructure and cleanup

Ok - first things first. It doesn't matter if we take Antergos as the base or Ubuntu MATE. There is an lot of the Ubuntu MATE Welcome we need that is not covered by Antergos. Likewise there is a lot of Ubuntu MATE Welcome that we don't need.

• If we take the Antergos as base then we'll need to copy the relevant MATE screens that we are going to reuse ... together with the linked images, css, javascript etc. - I suspect this will be more work with this approach - effectively recoding stuff that has been already written.
• If we take the MATE Welcome as base (what we have at the moment), we need to cleanup and remove the cruft. Lets assume the MATE Welcome as base - i.e. what we have at the moment.

The current file and folder structure of the welcome source is good to proceed. In the Data folder:

1. Delete shop.html, rpi.html, gettingstarted.html, helloguest.html, hellolive.html, involved.html, readme.html, software.html, software-only.html and splash.html
2. Delete fonts folder.
3. Move aside contents of the img folder. Then launch firefox and open welcome.html, move back all the missing images until the screen works again i.e. click the refresh button to force a reload.

Specific "mate" named files should be replaced by "distro" - this is so that when we move from "budgie-remix" to "Ubuntu Budgie" we won't have to rework the filenames. For e.g. welcome/ubuntu-mate-gray.svg would need to be named welcome/distro-gray.svg.

The other pages are covered by individual issues.

16.04.1 Testing - Lock screen setting has no effect

Running in Virtual Box:

Settings/Background, Looks like changing the Lock Screen has no effect when the screen is locked.

Improvements to Recommendations page

• From a presentation point of view, snaps should be at the top of the page and not at the bottom
• We should add a recommendation to install the budgie-screenshot-applet as well
• Assuming we get official status, a recommendation would be to add our PPA to get the latest stuff! But, let's worry about that later 😄

Write a user guide on Budgie desktop

There is a guide here: https://github.com/solus-project/user-guide

We can use this to guide us. However, we CANNOT copy the pictures, words because the license is "Non Commercial" which violates Ubuntu repo rules. 😮

So we need to create our own words and images, but we can look at the guide for ideas only.

welcome app thinks its installed rather than a live cd

testing latest daily iso - welcome app starts without the option to install i.e. thinks its installed.

note - we use "df | grep -w / | grep -q '/cow'" to test if running on a live CD

"df | grep -w /" just returns this in this latest yakkety

aufs 747448 47068 720380 7% /

looks like kernel 4.8 has changed the results of df so should adjust the check to look for aufs.

Recommendations page header disappears on scrolling

hmm - the scrolling issue with the recommendations header is back again - you can scroll down the page and the recommendations header disappears.

UI Improvements

• First thing is Welcome app can't move anywhere, should make that top bar as a title bar.

• I can see Open source icon is overlapped with text so we have to fix it.
  And right top we can see little white space, It's scroll bar. We should move it in the below of Top bar. So it would be nicer.

• As @HEXcube Made some button improvements before, this button is also have to improve aligning text to the middle of the button.

• Snap should be the first recommendation. ( Move to top )

• Twitter icon is missing in this Community page and We can use Inverted budgie-remix logo instead of Original icon for the Button.

• We can Also add budgie-remix website Opportunities page to Get Involved page

• So finally, in this donate page we can use Official donate buttons with bit enlarge size instead of this small normal buttons

JavaScript issues stopping inclusion into upstream repos

Canonical devs have commented about these issues:

E: budgie-welcome source: source-is-missing data/js/bootstrap.min.js
E: budgie-welcome source: source-is-missing data/js/tether.js line length is 566 characters (>512)

Debian does not like the unreadable javascript files - we should find the non-compressed versions of these files and the debian package should use "uglifyjs" to-do the compression.

@niyasc - any ideas where we can get the non-compressed versions of those files?

https://github.com/twbs/bootstrap ???

I'll do the packaging changes to recompress the sources.