Stonks

Desktop stock tracker for Linux and MacOS.

Install

Download the latest release from the Releases page.

macOS

Download stonks-macos.dmg, open it, and drag Stonks to your Applications folder.

Linux (AppImage)

Download stonks-x86_64.AppImage, make it executable, and run it:

chmod +x stonks-x86_64.AppImage
./stonks-x86_64.AppImage

Linux (Snap)

Download the .snap file and install it locally:

sudo snap install --dangerous stonks_*.snap

Features

• Watchlist management (add/remove/reorder tickers)
• Interactive price charts with time range selectors
• Key financial stats for each stock

Development

Requires Python 3.12+ and uv.

uv sync --all-extras
uv run stonks

Testing

uv run pytest
uv run ruff check .

Releasing

./release.sh X.Y.Z
git push && git push --tags

The script updates the version in pyproject.toml, commits, and creates a v0.2.0 tag. Pushing the tag triggers the release workflow which builds and uploads macOS (DMG), Linux (AppImage), and Snap packages.

License

GPL-3.0