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.

Freon is a GNOME Shell extension for displaying CPU temperature, hard disk or solid state temperatures, video card temperature (NVIDIA, Catalyst, and Bumblebee supported), power supply voltage, and fan speed. You can choose which HDD/SSD or other devices to include, what temperature units to use, and how often to refresh the sensors readout, and they will appear in the GNOME Shell top bar.

NOTE: After installing, each user that wants it must still manually enable Freon 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 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, 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-freon.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-freon  srpm

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

# Optionally, get linting and validation information about the RPM.
fedora-review --name gnome-shell-extension-freon  --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.

Freon itself uses the GNU GPL version 2.