Skip to content

TaskBar Troubleshooting

Jump to bottom
C0ldPlasma edited this page Jul 11, 2020 · 3 revisions

TaskBar Troubleshooting

For questions, comments, ideas, bugs, etc. open a new Issue here on GitHub.

Please provide the following information:

  • TaskBar 2020 Version
  • GNOME Shell Version
  • Operating System and Version
  • Issue: Please provide as much detailed information as possible:
    Steps to reproduce the issue
    Performed troubleshooting steps
    Error messages
    Screen shots

Advised Troubleshooting steps:

  • Disable and re-enable TaskBar 2020 with 'GNOME Tweak Tool'.

  • Restart GNOME Shell:
    X11: [ Alt ]-[ F2 ] + [ r ]
    Wayland: Make sure to save your work, then log out and log back in.

  • Reset all TaskBar 2020 settings at the 'About' tab in the TaskBar 2020 preferences window,
    or by terminal:
    dconf reset -f /org/gnome/shell/extensions/TaskBar/
    Restart GNOME Shell.
    If the issue stops occurring after the reset, it might be related to a single TaskBar setting.

  • Disable all other GNOME Shell Extensions with 'GNOME Tweak Tool' and restart GNOME Shell to see if the issue is TaskBar related only.

  • TaskBar has to be located in only one of these two directories:
    $HOME/.local/share/gnome-shell/extensions/TaskBar@c0ldplasma/
    /usr/share/gnome-shell/extensions/TaskBar@c0ldplasma/
    If it is located in both, then remove TaskBar 2020 from one of the two:
    rm -r "$HOME/.local/share/gnome-shell/extensions/TaskBar@c0ldplasma/"
    or
    sudo rm -r /usr/share/gnome-shell/extensions/TaskBar@c0ldplasma/
    This might happen for example, when installing from the GNOME Shell Extensions Website and from a repository.

  • Verify if TaskBar 2020 is installed at it's latest version.
    The TaskBar 2020 version can be found at the 'About' tab in the TaskBar 2020 preferences window, or at the bottom of the metadata.json file in the TaskBar@c0ldplasma folder.
    TaskBar Installation Wiki

  • Remove TaskBar 2020 and re-install:
    Remove:
    rm -r "$HOME/.local/share/gnome-shell/extensions/TaskBar@c0ldplasma/"
    and
    sudo rm -r /usr/share/gnome-shell/extensions/TaskBar@c0ldplasma/
    to make sure it is completely removed.
    Re-install:
    TaskBar Installation Wiki

Clone this wiki locally