whatisgithub

What is coolrun?

kuaoaoaoao/coolrun — explained in plain English

Analysis updated 2026-05-18

17SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A macOS menu bar app showing live gold prices in yuan and a spinning coin icon that speeds up with CPU usage, plus a full system monitor.

Mindmap

mindmap
  root((coolRun))
    What it does
      Menu bar gold price
      Spinning coin CPU indicator
      System monitor panel
    Monitored stats
      CPU and memory
      Storage and battery
      Network speed
      Temperature and fans
    Gold price
      JD Finance API
      No account needed
      Yuan per gram
    Build
      Swift and SwiftUI
      Xcode required
      Unsigned build warning

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep an eye on live gold prices in yuan per gram from the macOS menu bar.

USE CASE 2

Get an at-a-glance sense of how busy your Mac's CPU is from the spinning coin icon.

USE CASE 3

Check detailed CPU, memory, network, and temperature stats without opening Activity Monitor.

What is it built with?

SwiftSwiftUIAppKit

How does it compare?

kuaoaoaoao/coolrunalbertofettucini/councill-nemu/travelminimal
Stars171717
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencegeneralpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The app is unsigned, so macOS shows a Gatekeeper warning on first launch.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

coolRun is a small macOS app that sits in the menu bar and shows the live price of gold in Chinese yuan per gram, pulled from a third-party pricing API. The icon it uses is a spinning coin: the faster your computer's processor is working, the faster the coin spins. This gives you a quick visual sense of how busy your Mac is at any given moment without needing to open any other tool. Clicking the coin icon opens a system monitoring panel that shows a range of current stats: CPU usage across all cores, memory usage and pressure, storage space used and available, battery level and charging state, network connection details and upload/download speeds, system uptime, temperature readings for the CPU and GPU, and fan speed. Each metric includes color coding to indicate healthy or concerning states. The panel keeps a short history of recent readings displayed as small trend graphs. The gold price display is the distinctive feature. The app fetches data from a JD Finance API endpoint that provides the spot price from Zhejiang Commercial Bank's accumulated gold product. No account or API key is required. The app shows the price in the format 973.24 yuan per gram and makes clear that this data is for display only and does not constitute investment advice. The app is built in Swift using SwiftUI and AppKit, and requires macOS and Xcode to build from source. Pre-built downloads are available from the GitHub Releases page as a DMG or ZIP file. The README notes that the app is not signed with an Apple developer certificate, so macOS may show a warning on first launch, which the README explains how to work around. No user data is collected or sent anywhere. System stats are read locally, and the only outbound network request is to fetch the gold price. The project is MIT licensed.

Copy-paste prompts

Prompt 1
Explain how coolRun turns CPU usage into the spinning speed of its menu bar coin icon.
Prompt 2
Walk me through downloading and running coolRun on macOS despite it not being signed with an Apple developer certificate.
Prompt 3
What system stats does coolRun's monitoring panel show, and how often are they refreshed?

Frequently asked questions

What is coolrun?

A macOS menu bar app showing live gold prices in yuan and a spinning coin icon that speeds up with CPU usage, plus a full system monitor.

What language is coolrun written in?

Mainly Swift. The stack also includes Swift, SwiftUI, AppKit.

What license does coolrun use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is coolrun to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is coolrun for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.