{"id":27797781,"url":"https://github.com/rizzbrew/statsmonit","last_synced_at":"2026-05-09T14:10:57.425Z","repository":{"id":290222622,"uuid":"973724094","full_name":"rizzbrew/statsmonit","owner":"rizzbrew","description":"StatsMonit is a lightweight server monitoring tool built with Node.js and Socket.io. It provides real-time system statistics, including CPU usage, RAM usage, disk space, network activity, and uptime.","archived":false,"fork":false,"pushed_at":"2025-04-27T17:06:58.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-27T17:33:01.713Z","etag":null,"topics":["express-js","socket-io","stats-monitor","tailwaind"],"latest_commit_sha":null,"homepage":"https://statsmonit-demo.rizzy.eu.org/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rizzbrew.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-27T15:53:12.000Z","updated_at":"2025-04-27T16:50:31.000Z","dependencies_parsed_at":"2025-04-27T17:33:27.984Z","dependency_job_id":null,"html_url":"https://github.com/rizzbrew/statsmonit","commit_stats":null,"previous_names":["rizzbrew/statsmonit"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rizzbrew%2Fstatsmonit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rizzbrew%2Fstatsmonit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rizzbrew%2Fstatsmonit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rizzbrew%2Fstatsmonit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rizzbrew","download_url":"https://codeload.github.com/rizzbrew/statsmonit/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251791528,"owners_count":21644410,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["express-js","socket-io","stats-monitor","tailwaind"],"created_at":"2025-04-30T22:30:59.088Z","updated_at":"2026-05-09T14:10:52.406Z","avatar_url":"https://github.com/rizzbrew.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StatsMonit\n\n\u003cp align='center'\u003e \n   \u003ca href=\"https://rizzy.eu.org\"\u003e\n      \u003cimg src=\"https://i.ibb.co.com/gM4sFf1x/image.png\"/\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\n**StatsMonit** is a lightweight server monitoring tool built with **Node.js** and **Socket.io**. It provides real-time system statistics, including **CPU usage, RAM usage, disk space, network activity**, and **uptime**.\n\n## 🚀 Features\n\n- **Real-time Monitoring**: Get live updates every 3 seconds.\n- **CPU Usage**: Shows CPU load percentage and model details.\n- **Memory Usage**: Displays RAM consumption with detailed usage statistics.\n- **Disk Statistics**: Provides total, used, and available disk space.\n- **Network Traffic**: Monitors incoming and outgoing network activity.\n- **Cross-platform**: Works on Linux, Windows, and macOS.\n\n## 📦 Installation\n\n### Prerequisites\n- **Node.js** (v18 or higher)\n- **NPM** (comes with Node.js)\n\n### Steps\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/rizzbrew/statsmonit\n   ```\n2. Navigate into the project folder:\n   ```bash\n   cd statsmonit\n   ```\n3. Install dependencies:\n   ```bash\n   npm install\n   ```\n   or\n   ```bash\n   npm i -g pnpm\n   pnpm install\n   ```\n4. (Optional) Configure environment variables:  \n   Create a `.env` file and specify the port (default: `8088`).\n   ```env\n   PORT=8088\n   ```\n\n## 🛠 Usage\n\n### Start the Server\nRun the following command to start the monitoring service:\n```bash\nnpm start\n```\n```bash\npnpm start\n```\nor manually using:\n```bash\nnode index.js\n```\n\n### Access the Dashboard\nOnce the server is running, open your browser and visit:\n```\nhttp://localhost:8088\n```\nThe server will continuously send system statistics to the client using **WebSockets (Socket.io)**.\n\n## ⚙️ How It Works\n\n1. **Server Setup**  \n   - Uses **Express.js** to serve static files.\n   - Runs an **HTTP server** with **Socket.io** for real-time communication.\n\n2. **Data Collection**  \n   - Uses **OS module** to fetch CPU, RAM, and system details.\n   - Uses **diskusage** to check disk space.\n   - Uses **node-os-utils** to fetch CPU and network statistics.\n   - Uses **systeminformation** to fetch CPU and network statistics (on windows).\n\n3. **Real-time Updates**  \n   - The server collects system stats every **3 seconds**.\n   - Data is sent to connected clients via **WebSockets**.\n\n## 🏗 Build Tailwind CSS\n\nIf you are using **Tailwind CSS** for styling, you can compile the CSS using:\n```bash\nnpm run build\n```\nThis will generate a minified CSS file for production.\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to **open an issue** or **submit a pull request** if you find any improvements or bugs.\n\n## 📜 License\n\nThis project is licensed under the **MIT License**.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frizzbrew%2Fstatsmonit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frizzbrew%2Fstatsmonit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frizzbrew%2Fstatsmonit/lists"}