|
| 1 | +[中文](README.md) | [English](README.en.md) |
| 2 | +# System Monitor Cinnamon |
| 3 | + |
| 4 | +A small tool to display CPU usage, memory usage, and real-time network speed in the Cinnamon desktop panel. |
| 5 | +Inspired by [RunCat365](https://github.com/Kyome22/RunCat365) |
| 6 | + |
| 7 | + |
| 8 | +## Features |
| 9 | + |
| 10 | +- 📊 Real-time display of CPU usage |
| 11 | +- 💾 Shows memory usage |
| 12 | +- 🌐 Shows network upload/download speed |
| 13 | +- 🎨 Customizable icon themes (cat/horse) |
| 14 | +- 🌓 Supports auto/dark/white icon themes |
| 15 | +- ⚙️ Adjustable refresh rate |
| 16 | +- 🎯 Lightweight, low resource consumption |
| 17 | + |
| 18 | +## Installation |
| 19 | +1. Extract .zip archive to ~/.local/share/cinnamon/applets |
| 20 | +2. Enable the applet in Cinnamon settings |
| 21 | + |
| 22 | +## Usage |
| 23 | + |
| 24 | +After installation, the applet will automatically display system monitoring information on the panel. The default format is: |
| 25 | + |
| 26 | +``` |
| 27 | +CPU: 45% | MEM: 2.1G/8G | ↑ 1.2MB/s ↓ 500KB/s |
| 28 | +``` |
| 29 | + |
| 30 | +## Configuration Options |
| 31 | + |
| 32 | +Right-click the applet and select "Configure" to adjust the following options: |
| 33 | + |
| 34 | +- **Show network speed**: Controls whether to display network speed on the panel. |
| 35 | +- **Refresh rate**: Sets the data update interval (1-60 seconds). |
| 36 | +- **Icon theme**: Choose the icon color theme (follow system/white/black). |
| 37 | +- **Animation icon**: Choose the animation icon type (cat/horse). |
| 38 | + |
| 39 | +## Project Structure |
| 40 | + |
| 41 | +``` |
| 42 | +system-monitor-cinnamon/ |
| 43 | +├── applet.js # Main program file |
| 44 | +├── metada.json # Applet metadata |
| 45 | +├── setting-schema.json # Configuration options definition |
| 46 | +├── stylesheet.css # Style file |
| 47 | +├── icons/ # Icon resources |
| 48 | +│ └── runners/ |
| 49 | +│ ├── cat/ # Cat animation icons |
| 50 | +│ └── horse/ # Horse animation icons |
| 51 | +├── po/ # Translation files |
| 52 | +└── README.md # Project description |
| 53 | +``` |
| 54 | + |
| 55 | +## Technical Implementation |
| 56 | + |
| 57 | +- Written in JavaScript (ES6) |
| 58 | +- Based on the Cinnamon Applet framework |
| 59 | +- Reads CPU, memory, and network data from system files |
| 60 | + |
| 61 | +## Troubleshooting |
| 62 | + |
| 63 | +If the applet is not working correctly, try the following solutions: |
| 64 | + |
| 65 | +1. Restart Cinnamon: Press `Ctrl+Alt+Esc` or run `cinnamon --replace` |
| 66 | +2. Check system logs: View error messages in `~/.xsession-errors` |
| 67 | +3. Make sure necessary dependencies are installed on your system. |
| 68 | + |
| 69 | +## Author |
| 70 | + |
| 71 | +MainPoser - 2026 |
0 commit comments