A comprehensive desktop panel applet that monitors stock prices with both text and graphical display modes. Features real-time price tracking, historical charts, and customizable display options. Available for both MATE and Cinnamon desktop environments.
- Almost Real-time Stock Monitoring: Live stock price updates with configurable intervals (Check https://finnhub.io for available limits!!!)
- Dual Display Modes: Switch between text display and graphical charts in panel
- Historical Charts: Mini-charts and detailed chart windows with price history
- Comprehensive Tooltips: Shows current price, daily range, and historical extremes with timestamps
- Customizable Colors: Line and fill colors for charts with color picker interface
- Optional Symbol Display: Show stock symbol on charts (configurable)
- Dynamic Panel Sizing: Charts automatically adapt to panel height
- Persistent Data: Price history stored locally for trend analysis
- Lightweight: Minimal resource usage with efficient data management
- MATE Desktop Environment
- Python 3
- PyGObject (python3-gi)
- Internet connection for stock data
- Cinnamon Desktop Environment
- curl command installed (
apt install curl) - Internet connection for stock data
- Finnhub API token (free at https://finnhub.io)
-
Install dependencies:
sudo apt install python3-gi mate-panel-dev
-
Run the install script:
chmod +x install.sh ./install.sh
-
Restart MATE panel:
mate-panel --replace & -
Add to panel:
- Right-click on MATE panel
- Select "Add to Panel..."
- Find "Stock Applet" and add it
-
Copy applet to user directory:
mkdir -p ~/.local/share/cinnamon/applets/ cp -r cinnamon/stock-applet@cinnamon ~/.local/share/cinnamon/applets/
-
Restart Cinnamon:
# Press Alt+F2, type 'r', press Enter # OR cinnamon --replace &
-
Add to panel:
- Right-click on Cinnamon panel
- Select "Applets"
- Find "Stock Applet" and click '+'
- Get a free API token from https://finnhub.io
- Open applet preferences
- Enter your API token in the "API Token" field
- Configure your preferred stock symbol (e.g., NVDA, AAPL, TSLA)
MATE Version: Right-click the applet and select "Preferences"
Cinnamon Version: Right-click the applet and select "Configure..." or use Cinnamon Settings > Applets
The applet shows stock information (current price, today's high and low) as text: NVDA: $875.50 [860.25..890.75]
Switch to chart mode for mini real-time graphs in the panel showing price trends.
Hover over the applet for comprehensive information:
- Current stock symbol and price
- Today's trading range (high/low)
- Chart period extremes with timestamps
- Historical data from displayed timeframe
- Price history stored in
~/.local/share/cinnamon/applets/stock-applet@cinnamon/price_history.txt(Cinnamon) - Settings stored in
~/.config/stock-applet.json(MATE) - Keeps last 144 data points (24 hours at 10-minute intervals)
To test without installing:
python3 stock_applet.pyTo test during development:
-
Copy to development location:
mkdir -p ~/.local/share/cinnamon/applets/stock-applet@cinnamon cp cinnamon/stock-applet@cinnamon/* ~/.local/share/cinnamon/applets/stock-applet@cinnamon/
-
Restart Cinnamon and add through Applets menu
stock_applet.py- Main applet codeorg.mate.panel.StockApplet.mate-panel-applet- MATE applet configurationorg.mate.panel.applet.StockAppletFactory.service- D-Bus service filestock-applet.desktop- Desktop entryinstall.sh- Installation script
cinnamon/stock-applet@cinnamon/applet.js- Main applet codecinnamon/stock-applet@cinnamon/metadata.json- Applet metadatacinnamon/stock-applet@cinnamon/settings-schema.json- Settings configuration
- Verify API token is correctly entered
- Check internet connection
- Ensure stock symbol is valid (use common symbols like AAPL, NVDA)
- Check applet logs for error messages
- Ensure "Show Charts in Panel" is enabled in preferences
- Check that panel has sufficient height for chart display
- Verify chart width settings are appropriate
Apache-2.0 License
(C) Sergey Zhumatiy sergzhum@gmail.com 2025