Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/win0err/gnome-runcat
😼 The cat tells you the CPU usage by running speed
https://github.com/win0err/gnome-runcat
cats cpu-monitoring gnome gnome-shell gnome-shell-extension proc-stat
Last synced: about 2 months ago
JSON representation
😼 The cat tells you the CPU usage by running speed
- Host: GitHub
- URL: https://github.com/win0err/gnome-runcat
- Owner: win0err
- License: gpl-3.0
- Created: 2020-04-19T23:40:03.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-14T10:48:47.000Z (3 months ago)
- Last Synced: 2024-09-14T20:59:36.638Z (3 months ago)
- Topics: cats, cpu-monitoring, gnome, gnome-shell, gnome-shell-extension, proc-stat
- Language: JavaScript
- Homepage: https://extensions.gnome.org/extension/2986/runcat/
- Size: 965 KB
- Stars: 405
- Watchers: 3
- Forks: 28
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- stars - win0err/gnome-runcat
- awesome-gnome - RunCat
README
# 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](https://extensions.gnome.org/extension/2986/runcat/) for this extension.
[
](https://extensions.gnome.org/extension/2986/runcat/)
### Manual installation
#### From source code
If you want to install the extension from sources, clone [the RunCat repository](https://github.com/win0err/gnome-runcat), navigate to the cloned directory and run:
```bash
$ make install
```
#### Release ZIP-archive
If you want to install the extension from release zip-archive,
download `[email protected]` from [the releases section](https://github.com/win0err/gnome-runcat/releases) and run:
```bash
$ 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](https://extensions.gnome.org/extension/2986/runcat/) → ⚙️;
- 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 --no-translator -o po/.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 types:generate` — generate type definition for GJS environment;
- `npm run test:lint` — lint project files.
## macOS version
Thanks to [Takuto Nakamura](https://github.com/Kyome22/menubar_runcat) for [the macOS version](https://kyome.io/runcat/index.html) and cat images.
---
_Developed by [Sergei Kolesnikov](https://github.com/win0err)_