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

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.

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

If you want to install the extension from release zip-archive, download runcat@kolesnikov.se.shell-extension.zip from the releases section and run:

$ gnome-extensions install path/to/runcat@kolesnikov.se.shell-extension.zip --force

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 runcat@kolesnikov.se.

• 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/.

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.

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

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.

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.

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

Developed by Sergei Kolesnikov