Metadata-Version: 2.1
Name: tinyticker
Version: 0.4.1
Summary: A tiny Raspberry Pi powered ePaper ticker.
Home-page: https://github.com/loiccoyle/tinyticker
License: MIT
Keywords: raspberry-pi,ticker,stock,crypto,epaper
Author: Loic Coyle
Author-email: loic.coyle@hotmail.fr
Requires-Python: >=3.7.1,<3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: Flask (>=2.0.2,<3.0.0)
Requires-Dist: Pillow (>=9.0.0,<10.0.0)
Requires-Dist: RPi.GPIO (>=0.7.0,<0.8.0)
Requires-Dist: cryptocompare (>=0.7.5,<0.8.0)
Requires-Dist: matplotlib (>=3.5.1,<4.0.0)
Requires-Dist: mplfinance (>=0.12.7-alpha.17,<0.13.0)
Requires-Dist: packaging (>=23.0,<24.0)
Requires-Dist: pandas (>=1.3.5,<2.0.0)
Requires-Dist: qrcode (>=7.3.1,<8.0.0)
Requires-Dist: spidev (>=3.5,<4.0)
Requires-Dist: yfinance (>=0.2.0,<0.3.0)
Project-URL: Repository, https://github.com/loiccoyle/tinyticker
Description-Content-Type: text/markdown

<h1 align="center">🚀 tinyticker 🚀</h1>
<div align="center">
  <img  src="https://i.imgur.com/J4k3PCM.png" height=400>
  <img src="https://i.imgur.com/QWP7bpH.png" height=400>
</div>
<p align="center">
  <a href="https://pypi.org/project/tinyticker/"><img src="https://img.shields.io/pypi/v/tinyticker"></a>
  <a href="./LICENSE.md"><img src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
  <a href="https://github.com/loiccoyle/tinyticker/actions/workflows/ci.yml"><img src="https://github.com/loiccoyle/tinyticker/actions/workflows/ci.yml/badge.svg"></a>
</p>
<hr/>

`tinyticker` uses a Raspberry Pi zero W and a small ePaper display to periodically display a stock or crypto chart.

A `flask` web interface is created to set the ticker options and control the Raspberry Pi.

`tinyticker` uses the [`cryptocompare`](https://github.com/lagerfeuer/cryptocompare) API to query the crypto price information, you'll need to get yourself a free [API key](https://min-api.cryptocompare.com/pricing). As well as the [`yfinance`](https://github.com/ranaroussi/yfinance) package to get the stock financial data.

## 🛒 Hardware

Shopping list:

- [Raspberry Pi Zero WH](https://www.adafruit.com/product/3708)
- One of these ePaper displays:
  - [Waveshare ePaper 2.13in Black & White](https://www.waveshare.com/wiki/2.13inch_e-Paper_HAT)
  - [Waveshare ePaper 2.13in Black, White & Red](<https://www.waveshare.com/wiki/2.13inch_e-Paper_HAT_(B)>)
  - [Waveshare ePaper 2.13in Black, White & Yellow](<https://www.waveshare.com/wiki/2.13inch_e-Paper_HAT_(C)>)
- A micro sd card

## 📦 Installation

### Recommended setup

Flash the [tinyticker image](https://drive.google.com/drive/folders/1U-PGzkOtSynN6FGDq2MsXF9kXGdkzd0D) onto a SD card and you should be good to go.

### Manual setup

I highly recommend using [comitup](https://github.com/davesteele/comitup) to setup the networking on your RPi.

- Write the `comitup` [image](https://davesteele.github.io/comitup/latest/comitup-lite-img-latest.html) to your sd card
- Boot up the RPi and setup the networking
- ssh into your RPi, you'll probably want to change the password while you're at it
- Enable the [SPI interface](https://www.raspberrypi-spy.co.uk/2014/08/enabling-the-spi-interface-on-the-raspberry-pi/)
- (Optional) rename the hostname of your RPi by editing the `/etc/hostname` and `/etc/hosts` file
- (Optional) rename the Wifi AP name by editing the `/etc/comitup.conf` file
- Install the `BCM2835` driver:
  ```sh
  curl http://www.airspayce.com/mikem/bcm2835/bcm2835-1.60.tar.gz | tar xzv
  cd bcm2835-1.60/
  ./configure
  make
  make install
  ```
- Install `pip`:
  ```sh
  sudo apt install python3-pip
  ```
- Install dependency requirements:
  ```sh
  sudo apt install libatlas-base-dev libopenjp2-7 libtiff5 libxml2-dev libxslt1-dev
  ```
- Install `tinyticker` (the `CFLAGS` variable is required for `RPi.GPIO` to install):
  ```sh
  pip install tinyticker
  ```
- To setup `tinyticker` to start on boot, copy over the [`systemd` unit files](./systemd) and enable them.
- On boot, a qrcode linking to the `flask` app will be flashed on the display
- Leave a star, reboot and HODL !

Note: the Raspberry Pi zero isn't very fast so be patient :)

