Skip to content

TMS-Namespace/DMS-Markets-Plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Markets Plugin for DMS

A DankMaterialShell widget plugin that displays near-live market prices and charts directly in your desktop shell through configurable market data providers.

Dark Theme Light Theme

Features

  • Pin to bar — display live prices for selected symbols directly in DankBar.
  • Popup panel — list showing name, price, change percentage, and sparkline charts.
  • Manual symbol entry — open the selected provider in your browser, then add the provider symbol manually.
  • Per-symbol configuration — independent data provider, price interval, chart range, change display, and price inversion.
  • Custom colors — configurable up/down color indicators.
  • Reorder & edit — rearrange symbol order, click to edit, hover to pin or delete.
  • Adjustable popup height — set the number of visible rows.
  • Intelligent fetching — staggered data requests with retry logic to avoid rate limiting.
Settings (1) Settings (2)

Requirements

  • DMS ≥ 1.2.0
  • curl installed and available in $PATH
  • Internet access

Data Providers

Currently supported providers:

  • Yahoo Finance — The current default. No credentials required. Example symbols: EURUSD=X, BZ=F, HG=F, DX-Y.NYB, ^GSPC.

  • Stooq — Currently disabled, due to unstable API. Publishes CSV quotes for a wide range of instruments.

    Limitation: Some Stooq symbols (usually futures that has symbols of *.f format) shown on the website do not return CSV data through the public API. If a symbol stays empty in the widget, open Stooq in your browser and try the cash/index variant shown there (i.e. symbols of *.i or *.c format).

Privacy

Version History

  • v1.0.3 :
    • Stooq changed their API yet again, and broken data fetching.
    • Added Yahoo Finance provider as a, probably less privacy respecting, but working alternative for Stooq.
    • Disabled Stooq in till they stabilize their API.
    • If you previously configured Stooq symbols, delete them and re-add the same markets using another provider. Provider symbols can differ, so use the symbol search link in settings to find the correct Yahoo Finance symbol.
  • v1.0.2 :
    • Now Stooq requires API key to provide historic data, updated backend and widget settings to support API key.
    • In-settings search for symbols is removed due to unreliability, replaced with a button to open provider's symbols search web page.
  • v1.0.1 (Not published to DMS, due to changes from Stooq provider):
    • Fixed the issue with charts for previously working symbols, are not displayed (Unfortunately, Stooq now requires using cookies).
    • Added logging capability.
    • Refactoring.
  • v1.0.0 :
    • Initial version.

Install

Method 1

In DMS:

  1. Open Settings -> Plugins
  2. Click Scan for Plugins
  3. Enable GitHub Inbox
  4. Add widget to DankBar

Method 2

Or clone repo, and run (this will add Symlink to plugin folder):

chmod +x Support/setup-symlink.sh
Support/setup-symlink.sh

Disclaimers

  • The developer has no affiliation with any data provider.
  • This plugin was vibe-coded under my supervision as a software engineer.

About

A DankMaterialShell widget plugin that displays near-live market prices and charts.

Topics

Resources

License

Stars

Watchers

Forks

Contributors