• Stars
    star
    546
  • Rank 81,396 (Top 2 %)
  • Language
    JavaScript
  • License
    GNU General Publi...
  • Created about 12 years ago
  • Updated 7 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Read-only mirror of https://gitlab.gnome.org/tuxor1337/hidetopbar. Pull requests and issues on GitHub cannot be accepted and will be automatically closed.

About Hide Top Bar

This GNOME extension helps to hide GNOME's top bar when it gets into your way.

In the extension's preferences, different behaviors can be specified: unhiding on mouse-over or on pressing a keyboard shortcut, or when no window requires the space.

clip

Installation from extensions.gnome.org

Unless you are on Debian or Ubuntu (see section below), the recommended way of installing Hide Top Bar is via the official builds on extensions.gnome.org/.../hide-top-bar/.

If you're installing via a Chrome browser, make sure you read the GNOME Shell integration for Chrome Installation Guide.

Debian

If you are using a Debian based distribution, the preferred installation method is to use the packaged version. By this, compatibility problems caused by different gnome-shell versions in your distribution can be avoided. You can install the package with:

sudo apt install gnome-shell-extension-autohidetopbar

If you find problems with the Debian packaged version, please file bugs at the Debian Bugtracking system.

Installation from source

If you insist on installing from source, the commands xgettext and msgfmt from the gettext package (package name may vary depending on your distribution) are required.

The procedure to install from source is as follows: Check out the source code into your local extensions directory, compile by running make, install and restart GNOME Shell. For example:

cd ~/.local/share/gnome-shell/extensions/
git clone https://gitlab.gnome.org/tuxor1337/hidetopbar.git [email protected]
cd [email protected]
make
cd ..
gnome-extensions enable [email protected]
gnome-shell --replace &

The last command restarts GNOME Shell in X11, but it won't work under Wayland. You might need to log off and on again for the install procedure to take effect under Wayland.

Updating the language strings

Whenever you notice that there are localizable strings in Hide Top Bar that are not covered by the strings in ./locale/, you can regenerate the *.pot-file using the following command:

make ./locale/hidetopbar.pot

To then incorporate the changes to the actual translation files for each language, run one of the following commands:

make all-po                                 # For updating the files for all languages
make ./locale/XX/LC_MESSAGES/hidetopbar.po  # For updating one specific po file, where 'XX' is the language code

As mentioned in the previous section, running make requires the gettext package to be installed (the package names may vary depending on your distribution).

Troubleshooting

Can I assign a shortcut to temporally disable the autohiding altogether?

Follow the instructions to assign a system-wide shortcut that disables/enables the extension.

Notification pop-ups cause the top bar to hide.

Using the extension Panel OSD, you can configure notification pop-ups to show up in a different position (e.g. a few pixels down) where they won't overlap with the top bar.

The panel overlaps with the dash/dock.

This is an issue of the extension Dash to Dock, see also this comment.

License

Copyright (c) 2013-2023 Thomas Vogt.

Copyright (c) 2012-2013 Mathieu Lutfy.

Copyright (c) 2012 Philip Witte.

Hide Top Bar is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Hide Top Bar is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Hide Top Bar (see COPYING.txt). If not, see gnu.org/licenses/.