enlunder/pixelart-tracker
1
0
Fork 1
Code Issues Pull requests Activity
Show YouTube subscribers and Crypto-currency tracking on a iDotMatrix 32x32 pixels screen. This fork also allows for showing incoming messages via HTTP requests thanks to a FastAPI endpoint.
28 commits 1 branch 0 tags 99 KiB
  • Python 100%
Find a file
Martin Enlund 350631fc91 Added note on compiling Pillow from scratch + note about LNbits.
2025-05-06 12:30:08 +02:00
src Added an endpoint for LNbits Pay Links webhooks. 2025-05-06 12:27:36 +02:00
.gitignore Refactored structure to be able to publish the package. 2024-05-24 22:30:30 +02:00
LICENSE Refactored structure to be able to publish the package. 2024-05-24 22:30:30 +02:00
pyproject.toml Fix: Increase pyproject version 2024-09-02 19:17:13 +02:00
README.md Added note on compiling Pillow from scratch + note about LNbits. 2025-05-06 12:30:08 +02:00
requirements.txt Small fix for finance time data on weekends. New file for requirements. 2025-04-22 16:07:45 +02:00

README.md

iDotMatrix YouTube Subscriber Counter

This project uses Python to display the number of subscribers of a YouTube channel on a 32px by 32px iDotMatrix-style pixel art screen.

Dependencies:

  • Python 3.x
  • asyncio
  • aiohttp
  • PIL (Pillow) 10.x
  • idotmatrix 0.0.4 this fork
  • PyDantic 1.10.x
  • uvicorn
  • fastapi

Installation:

  1. Install the python package:
pip install pixelart-tracker

1.1 Or run it without installing (add the same arguments as under Usage below):

python -c "from src.pixeltracker.app import main;main()"

1.2 If you need to compile Pillow from scratch, as on my Raspberry Pi Zero, make sure to you have the following packages installed with e.g. apt:

apt install libfreetype6-dev libjpeg-dev zlib1g-dev

  1. Get your Youtube API KEY: Request an API KEY going here https://console.cloud.google.com/apis/api/youtube.googleapis.com/credentials

  2. Set env variables:

export SUBS_YOUTUBE_CHANNEL_ID=YOUR_YOUTUBE_CHANNEL_ID
export SUBS_YOUTUBE_API_KEY=YOUR_YOUTUBE_API_KEY

Usage:

  1. Scan for compatible devices:
pix-track --scan
  1. Run on device:
pix-track --address <device_mac_address>/auto

Where <device_mac_address> is the device physical address or auto is to autodiscover devices and use the first one found.

Example:

pix-track --address 37:D4:98:8F:2B:C8
  1. This version includes a web server available listening at all interfaces at port 9191

Try visiting http://localhost:9191/docs/ in your browser.

This web server enables use as an endpoint for LNbits Pay Links.

Code Explanation:

  • The script uses the aiohttp library to get the YouTube channel information.
  • The channel information is parsed into a dictionary.
  • The subscriber count is extracted from the dictionary.
  • The subscriber count is converted to a pixel readable string.
  • The string is converted to a character array.
  • The character array is used to create a pixel art image.
  • The pixel art image is displayed on the screen.

Technical Details:

  • The iDotMatrix display is simulated using the PIL (Pillow) library.
  • The total screen size is 32px by 32px pixels.
  • The pixels are colored always white for the characters.
  • The pixel art image is scaled to fit the screen.

License:

This project is licensed under the MIT license.

Contributions:

Contributions to this project are welcome. Create an issue or pull request on GitHub to get started.