Skip to content

hong-seongmin/HWnow

Repository files navigation

HWnow: Real-time System Monitoring Desktop Application

A native desktop application built with Go + React + TypeScript + Wails v2 that provides real-time monitoring of your computer's key resources (CPU, Memory, Disk, Network, GPU).

✨ Key Features

  • πŸ–₯️ Native Desktop App: Cross-platform desktop application built with Wails v2 using web technologies
  • πŸ“Š Real-time Monitoring: Real-time system resource data collection and visualization at 3-second intervals
  • πŸŽ›οΈ Comprehensive Widgets:
    • CPU usage and individual core monitoring
    • Memory usage and detailed information
    • Disk I/O and capacity information
    • Network usage and status
    • GPU usage and process monitoring
    • System uptime, battery, process management, and more
  • 🎨 Customizable Dashboard:
    • Drag and drop widget positioning
    • Widget resizing with automatic saving
    • Widget management features (fullscreen, settings, remove)
  • πŸŒ™ Theme Support: Light/Dark mode support
  • πŸ“± Responsive Design: UI optimized for various screen sizes

πŸ–ΌοΈ Demo

HWnow demo β€” dashboard, add widget, CPU chart, drag & drop

Screenshots (click to expand)
Empty dashboard β€” right-click to add widgets
Empty dashboard β€” right-click to add widgets
Add Widget menu β€” CPU / Memory / GPU / Network
Add Widget β€” pick CPU / Memory / GPU / Network
CPU Usage widget with model and cores info
CPU Usage β€” model, cores/threads with live chart
Drag & drop, resize widget interactions
Drag & Drop / Resize β€” customize your dashboard

πŸš€ Quick Start

1. Prerequisites

  • Go (1.18 or higher) - for backend build
  • Node.js (18.x or higher) - for frontend build
  • Wails CLI - desktop app build tool

Install Wails CLI

go install github.com/wailsapp/wails/v2/cmd/wails@latest

2. Download Project & Run Development Server

git clone https://github.com/hong-seongmin/HWnow
cd HWnow
start.bat 1

3. Production Build

start.bat 2

πŸ“‹ Usage

Development Mode (Live Reload)

start.bat 1
  • Starts development server with automatic reload on code changes
  • Native desktop window opens automatically
  • Developer tools available

Production Build

start.bat 2
  • Generates optimized standalone executable HWnow-wails.exe (~30-40MB)
  • Final version for distribution

Direct Execution

After build completion, double-click HWnow-wails.exe to run

πŸ› οΈ Technology Stack

  • Backend: Go 1.24.5 + Wails v2
    • System monitoring: gopsutil
    • GPU monitoring: nvidia-smi integration
  • Frontend: React 18 + TypeScript + Vite
  • Desktop Framework: Wails v2

πŸ”§ Troubleshooting

Go Installation Error

go: command not found

Solution: Install from Go official site and verify environment variables

Node.js Installation Error

npm: command not found

Solution: Install LTS version from Node.js official site

Wails CLI Installation Error

wails: command not found

Solution:

go install github.com/wailsapp/wails/v2/cmd/wails@latest

Frontend Dependency Installation Failed

npm install failed

Solution:

cd HWnow-wails/HWnow-wails/frontend
rm -rf node_modules package-lock.json
npm install

GPU Monitoring Not Working

  • NVIDIA GPU: Verify nvidia-smi is in PATH
  • Other GPUs: Currently only NVIDIA GPU supported

βœ… Verified Build Environment

Test Environment: Windows 10/11, Go 1.24.5, Node.js v22.14.0, Wails v2.10.2

Build Performance

  • Development Server Start: 10-15 seconds (first run)
  • Production Build: 1-2 minutes (including dependency downloads)
  • Final Executable Size: 30-40MB (all dependencies included)

Execution Verification

  • βœ… Real-time CPU, Memory, Disk, Network, GPU monitoring
  • βœ… 3-second interval data updates
  • βœ… Drag and drop widget management
  • βœ… Light/Dark theme switching
  • βœ… Responsive layout

🎯 Key Widget Features

CPU Monitoring

  • Overall CPU usage
  • Individual core usage
  • CPU model name and core count display

Memory Monitoring

  • Real-time memory usage
  • Available memory
  • Memory usage percentage

GPU Monitoring

  • GPU usage (NVIDIA only)
  • GPU process list
  • GPU memory usage

System Information

  • System uptime
  • Process monitoring
  • Network status
  • Battery information (laptops)

πŸ’– Support & Sponsorship

If this project has been helpful, please consider supporting with a sponsorship!

Buy Me A Coffee

GitHub Repository: https://github.com/hong-seongmin/HWnow

πŸ“„ License

Apache License 2.0 - See LICENSE file for details.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors