explaingit

tnt-likely/panbar

★ 14SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A free macOS menu bar app that shows a live scrolling stock ticker for Chinese A-share, Hong Kong, and US markets, with portfolio tracking, price alerts, and local-only data storage.

Mindmap

mindmap
  root((PanBar))
    Markets
      China A-shares
      Hong Kong
      US markets
    Features
      Live ticker
      Portfolio value
      Price alerts
      Market indices
    Privacy
      Local storage only
      Screen-share hide
      No analytics
    Customization
      Multiple data sources
      Keyboard shortcuts
      JSON backup restore
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Track your stock portfolio across Chinese A-shares, Hong Kong, and US markets all from your Mac menu bar.

USE CASE 2

Set price alerts with AND and OR logic that only fire during trading hours so you do not get notifications on weekends.

USE CASE 3

Back up your entire PanBar setup as a single JSON file and restore it on a new Mac in seconds.

Tech stack

SwiftSwiftUImacOS

Getting it running

Difficulty · easy Time to first run · 5min
Free to use for any purpose including commercially, as long as you keep the MIT license notice.

In plain English

PanBar is a free macOS app that sits in your menu bar and shows live stock prices as a scrolling ticker across the top of your screen. It covers stocks from China's A-share market, Hong Kong, and US markets all in one place. The README is primarily in Chinese, so this explanation is based on a translation of its contents. The scrolling bar shows the prices of whichever stocks you choose to follow, along with summary numbers for today's gains or losses, your total portfolio value, and your cumulative returns. Clicking the menu bar opens a compact panel where you can see your full holdings, major market indices (including the Shanghai Composite, Nasdaq, S&P 500, and others), and any price alerts you have set up. The app automatically converts amounts into the correct currency for each market. For price alerts you can set conditions using multiple criteria combined with AND or OR logic, limit how many times an alert triggers per day, and restrict alerts to trading hours or weekdays only. The app can pull price data from several sources including Tencent, Dongfang Finance, Yahoo Finance, and Finnhub, and you can set a priority order per market. All data is stored locally on your machine using a small database file. There is no analytics tracking, no cloud sync, and no ads. A privacy mode automatically hides the ticker when you are screen sharing, and you can also toggle it manually with a keyboard shortcut. The app supports both Simplified Chinese and English, lets you customize all keyboard shortcuts, and can back up and restore your entire setup as a single JSON file. PanBar is free and open source under the MIT license. A signed installer is available from the releases page, or you can build it from source using Xcode.

Copy-paste prompts

Prompt 1
I use PanBar to track my portfolio. Write an Automator or Shortcuts workflow that exports my PanBar JSON backup and saves it to iCloud Drive at the end of each trading day.
Prompt 2
Help me configure PanBar to display only US stocks during US market hours and automatically switch to showing A-shares during the Chinese trading session.
Prompt 3
I want to add a custom data source to PanBar. Show me how to write a small local server that returns stock quotes in the format PanBar's Finnhub provider expects.
Open on GitHub → Explain another repo

← tnt-likely on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.