Stop Checking Browser Tabs! Track Stocks in Your Terminal with ticker

Stop Checking Browser Tabs! Track Stocks in Your Terminal with ticker

Every developer knows the pain. You're deep in flow state, terminal glowing green, Vim open, debugging a nasty race condition—when suddenly, your portfolio nosedives. Your fingers instinctively hit Alt+Tab. Browser explodes with fifty tabs. Yahoo Finance loads like it's 1999. By the time you find the right chart, your focus is shattered, your context destroyed, and that elegant solution you were about to architect? Gone forever.

Here's the dirty secret Wall Street doesn't want you to know: professional traders live in the terminal. Bloomberg Terminal commands $24,000 per year. But what if you could get 80% of that power—for free, without leaving your development environment?

Enter ticker, the open-source terminal stock and crypto tracker that's quietly becoming the weapon of choice for developers who refuse to compromise their workflow. Built by Ani Channarasappa and powered by Go's blistering performance, ticker transforms your terminal into a real-time financial command center. No Electron bloat. No browser memory leaks. Just pure, unadulterated market data where you already live.

In this deep dive, I'll expose why thousands of developers are abandoning browser-based trackers, how to wield ticker's most powerful features, and the exact configuration tricks that separate amateurs from terminal trading ninjas. By the end, you'll wonder why you ever tolerated another browser tab for market data.

What is ticker?

ticker is a terminal-based application written in Go that delivers live stock quotes, cryptocurrency prices, and portfolio position tracking directly in your command line interface. Created by developer Ani Channarasappa, it leverages the elegant Bubble Tea TUI framework to create a responsive, visually rich interface that feels surprisingly modern for a terminal application.

The project has gained significant traction in the developer community for one simple reason: it respects the Unix philosophy. Do one thing well. Don't steal your attention. Don't consume 500MB of RAM for a simple price quote. Ticker pulls data from Yahoo Finance (default) and Coinbase, supports pre-market and post-market quotes, and handles complex portfolio scenarios like multiple cost basis lots—all while using fewer resources than a single Chrome background process.

What makes ticker particularly compelling in 2024 is the convergence of two trends: the resurgence of terminal-based workflows among developers (driven by tools like Neovim, tmux, and modern CLI frameworks), and the democratization of retail investing. Developers who manage their own portfolios want market data integrated into their existing environments, not siloed in yet another SaaS dashboard with monthly subscriptions.

The project is actively maintained with robust CI/CD, comprehensive test coverage, and a growing ecosystem of third-party integrations. It's not a toy project—it's production-grade tooling that happens to be completely free and open source.

Key Features That Separate ticker from the Pack

Real-Time Market Data Without the Bloat

Ticker streams live quotes with configurable refresh intervals (default: 5 seconds). Unlike browser-based alternatives that ship entire Chromium instances, ticker uses lightweight WebSocket connections for Coinbase data and efficient polling for Yahoo Finance. The result? Sub-second updates on crypto, minimal latency on equities, and RAM usage measured in megabytes, not gigabytes.

Sophisticated Position Tracking

