coinmon

coinmon [OPTION...]

-h, --help
    Show help information and exit.


-v, --version
    Display coinmon version and exit.


-c, --config DIR
    Set config directory (default: ~/.config/coinmon/).


-p, --prices
    Show prices table only, skip portfolio.


-f, --favorites-only
    Display favorite coins only.


-C, --no-colors
    Disable colored output.


--debug
    Enable debug logging.

coinmon is a lightweight, curses-based (ncurses) tool for monitoring cryptocurrency prices and portfolio values directly in the Linux terminal. It fetches real-time data from the free CoinGecko API, displaying prices, market caps, 24h changes, and custom portfolios without requiring API keys.

Key features include:
• Live updates every few seconds.
• Portfolio tracking with holdings in BTC, USD, or EUR.
• Favorites list for quick access to preferred coins.
• Color-coded changes (green for gains, red for losses).
• Prices-only mode for minimal view.

Users configure it via JSON files in ~/.config/coinmon/, defining portfolios like holdings in coins with amounts. Ideal for headless servers or minimal setups, it runs efficiently with low resource usage. Supports hundreds of coins; search and sort interactively with keyboard navigation.

Perfect for traders wanting distraction-free monitoring without browsers or heavy GUIs.

Requires internet connection for API fetches. Config files must be valid JSON. High coin counts may slow updates. No historical charts or alerts.

Via Go: go install github.com/vindarel/coinmon@latest.
Or binaries from GitHub releases. macOS: brew install coinmon.
Arch: AUR package available.

Edit ~/.config/coinmon/portfolio.json for holdings, e.g.:
{"coins": [{"id": "bitcoin", "amount": 0.5}, ...]}
favorites.json for quick list.

In UI: q quit, ? help, f toggle favorites, s search/sort, r refresh.

Developed by Guillaume V (@vindarel) starting 2018. Open-source on GitHub (vindarel/coinmon). Initial release v1.0 in 2019; now at v1.3+ with CoinGecko integration replacing older APIs. Actively maintained for Linux/BSD/macOS.

htop(1), glances(1), ncdu(1)