README.md

RPM packaging of the GNOME Shell extension Activities Configurator

I'm writing RPM specs for some of my favorite GNOME Shell extensions. I'm building these for Fedora because they weren't packaged there yet, but the specs will probably work for other RPM-based distributions too.

You can of course easily browse and install these addons from the GNOME Shell Extensions website. But then you have to remember to periodically revisit the web app and check for any updates to the extensions you've installed. If you install the RPM packages, then the Shell extensions can be automatically updated with the rest of your system.

This package is for Activities Configurator, which has its own GNOME Shell extension page and source code repository.

Activities Configurator gives you all sorts of options to control the look and feel of the top bar and Activities button in GNOME Shell, possibly even overriding your current Shell theme. You can change or remove the Activities button text, add an icon, move it to right corner, change the top bar's background color and transparency... You can toggle the Overview if no applications are running (at login and whenever the last application window is closed). You can also adjust the "pressure" threshold for the hot corner, or disable it altogether.

NOTE: After installing, each user that wants it must still manually enable Activities Configurator before it will take effect. You can do so a few different ways:

  • Go to https://extensions.gnome.org/local/ using Firefox, find the extension, and click the switch to "ON."
  • Open GNOME Tweak Tool, go to the Extensions tab, find the extension, and click the switch to "ON."
  • Open a terminal or the desktop's command dialog, and (as your normal user account) run: gnome-shell-extension-tool --enable activities-config@nls1729

You may also need to restart GNOME Shell (Open the command dialog with Alt-F2, type r, and hit enter), or log out and log back in.

Building

If you want to build everything yourself, you'll need to set up your packaging environment as described in the Fedora Wiki.

Once that's ready, and you have a clone of this repository and have fetched the extension's sources, you just need two commands:

# Build a source RPM from the spec file and local tarballs.
mock --root fedora-rawhide-x86_64  --buildsrpm  --spec ./gnome-shell-extension-activities-configurator.spec  --sources ./  --resultdir ./  --no-clean
# Optionally, also build the binary RPM from the generated source RPM.
mock --root fedora-rawhide-x86_64  --rebuild ./gnome-shell-extension-activities-configurator-VERSION-RELEASE.src.rpm  --resultdir ./  --no-clean

...Replacing "VERSION" and "RELEASE" with the actual values for the current build.

License

Everything specific to this repository uses the MIT License.

Activities Configurator itself uses the GNU GPL version 2.