Most terminal trackers show prices. Ticker shows your performance. Define cost basis lots with quantity, unit cost, and even fixed fees (hello, commission-free brokers that aren't actually free). Multiple lots per symbol? No problem—ticker handles FIFO-style calculations and displays consolidated or detailed views. Negative quantities? Supported natively for short positions, borrowed assets, and closed position netting.

Multi-Asset Class Mastery

Stocks. Crypto. Derivatives. Futures contracts. Ticker speaks multiple data source dialects: Yahoo Finance for traditional equities, Coinbase for spot crypto and derivatives, with shorthand symbols (.X suffix) for popular cryptocurrencies. Track AAPL alongside BTC-USD and BIT-30MAY25-CDE.CB in a unified interface.

Dynamic Group Management

Organize watchlists and positions into contextual groups. Press TAB to cycle through your "tech stocks," "crypto degen plays," and "retirement boring stuff" configurations. Each group maintains independent watchlists and lot configurations—perfect for separating trading strategies from long-term holds.

Currency Conversion Engine

International investor? Ticker converts to any ISO 4217 currency code automatically. Cost basis in USD but you think in EUR? Done. Want summary in JPY but individual quotes in native exchange currencies? The currency-summary-only flag has you covered. Even handles historical rate lock-in for accurate P&L calculation.

Terminal-Native Aesthetics

TrueColor support, custom hex color schemes, separator lines using Unicode box-drawing characters, and responsive layouts that adapt to your terminal size. This isn't your grandfather's watch command—it's financial data presented with modern UI sensibilities.

Use Cases: Where ticker Absolutely Dominates

The Flow-State Developer

You're writing complex distributed systems code. Context switching costs you 23 minutes per interruption (science-backed, look it up). Browser tabs are focus poison. Ticker runs in a tmux pane, peripherally visible, updating silently. Market crashes? You notice in your peripheral vision without losing cognitive flow. Check details on your next natural break—not when some push notification demands your soul.

The Remote Work Nomad

Café WiFi in Lisbon. Tethered connection in Bali. Every megabyte counts. Browser-based trackers load 3MB of JavaScript^{↗ Bright Coding Blog} frameworks before showing a single price. Ticker? A 15MB static binary. Updates are kilobytes of JSON. Your bandwidth bill—and your laptop battery—thank you.

The Multi-Strategy Trader**

You run momentum trades in tech stocks, yield farming in DeFi, and conservative DCA into index funds. Three browser tabs minimum, usually more. Ticker's groups feature lets you define ~/.ticker.yaml with separate configurations for each strategy. TAB to context-switch instantly. No login/logout dance across brokerage websites.

The Infrastructure Engineer**

You're SSH'd into production servers at 3 AM during an incident. Markets open in Asia. Your hedging positions need monitoring but you can't run a browser on a hardened server. Ticker installs via single binary, runs headless-friendly, and outputs JSON/CSV via ticker print for integration with your monitoring stack. Pipe it to jq. Cron it. Alert on it. The terminal is your oyster.

Step-by-Step Installation & Setup Guide

macOS (Homebrew - Recommended)

# Add the custom tap and install in one command
brew install achannarasappa/tap/ticker

# Verify installation
ticker --version

Homebrew handles updates automatically with brew upgrade. The tap ensures you get official releases immediately.

Linux (Binary Install)

# Fetch latest release, extract, and install to /usr/local/bin
curl -Ls https://api.github.com/repos/achannarasappa/ticker/releases/latest \
| grep -wo "https.*linux-amd64*.tar.gz" \
| wget -qi - \
&& tar -xvf ticker*.tar.gz ticker \
&& chmod +x ./ticker \
&& sudo mv ticker /usr/local/bin/

# Verify
ticker --version

For ARM systems (Raspberry Pi, Apple Silicon VMs), replace linux-amd64 with linux-arm64 in the grep pattern.

Windows (winget)

# Modern Windows package manager
winget install -e --id achannarasappa.ticker

# Restart terminal, then verify
ticker --version

Docker^{↗ Bright Coding Blog} (Isolated/Sandboxed)

# Run with default configuration
docker run -it --rm achannarasappa/ticker

# With persistent config from host
docker run -it --rm -v ~/.ticker.yaml:/.ticker.yaml achannarasappa/ticker

Docker is ideal for CI/CD pipelines or restricted environments where you can't install binaries directly.

Snap (Ubuntu/Debian)

sudo snap install ticker
sudo snap connect ticker:ticker-config

# Config path workaround for Snap sandboxing
ticker --config $HOME/ticker.yaml

Initial Configuration Setup

Create your configuration file:

# Preferred location (XDG compliant)
mkdir -p ~/.config && touch ~/.config/.ticker.yaml

# Or traditional home directory
touch ~/.ticker.yaml

REAL Code Examples from the Repository

Example 1: Quick Start Watchlist

The simplest possible invocation—perfect for verifying your installation and getting immediate value:

# Watch Cloudflare, Apple, and Tesla with 5-second refresh
ticker -w NET,AAPL,TSLA

This command demonstrates ticker's core philosophy: zero configuration required. The -w (or --watchlist) flag accepts comma-separated symbols. No YAML files, no API keys, no accounts. Yahoo Finance data flows immediately. The default 5-second interval balances freshness with rate limit respect. Press q to quit, TAB to cycle groups (none defined here, so this is a no-op).

Example 2: Comprehensive Configuration File

Here's the annotated production-ready configuration from the official repository, explained line-by-line:

# ~/.ticker.yaml
# Global display preferences - enable ALL information panels
show-summary: true        # Show portfolio totals: day change, total value, total value change
show-tags: true           # Display currency, exchange name, and quote delay for transparency
show-fundamentals: true   # Show open price, previous close, and day range for context
show-separator: true      # Visual separation between quotes (requires Unicode font support)
show-positions: true      # CRITICAL: enables position tracking with weight, avg cost, quantity

# Behavior tuning
interval: 5               # Refresh every 5 seconds (lower = more real-time, higher = less API load)
currency: USD             # Convert all values to USD (omit for native exchange currencies)
currency-summary-only: false  # If true, only summary converts; individual quotes stay native

# Core watchlist - symbols tracked even without positions
watchlist:
  - NET                   # Cloudflare - tech infrastructure play
  - TEAM                  # Atlassian - developer tools exposure
  - ESTC                  # Elastic - search and observability
  - BTC-USD               # Bitcoin spot price via Yahoo Finance
  - SOL.X                 # Solana shorthand via ticker's curated crypto symbols
  - BIT-30MAY25-CDE.CB    # Bitcoin futures contract via Coinbase (note .CB suffix)

# Position lots - the secret sauce for real P&L tracking
lots:
  # Single lot example: 35 shares of Airbnb at $146 average
  - symbol: "ABNB"
    quantity: 35.0
    unit_cost: 146.00
  
  # Multiple lots for same symbol: dollar-cost averaging visualization
  - symbol: "ARKW"
    quantity: 20.0
    unit_cost: 152.25
  - symbol: "ARKW"
    quantity: 20.0
    unit_cost: 145.35
    fixed_cost: 7.00       # Brokerage commission - included in true cost basis calc

# Organized groups for strategy separation
groups:
  - name: crypto
    watchlist:
      - SHIB-USD           # Meme coin exposure (separate from serious portfolio)
      - VGX-USD            # Voyager token
    lots:
      - symbol: SOL1-USD   # Note: different symbol format for this lot
        quantity: 17
        unit_cost: 159.10

Key insights from this configuration:

The ARKW dual-lot entry demonstrates ticker's sophisticated cost basis engine. Rather than averaging manually (incorrect for tax purposes in many jurisdictions), ticker tracks each lot separately. The fixed_cost: 7.00 entry reveals attention to real-world investing: commissions matter for accurate returns, especially on smaller positions.

The SOL.X versus SOL1-USD distinction shows data source flexibility. .X suffix uses ticker's curated shorthand mapping to CoinGecko/Coinbase data. The groups feature enables TAB cycling between your "serious" tech stock portfolio and your "speculative" crypto group—mental separation that prevents emotional decision-making.

Example 3: Programmatic Position Export

Ticker's hidden superpower for automation and integration:

# Export all positions as JSON for further processing
$ ticker --config=./.ticker.yaml print
[{"name":"Airbnb, Inc.","symbol":"ABNB","price":164.71,"value":16965.13,"cost":15038,"quantity":103,"weight":53.66651978212161},{"name":"Tesla, Inc.","symbol":"TSLA","price":732.35,"value":14647,"cost":15660,"quantity":20,"weight":46.33348021787839}]

# Or formatted for spreadsheet warriors
$ ticker --config=./.ticker.yaml print --format=csv
name,symbol,price,value,cost,quantity,weight
"Airbnb, Inc.",ABNB,164.71,16965.13,15038,103,53.67
"Tesla, Inc.",TSLA,732.35,14647,15660,20,46.33

This transforms ticker from a visual tool into a data source. Pipe to jq for filtering, curl to POST to your own API, or schedule via cron for historical tracking. The JSON structure is stable and documented: price (current quote), value (quantity × price), cost (total basis including fixed costs), weight (percentage of total portfolio).

Example 4: Custom Color Scheme

For terminal aesthetes who match their tools to their themes:

# ~/.ticker.yaml - Solarized Dark inspired
colors:
  text: "#005fff"        # Primary quote text - vibrant blue
  text-light: "#0087ff"  # Secondary information - lighter blue
  text-label: "#00d7ff"  # Column headers and labels - cyan accent
  text-line: "#00ffff"   # Separator lines - bright cyan
  text-tag: "#005fff"    # Exchange/currency tags - matching primary
  background-tag: "#0087ff"  # Tag backgrounds - subtle highlight

TrueColor terminals render these exactly; others downsample gracefully. Any omitted or invalid colors fall back to defaults, so experimentation is safe.

Advanced Usage & Best Practices

Optimize Your Refresh Strategy

The default 5-second interval is aggressive for stable holdings and sluggish for active trades. Use -i 1 for scalp-trading sessions, -i 60 for long-term portfolio monitoring. Consider running multiple ticker instances: one fast for active positions, one slow for passive holdings, in separate tmux panes.

Master the Sort Modes

--sort alpha for earnings season when you scan alphabetically. --sort value for rebalancing decisions. --sort user for priority-based attention (your largest positions first). The default (change percent) surfaces volatility—useful for finding action, dangerous for emotional trading.

Leverage Negative Quantities

Short sellers and complex strategists: negative quantities in lots represent short positions or closed lot netting. This enables true portfolio-wide P&L including hedges. Track your long AAPL against short QQQ hedge in one view.

Currency Arbitrage Awareness

The currency-disable-unit-cost-conversion flag solves a subtle problem: if you bought EUR-denominated assets when EUR/USD was 1.05, but ticker converts at current 1.08, your "profit" includes currency fluctuation. Lock in historical rates by setting cost in your local currency and disabling conversion.

Font Compatibility Check

If separators render as boxes, your terminal font lacks U+23AF (HORIZONTAL LINE EXTENSION). Test with: echo -e '\u23af'. Switch to Nerd Fonts, JetBrains Mono, or any font with Unicode block drawing support.

Comparison with Alternatives

Verdict: Choose tickrs if you need candlestick charts and options Greeks in terminal. Choose cointop for crypto-only with exchange-specific depth. Choose ticker for the optimal balance of asset coverage, position intelligence, and workflow integration—especially if you trade both equities and crypto.

FAQ

Q: Does ticker require API keys or paid subscriptions?

No. Ticker uses free data tiers from Yahoo Finance and Coinbase. No registration, no API keys, no rate limit anxiety for personal use. For heavy institutional use, consider data licensing directly from exchanges.

Q: How delayed is the market data?

Yahoo Finance data typically has <30 second lag due to exchange-imposed delays and polling architecture. NASDAQ/NYSE real-time data is available through Yahoo's premium tiers (not ticker-controlled). Coinbase spot data streams via WebSocket with near-zero latency. Use --show-tags to see delay indicators per quote.

Q: Can I track international stocks and forex?

Yes, but symbol discovery requires effort. Search Yahoo Finance using native names to find correct symbols. Forex pairs use Yahoo's format (e.g., EURUSD=X). ETFs and non-US equities are fully supported once you identify the proper ticker symbol.

Q: Is my portfolio data secure?

Completely. All data stays local in your ~/.ticker.yaml. No cloud sync, no account creation, no telemetry. The application makes outbound data requests only for price quotes. For paranoid environments, audit the open-source code or run in network-restricted Docker containers.

Q: How do I update ticker?

Homebrew: brew upgrade ticker. Linux binary: re-run the curl installation script. Docker: docker pull achannarasappa/ticker. Windows: winget upgrade achannarasappa.ticker. The binary is self-contained with no dependency hell.

Q: Can I contribute or request features?

The project welcomes contributions on GitHub. Issues are actively triaged. The Go codebase is clean and well-tested—dive in if you want to add data sources or features.

Q: What happens if a data source goes down?

Ticker gracefully degrades. Quotes from affected sources show last known price with stale indicators. The application doesn't crash or hang—design resilience for a tool that runs for hours unattended.

Conclusion

The modern developer's workspace is a carefully orchestrated environment: Neovim for code, tmux for multiplexing, zsh for shell, and a constellation of CLI tools that respect your attention. Adding a browser tab for stock prices isn't just inefficient—it's a betrayal of that philosophy.

ticker solves this with surgical precision. It delivers institutional-grade market monitoring without institutional bloat. Multiple cost basis lots, multi-asset coverage, currency conversion, and programmable output—wrapped in a terminal-native interface that starts in milliseconds and sips resources.

I've run ticker through market crashes, IPO frenzies, and boring accumulation phases. It never crashed, never leaked memory, never demanded my focus when I was debugging production. It just worked, reliably, in the periphery of my terminal where financial awareness belongs.

Your move. Install it now—brew install achannarasappa/tap/ticker or your platform equivalent. Configure your first watchlist. Feel the satisfaction of Alt+Tab liberation. Then star the repository, because tools this polished deserve recognition, and because Ani Channarasappa is building the future of developer-centric financial tooling—one terminal frame at a time.

→ Get ticker on GitHub

Last updated: 2024 | ticker version: check ticker --version for latest