{"id":30874789,"url":"https://github.com/mxplesticks/snpi-stock-ticker","last_synced_at":"2026-05-16T11:34:39.989Z","repository":{"id":275475662,"uuid":"926188373","full_name":"MxpleSticks/snPi-Stock-Ticker","owner":"MxpleSticks","description":"A simple and modern Python script that displays real-time stock market data on a Raspberry Pi screen. (via finnhub api) :)","archived":false,"fork":false,"pushed_at":"2025-12-20T17:42:02.000Z","size":32,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-01T09:54:17.595Z","etag":null,"topics":["python","raspberry-pi","stock-market","ticker"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MxpleSticks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-02T18:56:32.000Z","updated_at":"2025-12-21T17:00:32.000Z","dependencies_parsed_at":"2025-11-20T18:00:24.685Z","dependency_job_id":null,"html_url":"https://github.com/MxpleSticks/snPi-Stock-Ticker","commit_stats":null,"previous_names":["mxplesticks/s-pi-stock-ticker","mxplesticks/snpi-stock-ticker","mxplesticks/sppi-stock-ticker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MxpleSticks/snPi-Stock-Ticker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MxpleSticks%2FsnPi-Stock-Ticker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MxpleSticks%2FsnPi-Stock-Ticker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MxpleSticks%2FsnPi-Stock-Ticker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MxpleSticks%2FsnPi-Stock-Ticker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MxpleSticks","download_url":"https://codeload.github.com/MxpleSticks/snPi-Stock-Ticker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MxpleSticks%2FsnPi-Stock-Ticker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33100925,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","raspberry-pi","stock-market","ticker"],"created_at":"2025-09-08T01:33:21.879Z","updated_at":"2026-05-16T11:34:39.983Z","avatar_url":"https://github.com/MxpleSticks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# snPi Stock Ticker\n\nA real-time stock monitoring application designed for tracking the S\u0026P 500 ETF (VOO). Built with Tkinter and Matplotlib, utilizing the Finnhub API for live market data. The application provides live stock prices, percentage changes, market status indicators, and historical price visualizations.\n\n**Note:** The application is currently hardcoded to track VOO, but the ticker symbol can be easily modified in the source code to monitor other stocks.\n\n---\n\n## Features\n\n- Real-time stock data with 3-second update intervals\n- Dynamic price history graphs with color-coded trend indicators\n- Animated price and percentage change displays\n- Market status monitoring (Open/Closed)\n- Modern dark-themed user interface\n\n---\n\n## System Requirements\n\n- Python 3.7 or higher\n- Compatible with Raspberry Pi and Windows systems\n\n---\n\n## Installation\n\n### Virtual Environment Setup\n\nUsing a virtual environment is strongly recommended to maintain isolated dependencies. For detailed information on Python virtual environments, refer to the [Real Python Virtual Environments Guide](https://realpython.com/python-virtual-environments-a-primer/).\n\n#### Raspberry Pi / Linux\n\n```bash\nsudo apt update\nsudo apt install python3-venv python3-pip -y\npython3 -m venv stock-env\nsource stock-env/bin/activate\n```\n\n#### Windows\n\n```bash\npython -m venv stock-env\nstock-env\\Scripts\\activate\n```\n\n---\n\n### Dependency Installation\n\nWith your virtual environment activated, install the required packages:\n\n#### Core Dependencies (All Platforms)\n\n```bash\npip install matplotlib finnhub-python\n```\n\nNote: Tkinter is included with most Python installations. If needed, install separately using your system's package manager.\n\n#### Platform-Specific Dependencies\n\n**Raspberry Pi Additional Requirements:**\n\nFor Tkinter support:\n```bash\nsudo apt-get install python3-tk\n```\n\nFor Matplotlib dependencies:\n```bash\nsudo apt install libatlas3-base libatlas-base-dev\n```\n\n---\n\n## Usage\n\n1. Clone or download the project repository\n2. Activate your virtual environment\n3. Execute the application:\n   ```bash\n   python stock_tracker.py\n   ```\n\nThe application window will display live updates for VOO (Vanguard S\u0026P 500 ETF).\n\n### Changing the Tracked Stock\n\nTo monitor a different stock, locate and modify the ticker symbol in the source code:\n```python\nself.symbol = \"VOO\"  # Change to your desired ticker symbol\n```\n\n---\n\n## API Configuration\n\n### Obtaining a Finnhub API Key\n\n1. Register for a free account at [https://finnhub.io/](https://finnhub.io/)\n2. Retrieve your API key from the dashboard\n3. Update the API key in the script:\n   ```python\n   self.finnhub_client = finnhub.Client(\"YOUR_API_KEY_HERE\")\n   ```\n\n---\n\n## Troubleshooting\n\n### Matplotlib Installation Issues\n\nIf you encounter errors related to Matplotlib on Raspberry Pi:\n```bash\nsudo apt-get install libatlas-base-dev\nsudo apt install libatlas3-base\n```\n\n### Performance Optimization\n\nFor systems with limited resources (such as Raspberry Pi), consider reducing the update frequency by modifying the refresh interval:\n```python\nself.root.after(5000, self.update_data)  # Changed from 3000ms to 5000ms\n```\n\n### Time Zone Considerations\n\nThe application uses Eastern Standard Time (EST) for market status calculations. Adjust the timezone logic if operating in a different region.\n\n---\n\n## Hardware Components\n\nThe following components are recommended for a complete Raspberry Pi-based deployment:\n\n1. **[Mini Aluminum Heat Sink (Adafruit #3084)](https://www.adafruit.com/product/3084)**  \n   Provides thermal management for improved Raspberry Pi performance\n\n2. **[90-Degree Ribbon Micro USB Cable](https://www.amazon.com/dp/B077M5NW1M)**  \n   Space-saving flexible USB cable with right-angle connector\n\n3. **[Raspberry Pi Protective Case (Adafruit #2258)](https://www.adafruit.com/product/2258)**  \n   Durable enclosure for secure Raspberry Pi housing\n\n4. **[3.5\" TFT LCD Touch Screen Display](https://www.microcenter.com/product/632693/35_Inch_TFT_LCD_Touch_Screen_Monitor)**  \n   Compact touchscreen monitor ideal for embedded monitoring applications\n\n---\n\n## License\n\nThis project is released as open-source software. Users are free to modify and distribute the code according to their needs.\n\n---\n\n## Contributing\n\nContributions, bug reports, and feature requests are welcome. Please submit issues or pull requests through the project repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmxplesticks%2Fsnpi-stock-ticker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmxplesticks%2Fsnpi-stock-ticker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmxplesticks%2Fsnpi-stock-ticker/lists"}