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:

  • If you've already installed the GNOME Shell integration web browser plugin, go to https://extensions.gnome.org/local/, 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, you can finally fetch the package's sources, build everything using fedpkg, and/or get a bunch of linting information using fedora-review.

# Fetch the upstream source tarball.
spectool --get-files ./gnome-shell-extension-activities-configurator.spec

# If you only need the SRPM, this will be much faster.
# NOTE: fXX is the target Fedora release. For Fedora 99, you'd use `f99`.
fedpkg --release fXX  --module-name gnome-shell-extension-activities-configurator  srpm

# Otherwise, a mock build will produce both an SRPM and RPM.
fedpkg --release fXX  --module-name gnome-shell-extension-activities-configurator  mockbuild --no-clean-all

# Optionally, get linting and validation information about the RPM.
fedora-review --name gnome-shell-extension-activities-configurator  --mock-config fedora-rawhide-x86_64

If you wanted to just want to install the package, you should set fedpkg to target your current release of Fedora, do a mock build, and install the resulting RPM in the results*/ directory. If you're doing tests on the package spec, then fedora-review only needs the spec and an SRPM, but prefers to run against a Rawhide build (so replace instances of XX with the current number for Rawhide).

License

Everything specific to this repository uses the MIT License.

Activities Configurator itself uses the GNU GPL version 2.