xbar-plugin-yf-stock-ticker

A (yet another) xbar plugin that display stock quotes, global indices, currencies and cryptocurrencies. It does not require any account creation or API key. Data collection is made reliable thanks to yahooquery package.

The plugin accepts all the symbols supported by Yahoo! Finance.

Features

• Market changes (%) will cycle in the navigation bar
• Market prices details will appear in the dropdown menu (symbols may be different from those in the navigation bar)
• Any Yahoo! Finance ticker symbol is supported:
  • stock (ex. AAPL)
  • index (ex. ^IXIC)
  • FX rate (ex. EURUSD=X)
  • Cryptocurrency (ex. BTC-USD)
• Plugin automatic update (for ex. in case of YF breaking change, a plugin update will trigger the yahooquery package update)
• Configuration (symbols, auto-update) via plugin preferences panel

Manual installation

In a terminal:

cd ~/Library/Application\ Support/xbar/plugins
curl -o yf_stock_ticker.10m.sh https://raw.githubusercontent.com/gmasse/xbar-plugin-yf-stock-ticker/main/yf_stock_ticker/yf_stock_ticker.sh
chmod +x yf_stock_ticker.10m.sh

Configuration

Symbols to display can be configured in the xbar menu Plugin Browser...

Development

Prerequisites

• Python 3.x
• Make

Setting up the development environment

# Create venv and install dependencies
make venv

Available commands

make help    # Show all available commands
make venv    # Prepare development environment
make lint    # Run linting (shellcheck + pylint)
make test    # Run tests
make all     # Lint and test
make build   # Build release tarball
make clean   # Remove all development files

Manual testing

# Run the plugin with sample symbols
VAR_TICKER_SYMBOLS="AAPL BTC-USD" VAR_DROPDOWN_SYMBOLS="AAPL ^IXIC ETH-BTC" ./yf_stock_ticker/yf_stock_ticker.py

Example output:

▼ AAPL -0.18% | color=red
▼ BTC-USD -5.46% | color=red
---
AAPL        255.99     -0.18% 🔴 | font='Menlo'
--Apple Inc. (USD) | font='Menlo'
--Previous Close: 256.44 | font='Menlo'
--Open:           258.07 | font='Menlo'
--Day's Range:    254.41 - 259.65 | font='Menlo'
^IXIC     23370.76     -2.04% 🔴 | font='Menlo'
--NASDAQ Composite (USD) | font='Menlo'
--Previous Close: 23857.45 | font='Menlo'
--Open:           23830.92 | font='Menlo'
--Day's Range:    23232.78 - 23840.55 | font='Menlo'
ETH-BTC       0.03     -6.39% 🔴 | font='Menlo'
--Ethereum BTC (BTC) | font='Menlo'
--Previous Close: 0.03 | font='Menlo'
--Open:           0.03 | font='Menlo'
--Day's Range:    0.03 - 0.03 | font='Menlo'

Disclaimer

This project is not affiliated with Yahoo, Inc.

Thanks

This plugin is greatly inspired by Yahoo Stock Ticker and bitbar-plugin-pingdom.