DankMaterialShell StockManager Plugin

April 3, 2026 Β· View on GitHub

A real-time A-share stock quote monitoring plugin for DankMaterialShell.

πŸ‡¨πŸ‡³ English | δΈ­ζ–‡

Features

  • πŸ“Š Live Quotes – Automatically refreshes stock data every 30 seconds
  • πŸ“ˆ Gain/Loss Display – Red for gain, green for loss, clear at a glance
  • πŸ” Multi-Stock Monitoring – Monitor multiple stocks simultaneously
  • πŸ“± DankBar Integration – Shows Shanghai Composite Index change in the status bar
  • πŸ”” Price Alert – Set custom threshold for each stock, get notified when triggered

Screenshot

StockManager screenshot

Keyboard Shortcuts

  • F – Search / Add Stock
  • E – Toggle Edit Mode
  • R – Refresh Data
  • Delete / Backspace – Remove Stock
  • Enter – Pin / Unpin Stock
  • j / k (or ↑ / ↓) – Navigate List
  • Shift + j / k (or Shift + ↑ / ↓) – Move Stock Position
  • 1 - 5 – Sort by Name / Code / Price / Change / Percent

Data Source

Real-time A-share market data is fetched from the Tencent Finance API.

Displayed Fields

  • Name – Stock name
  • Last – Latest price
  • Change – Price change (points)
  • Change % – Percentage change

API Field Mapping

Tencent stock API response data mapping:

  • parts[3] – Current price
  • parts[4] – Previous close price
  • parts[31] – Price change
  • parts[32] – Change percentage

Dependencies

  • curl – Fetch stock data
  • iconv – Convert GBK to UTF-8

Author

leemeng0x61@gmail.com

Changelog

v1.2.3 (2026-04-03)

  • βœ… Bar Configuration Simplification: Removed explicit barThickness and config bindings, using default Quickshell behavior for cleaner code.

v1.2.2 (2026-02-10)

  • βœ… Price Alert Threshold: Set custom alert threshold for each stock to receive system notifications.
  • βœ… Alert Settings: Double-click stock item to open alert settings dialog (enable switch + threshold).
  • βœ… Configure on Add: Set alert settings when adding new stocks.
  • βœ… System Notifications: Using notify-send with custom icon support.
  • βœ… Multi-language Notifications: Notification content supports English/Chinese.
  • βœ… Smart Notifications: Each stock triggers notification only once per day to avoid spam.

v1.2.1 (2026-02-06)

  • βœ… Stock Detail Popup: Click on any stock to view detailed information.

v1.2.0 (2026-02-01)

  • βœ… Trend Charts: Added sparklines to visualize price history in the list view.
  • βœ… Advanced Customization: Support for custom trend colors (Up/Down), status bar scrolling, and configurable refresh intervals.
  • βœ… Display Modes: Toggle between Percent/Amount and various Name formats (Pinyin/Hanzi).
  • βœ… Improved Interaction: Swipe gestures to Pin/Delete stocks.
  • βœ… Keyboard Shortcuts: Comprehensive keyboard control for navigation, sorting, and editing.
  • βœ… Enhanced Add Dialog: Search by stock code, name, or pinyin.

v1.1.0 (2026-01-30)

  • βœ… Code refactoring with modular architecture
  • βœ… Separated data management and UI components
  • βœ… Unified utility function library
  • βœ… Performance optimizations, reduced unnecessary re-renders
  • βœ… Improved code maintainability

v1.0.0 (2026-01-14)

  • βœ… Real-time quote display
  • βœ… Gain/loss color highlighting
  • βœ… DankBar integration to show Shanghai Composite Index
  • βœ… Auto refresh mechanism
  • βœ… JSON-based configuration support

License

MIT License - See LICENSE file for details