RunCat for GNOME Shell

RunCat provides a key-frame animation to the GNOME Shell top bar.
Animation speed changes depending on CPU usage.

Installation

This is the recommended method for installation, as it doesn't require the build dependencies for installation. You can install this extension by visiting the GNOME Shell Extensions page for this extension.

Manual installation

From source code

If you want to install the extension from sources, clone the RunCat repository, navigate to the cloned directory and run, you need npm installed:

$ npm i # one time only
$ make install

Release ZIP-archive

If you want to install the extension from release zip-archive, download [email protected] from the releases section and run:

$ gnome-extensions install path/to/[email protected] --force

After installation:

1. Restart the GNOME Shell:
   • ALT+F2 to open the command prompt, and enter r to restart the GNOME Shell (available on Xorg only);
   • or Log Out, then Log In, if GNOME Shell won't restart;
2. Enable the extension:
   • Open GNOME Extensions → RunCat → On;
   • or Run in terminal: gnome-extensions enable [email protected].

Manage RunCat preferences

• Right-click on the extension button on the top bar → Settings;
• or Open GNOME Extensions → RunCat → ⚙️;
• or Open RunCat on GNOME Extensions portal → ⚙️;
• or Manage directly in dconf: dconf list /org/gnome/shell/extensions/runcat/.

Translations

Working with existing translations

make translations command extracts translatable strings and updates existing translations. Make sure that you've run this command before pushing changes.

• make po/messages.pot command extracts translatable strings;
• make po/*.po command updates existing translations.

Starting new translation

To create a new translation file, use the following command:
msginit -i po/messages.pot -l <locale> --no-translator -o po/<locale>.po.

Examples

Spanish locale: msginit -i po/messages.pot -l es --no-translator -o po/es.po.
Spanish (Argentina) locale: msginit -i po/messages.pot -l es_AR --no-translator -o po/es_AR.po.

Useful commands for developers

You need to install project JS dependencies first: npm i

• npm run test — run all available tests;
• npm run test:typecheck — check types;
• npm run test:lint — lint project files.

macOS version

Thanks to Takuto Nakamura for the macOS version and cat images.

---

Developed by Sergei Kolesnikov