README.md

RPM packaging of the GNOME Shell extension Freon

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 Freon, which has its own GNOME Shell extension page and source code repository.

DESCRIPTION

NOTE: After installing, each user that wants it must still manually enable Freon before it will be usable. 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 the Extensions tab, find the extension you want, 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 freon@UshakovVasilii_Github.yahoo.com

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 --buildsrpm  --spec ./gnome-shell-extension-freon.spec  --sources ./  --resultdir ./
# Optionally, build the binary RPM from the generated source RPM.
mock --rebuild ./gnome-shell-extension-freon-VERSION-RELEASE.src.rpm  --resultdir ./

...Replacing "VERSION" and "RELEASE" with the actual values for the current build. Adding --no-clean to the mock commands will speed things up, though working with a "clean" environment can help make completely sure you run a consistent and reliable build.

License

Everything specific to this repository uses the MIT License.

Freon itself uses the GNU GPL version 2.