.. _pureos_troubleshooting_gnome:

GNOME
=====


.. _pureos_troubleshooting_gnome_missing_dirs:

Apps don't see my folders for music, videos, etc.
-------------------------------------------------

**Problem**

Some of your apps cannot access your media directories (aka XDG directories).
For example, you can't choose picture from Pictures folder when setting background:

.. image:: ../img/gnome-photos/Screenshot_from_2017-06-20_19-18-32.png
   :scale: 50%
   :alt: gnome-photos: No pictures found

**Solution**

This usually happens if the xdg rules are missing.
You can fix this by creating a file within ``$HOME/.config/user-dirs.dirs`` with the following content:

.. code-block::

   XDG_DESKTOP_DIR="$HOME/Desktop"
   XDG_DOCUMENTS_DIR="$HOME/Documents"
   XDG_DOWNLOAD_DIR="$HOME/Downloads"
   XDG_MUSIC_DIR="$HOME/Music"
   XDG_PICTURES_DIR="$HOME/Pictures"
   XDG_PUBLICSHARE_DIR="$HOME/Public"
   XDG_TEMPLATES_DIR="$HOME/Templates"
   XDG_VIDEOS_DIR="$HOME/Videos"

Log out and then log back in.
GNOME software will now detect your media files:

.. image:: ../img/gnome-photos/Screenshot_from_2017-06-20_19-26-11.png
   :scale: 50%
   :alt: gnome-photos: Pictures found


.. _pureos_troubleshooting_gnome_gdm3_fails:

GNOME login screen does not appear
----------------------------------

**Problem**

The system successfully booted, but the GNOME display manager (``gdm3``) login screen does not launch.
Only a black screen with a login prompt appears:

.. code-block::

   PureOS GNU/Linux librem14 tty2
   
   librem14 login:

**Solution**

In some cases it might help to reconfigure the GNOME login manager.

#. Login with your username/password at the prompt:

   .. code-block::

      PureOS GNU/Linux librem14 tty2
   
      librem14 login: pureos
      Password:

#. Run the following command:

   .. code-block:: bash

      sudo dpkg-reconfigure gdm3

#. Restart the computer to see if it fixes the problem.

.. seealso::
   If the problem happened occurs a system upgrade, refer to :ref:`pureos_troubleshooting_system_upgrade_failure`.


.. _pureos_troubleshooting_gnome_mouse_issue:

Right-clicking on the touchpad behaves as a left-click
------------------------------------------------------

**Problem**

Following a software update, the secondary touchpad button (right click) behaves like a primary (left click) button click when pressing on the right side of the touch pad.

**Cause**

This is an upstream issue.
After an update, the upstream package overwrites the user preference (or changes the default behavior).

**Solution**

Change the mouse settings in **GNOME Tweaks** back to ``Area``.

.. image:: ../img/gnome-tweaks/Screenshot_from_2018-03-05_22-02-19.png
   :scale: 50%
   :alt: gnome-tweaks: Keyboard & Mouse settings

.. _pureos_troubleshooting_gnome_no_logs:

No logs displayed in GNOME Logs
-------------------------------

**Problem**

GNOME Logs does not display any logs or crash reports.
It may not launch at all (running ``gnome-logs`` from terminal may report a segfault).

**Cause**

Your user likely does not have permissions to read **journal** logs.

**Solution**

#. Add your user to the ``systemd-journal`` group:

.. code-block:: bash

   sudo usermod -aG systemd-journal USERNAME

...where ``USERNAME`` is your username.
You can find it by running the command:

.. code-block:: bash

   whoami

.. note::
   You must restart your computer for the group edit to be applied.


.. _pureos_troubleshooting_gnome_application_menu_extension:

Application Menu Extension
--------------------------

**Problem**

You want to use the GNOME Applications menu but see in `Tweaks <https://tracker.pureos.net/w/pureos/desktop/tweak_tool>`_ that the GNOME Application Menu extension has not loaded and cannot be enabled.

**Solution**

#. From **Show Applications**, open the **Utilities** folder and open a terminal emulator.
#. Copy and paste the following into the terminal emulator:

   .. code-block:: bash

      sudo apt install gnome-menus

#. Press ``Enter``.
#. Enter your password and follow the prompts.
#. Once it has completed, log out and log back into PureOS.
#. After the computer has booted, go into **Tweaks** and you should now be able to enable the Applications menu extension for GNOME.


.. _pureos_troubleshooting_gnome_web_audio_peaking:

GNOME Web jumps to maximum audio volume
---------------------------------------

**Problem**

GNOME Web jumps to maximum audio volume when playing sound

**Cause**

This is an issue that can occur when watching videos in GNOME Web.
It is due to a configuration in the PulseAudio Daemon configuration.

**Solution**

#. Open the terminal emulator and run the following command to edit the configuration file:

   .. code-block:: bash

      sudo nano /etc/pulse/daemon.conf

#. You will be prompted for your user password; type it and press ``Enter``.
#. Edit this line, from:

   .. code-block:: bash

      ; flat-volumes = yes

   to:

   .. code-block:: bash

      flat-volumes = no

#. Press ``Ctrl+X`` to exit ``nano``.
#. You will be prompted to save the file. Press ``y`` and then press ``Enter`` to save the file without modifying the filepath. The editor will close.
#. Reboot the device to apply the changes.