# GNOME 44 Stack Upgrade Notes
WARNING: Please read this task in its entirety before commenting or upgrading. Seriously.
As is tradition, I'm opening up a task for everyone to report their issues with the GNOME 44 stack upgrade. It's absolutely important we maintain focus on reporting issues which are specifically related to this stack upgrade so we can best work to helping validate and resolve these issues. I welcome you to post a comment if an application is suddenly not working and you strongly believe it is the result of the new stack upgrade, such as it suddenly missing libraries or ones which may warrant a rebuild. If necessary, we may request you file a separate issue so we may obtain further detailed information, which we (#core_team_org, #triage_team) can reference in this task.
NOTE: This task content can only be modified by members of the Core Team or Global Maintainers. We will update the task as comments / feedback are received.
The objective of this task is to facilitate **technical** discussions around changes which have occurred in the GNOME Stack, such as:
- Updates mutter so that it's split into mutter and mutter common so that budgie can make use of the common package for their window manager
- Changes to GNOME Shell 44
- GNOME Applications
This testing is being performed on the unstable repository and may also involve or require real-time communication via our development matrix room. If you are not in matrix, use any supported Matrix client that we provide in the repo (e.g. Element, Nheko, Neochat) and look at [our Getting Involved Page](https://help.getsol.us/docs/user/contributing/getting-involved#matrix-chat) for connection details.
If you are not on the unstable repository and wish to help test, assuming you understand that the intent of unstable is to be the place where we break stuff and operate under the assumption you check matrix to know **when not to update**, you can run the below mentioned command to switch to the unstable repository:
```
sudo eopkg ar Solus https://cdn.getsol.us/repo/unstable/eopkg-index.xml.xz
```
## Upgrading Properly
**Do not run any commands until you fully read this section. Thank you.**
I cannot stress enough the importance of ensuring you upgrade properly and fully. If you are not on unstable already, you should **fully upgrade** your system by opting in to every package update available via the Software Center or running `sudo eopkg up` then reboot **before** switching over to unstable.
If you are on the unstable repository, likewise perform a **full upgrade** via either the Software Center or the Terminal, then reboot. If you use Budgie and GNOME and encounter the grey "Something happened" fullscreen window after a reboot and attempt to login, switch to a TTY (typically Ctrl+Alt+F2-9, pick one), login and run `sudo usysconf run -f` then reboot (`sudo reboot`).
If you are using GNOME Shell, you **need** to run the following command after the upgrade if you use GNOME Shell to properly reset your extensions back to the stock configuration:
```
gsettings reset org.gnome.shell 'enabled-extensions'
```
Seriously, be sure to **disable any extensions** which we do not provide / have enabled out-of-the-box. Otherwise you may have a completely broken GNOME Shell experience, or worse it'll crash and you'll have to go through loads of hoops such as hand modifying dconf key values and nuking some extension contents, etc. It is not my responsibility nor the responsibility of GNOME to ensure those extensions are maintained and updated against newer GNOME Shell APIs. If they break, you'll need to talk to the extension developer. Additionally ensure you are not updating the extensions we support and directly provide, such as Tray Icons Reloaded, through any software such as Extensions app and website It may result in a broken installation. If you "upgraded" extensions through that manner, it's suggested you uninstall them and reinstall the package equivalent if possible.
WARNING: Like I said earlier, reboot your system after upgrading. For real.
## GNOME Shell
GNOME Shell 44 predictably has a fundamentally changed user experience. I am shipping a slightly less modified GNOME Shell with this stack upgrade and some default theme changes for it.
1. The remaining extensions enabled by default, like Tray-Icons-Reloaded, are still supported and enabled.
## Known Issues or WIPs
### GNOME Shell
As with any desktop environment, there are wide range of issues with GNOME Shell. I would advise checking https://gitlab.gnome.org/GNOME/gnome-shell/issues before reporting them here. If there is a patch and we don't have it yet, I'll see about getting it added.
### Mutter
I currently have a couple patches in Mutter allow for triple buffering, should improve the experience. But it's an experimental patch that's not yet [upstream](https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1441)
## Deprecations / Held Back
There are several deprecations and packages held back (permanently) this cycle.
**Deprecations:**
- libatk and at-spi2-atk is now deprecated, as functionality has been merged into at-spi2 core package
**Undeprecations:**
- Epiphany is now undeprecated, we still recommend firefox for a better quality of life browser however.
- Gnome-Contacts is also now undeprecated
## Testing List
**Testing Notes:**
1. This list may not be comprehensive. Feel free to report other things!
2. Phabricator may indicate something is complete even if it isn't explicitly checked off. Ignore that and only look for the checkbox.
3. There are numerous sections within GNOME Control Center (Settings) that are only applicable to GNOME Shell. If something does not work under Budgie, it does not necessarily mean that functionality is actually broken, but rather it may be the unfortunate result of the functionality targeting a specific desktop environment.
- [x] Bluetooth
- Tested with Bluetooth pairing in GNOME Control Center with phone.
- [] Desktops
- [] Budgie Desktop
- [x] GDM (when co-installed with GNOME Shell)
- [x] LightDM + slick-greeter
- [ ] GNOME Shell
- [ ] GDM
- [ ] MATE
- [ ] Geolocation
- Tested with GNOME Weather
- [ ] IBUS
- [ ] Networking
- [x] Shares (Samba via Nautilus)
- [x] Wireless
- [ ] Wired
- [ ] Applications
- [ ] Abiword
- [ ] Aisleriot
- [ ] Baobab (Disk Usage Analyzer)
- [ ] Bookworm (due to Granite update)
- [ ] Claws Mail
- [ ] Evince
- [ ] Evolution
- [x] Four-in-a-Row
- [ ] Gaupol
- [ ] GEdit
- [ ] GIMP
- [x] GNOME 2048
- [ ] GNOME Calculator
- [ ] GNOME Calendar
- [ ] GNOME Control Center
- [x] About
- [x] Applications
- [x] Background
- [x] Bluetooth
- [x] Date & Time
- [ ] Devices
- [x] Color
- [x] Displays
- [x] Keyboard
- [ ] Mouse & Touchpad
- [ ] Printers
- [x] Removable Media
- [x] Networking
- [x] Wi-Fi
- [x] Wired
- [ ] Notifications
- [x] Online Accounts (Tested with a Google Account)
- [x] Power
- [x] Privacy
- [x] Region & Language
- [ ] Search (only applies to GNOME Shell)
- [ ] Sharing
- [x] Sound
- [ ] Universal Access
- [ ] Cursor Size
- [ ] Hearing -> Visual Alerts
- [ ] High Contrast
- [ ] Large Text
- [ ] Pointing -> Click Assist
- [ ] Pointing -> Double-Click Delay
- [ ] Pointing -> Mouse Keys
- [ ] Screen Reader
- [ ] Screen Keyboard
- [ ] Sound Keys
- [ ] Typing -> Repeat Keys
- [ ] Typing -> Cursor Blinking
- [x] GNOME Disks
- [x] GNOME Help / Yelp
- [x] GNOME Nibbles
- [x] GNOME Mines
- [x] GNOME Photos
- [x] GNOME Pomodoro
- [ ] GNOME Power Statistics (GNOME Power Manager)
- [ ] GNOME Logs
- [x] Celluloid
- [x] GNOME Mahjongg
- [x] GNOME Maps
- [x] GNOME Music
- [x] GNOME Sudoku
- [x] GNOME Tweaks
- [x] GNOME Videos (Totem)
- [x] Glade
- [x] Gthumb
- [x] Lollypop
- [ ] Lyx
- [x] Nautilus
- [ ] Pitivi
- [x] Polari
- [x] Quodlibet
- [x] Rhythmbox
- [x] Seahorse
- [ ] Simple Scan
- [x] Shotwell
- [x] Solus Software Center
- [x] Transmission
- [x] Vocal
- [x] budgie-extras applets if you happen to use them
- [x] gtkhash (optionally the caja extension)
Tested Networking shares via Nautlius.
- Samba shares work. I can see shares copy to and from and stream video from them.
- AppleFile Shares work. I can see shares copy to and from and stream video from them.
Tested Networking, Wireless
- Tested out setting up wireless connect with GNOME WiFi Settings. I could see all of my wireless networks and could connect to both 2.4 GHz and 5 GHz.
# GNOME 44 Stack Upgrade Notes WARNING: Please read this task in its entirety before commenting or upgrading. Seriously. As is tradition, I'm opening up a task for everyone to report their issues with the GNOME 44 stack upgrade. It's absolutely important we maintain focus on reporting issues which are specifically related to this stack upgrade so we can best work to helping validate and resolve these issues. I welcome you to post a comment if an application is suddenly not working and you strongly believe it is the result of the new stack upgrade, such as it suddenly missing libraries or ones which may warrant a rebuild. If necessary, we may request you file a separate issue so we may obtain further detailed information, which we (#core_team_org, #triage_team) can reference in this task. NOTE: This task content can only be modified by members of the Core Team or Global Maintainers. We will update the task as comments / feedback are received. The objective of this task is to facilitate **technical** discussions around changes which have occurred in the GNOME Stack, such as: - Updates mutter so that it's split into mutter and mutter common so that budgie can make use of the common package for their window manager - Changes to GNOME Shell 44 - GNOME Applications This testing is being performed on the unstable repository and may also involve or require real-time communication via our development matrix room. If you are not in matrix, use any supported Matrix client that we provide in the repo (e.g. Element, Nheko, Neochat) and look at [our Getting Involved Page](https://help.getsol.us/docs/user/contributing/getting-involved#matrix-chat) for connection details. If you are not on the unstable repository and wish to help test, assuming you understand that the intent of unstable is to be the place where we break stuff and operate under the assumption you check matrix to know **when not to update**, you can run the below mentioned command to switch to the unstable repository: ``` sudo eopkg ar Solus https://cdn.getsol.us/repo/unstable/eopkg-index.xml.xz ``` ## Upgrading Properly **Do not run any commands until you fully read this section. Thank you.** I cannot stress enough the importance of ensuring you upgrade properly and fully. If you are not on unstable already, you should **fully upgrade** your system by opting in to every package update available via the Software Center or running `sudo eopkg up` then reboot **before** switching over to unstable. If you are on the unstable repository, likewise perform a **full upgrade** via either the Software Center or the Terminal, then reboot. If you use Budgie and GNOME and encounter the grey "Something happened" fullscreen window after a reboot and attempt to login, switch to a TTY (typically Ctrl+Alt+F2-9, pick one), login and run `sudo usysconf run -f` then reboot (`sudo reboot`). If you are using GNOME Shell, you **need** to run the following command after the upgrade if you use GNOME Shell to properly reset your extensions back to the stock configuration: ``` gsettings reset org.gnome.shell 'enabled-extensions' ``` Seriously, be sure to **disable any extensions** which we do not provide / have enabled out-of-the-box. Otherwise you may have a completely broken GNOME Shell experience, or worse it'll crash and you'll have to go through loads of hoops such as hand modifying dconf key values and nuking some extension contents, etc. It is not my responsibility nor the responsibility of GNOME to ensure those extensions are maintained and updated against newer GNOME Shell APIs. If they break, you'll need to talk to the extension developer. Additionally ensure you are not updating the extensions we support and directly provide, such as Tray Icons Reloaded, through any software such as Extensions app and website It may result in a broken installation. If you "upgraded" extensions through that manner, it's suggested you uninstall them and reinstall the package equivalent if possible. WARNING: Like I said earlier, reboot your system after upgrading. For real. ## GNOME Shell GNOME Shell 44 predictably has a fundamentally changed user experience. I am shipping a slightly less modified GNOME Shell with this stack upgrade and some default theme changes for it. 1. The remaining extensions enabled by default, like Tray-Icons-Reloaded, are still supported and enabled. ## Known Issues or WIPs ### GNOME Shell As with any desktop environment, there are wide range of issues with GNOME Shell. I would advise checking https://gitlab.gnome.org/GNOME/gnome-shell/issues before reporting them here. If there is a patch and we don't have it yet, I'll see about getting it added. ### Mutter I currently have a couple patches in Mutter allow for triple buffering, should improve the experience. But it's an experimental patch that's not yet [upstream](https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1441) ## Deprecations / Held Back There are several deprecations and packages held back (permanently) this cycle. **Deprecations:** - libatk and at-spi2-atk is now deprecated, as functionality has been merged into at-spi2 core package **Undeprecations:** - Epiphany is now undeprecated, we still recommend firefox for a better quality of life browser however. - Gnome-Contacts is also now undeprecated ## Testing List **Testing Notes:** 1. This list may not be comprehensive. Feel free to report other things! 2. Phabricator may indicate something is complete even if it isn't explicitly checked off. Ignore that and only look for the checkbox. 3. There are numerous sections within GNOME Control Center (Settings) that are only applicable to GNOME Shell. If something does not work under Budgie, it does not necessarily mean that functionality is actually broken, but rather it may be the unfortunate result of the functionality targeting a specific desktop environment. - [x] Bluetooth - Tested with Bluetooth pairing in GNOME Control Center with phone. - [] Desktops - [] Budgie Desktop - [x] GDM (when co-installed with GNOME Shell) - [x] LightDM + slick-greeter - [ ] GNOME Shell - [ ] GDM - [ ] MATE - [ ] Geolocation - Tested with GNOME Weather - [ ] IBUS - [ ] Networking - [x] Shares (Samba via Nautilus) - [x] Wireless - [ ] Wired - [ ] Applications - [ ] Abiword - [ ] Aisleriot - [ ] Baobab (Disk Usage Analyzer) - [ ] Bookworm (due to Granite update) - [ ] Claws Mail - [ ] Evince - [ ] Evolution - [x] Four-in-a-Row - [ ] Gaupol - [ ] GEdit - [ ] GIMP - [x] GNOME 2048 - [ ] GNOME Calculator - [ ] GNOME Calendar - [ ] GNOME Control Center - [x] About - [x] Applications - [x] Background - [x] Bluetooth - [x] Date & Time - [ ] Devices - [x] Color - [x] Displays - [x] Keyboard - [ ] Mouse & Touchpad - [ ] Printers - [x] Removable Media - [x] Networking - [x] Wi-Fi - [x] Wired - [ ] Notifications - [x] Online Accounts (Tested with a Google Account) - [x] Power - [x] Privacy - [x] Region & Language - [ ] Search (only applies to GNOME Shell) - [ ] Sharing - [x] Sound - [ ] Universal Access - [ ] Cursor Size - [ ] Hearing -> Visual Alerts - [ ] High Contrast - [ ] Large Text - [ ] Pointing -> Click Assist - [ ] Pointing -> Double-Click Delay - [ ] Pointing -> Mouse Keys - [ ] Screen Reader - [ ] Screen Keyboard - [ ] Sound Keys - [ ] Typing -> Repeat Keys - [ ] Typing -> Cursor Blinking - [x] GNOME Disks - [x] GNOME Help / Yelp - [x] GNOME Nibbles - [x] GNOME Mines - [x] GNOME Photos - [x] GNOME Pomodoro - [ ] GNOME Power Statistics (GNOME Power Manager) - [ ] GNOME Logs - [x] Celluloid - [x] GNOME Mahjongg - [x] GNOME Maps - [x] GNOME Music - [x] GNOME Sudoku - [x] GNOME Tweaks - [x] GNOME Videos (Totem) - [x] Glade - [x] Gthumb - [x] Lollypop - [ ] Lyx - [x] Nautilus - [ ] Pitivi - [x] Polari - [x] Quodlibet - [x] Rhythmbox - [x] Seahorse - [ ] Simple Scan - [x] Shotwell - [x] Solus Software Center - [x] Transmission - [x] Vocal - [x] budgie-extras applets if you happen to use them - [x] gtkhash (optionally the caja extension)