{"id":13856691,"url":"https://github.com/dr-mod/zero-btc-screen","last_synced_at":"2025-05-16T03:05:35.468Z","repository":{"id":42530581,"uuid":"328012708","full_name":"dr-mod/zero-btc-screen","owner":"dr-mod","description":"Crypto stock price for RPi Zero","archived":false,"fork":false,"pushed_at":"2025-01-30T22:59:03.000Z","size":6235,"stargazers_count":336,"open_issues_count":11,"forks_count":74,"subscribers_count":26,"default_branch":"main","last_synced_at":"2025-04-19T04:34:03.804Z","etag":null,"topics":["bitcoin-stock-price","cryptocurrency","eink","raspberry-pi","stocks"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dr-mod.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2021-01-08T21:08:19.000Z","updated_at":"2025-03-24T23:01:41.000Z","dependencies_parsed_at":"2025-02-20T18:11:16.243Z","dependency_job_id":"4a35998c-4ec1-4e00-adc2-f8ef0a27e9e4","html_url":"https://github.com/dr-mod/zero-btc-screen","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dr-mod%2Fzero-btc-screen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dr-mod%2Fzero-btc-screen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dr-mod%2Fzero-btc-screen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dr-mod%2Fzero-btc-screen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dr-mod","download_url":"https://codeload.github.com/dr-mod/zero-btc-screen/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254459088,"owners_count":22074605,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bitcoin-stock-price","cryptocurrency","eink","raspberry-pi","stocks"],"created_at":"2024-08-05T03:01:09.109Z","updated_at":"2025-05-16T03:05:30.460Z","avatar_url":"https://github.com/dr-mod.png","language":"Python","funding_links":["https://www.buymeacoffee.com/drmod"],"categories":["Python"],"sub_categories":[],"readme":"# Zero BTC Screen\n\nBitcoin (or any other currency) stock price for your RPi Zero\n\n![display](docs/display.jpg)\n\n## Hardware\n\n### Platform\n\n* Raspberry Pi Zero W\n* Raspberry Pi 3b+\n* Raspberry Pi 4\n* Any other modern RPi\n\n### Supported displays\n\n* Waveshare eInk types:\n  * epd2in13v2\n  * epd2in13v3\n  * epd2in13bv3\n  * epd2in7\n  * epd3in7\n* inkyWhat (Red, Black, White)\n* Virtual (picture)\n\n## Installation\n\n1. Turn on SPI via `sudo raspi-config`\n    ```\n    Interfacing Options -\u003e SPI\n   ```\n2. Install dependencies\n    ```\n    sudo apt update\n    sudo apt-get install python3-pip python3-numpy git\n    pip3 install RPi.GPIO spidev pillow\n    ```\n\n3. Install drivers for your display (you don't need to install both)\n    1. If you have a Waveshare display\n    ```\n    git clone https://github.com/waveshare/e-Paper.git ~/e-Paper\n    pip3 install ~/e-Paper/RaspberryPi_JetsonNano/python/\n    ```\n    2. If you have an Inky wHAT display\n    ```\n    pip3 install inky[rpi]\n    ```\n4. Download Zero BTC Screen\n    ```\n    git clone https://github.com/dr-mod/zero-btc-screen.git ~/zero-btc-screen\n    ```\n5. Run it\n    ```\n    python3 ~/zero-btc-screen/main.py\n    ```\n\n\n## Screen configuration\n\nThe application supports multiple types of e-ink screens, and an additional \"picture\" screen.\n\nTo configure which display(s) to use, configuration.cfg should be modified. In the following example an e-ink epd2in13v2\nand \"picture\" screens are select:\n\n```cfg\n[base]\nconsole_logs             : false\n#logs_file               : /tmp/zero-btc-screen.log\ndummy_data               : false\nrefresh_interval_minutes : 15\n# Price pair from Coinbase e.g. BTC-EUR or ADA-GBP\ncurrency                 : BTC-USD\n\n# Enabled screens or devices\nscreens : [\n    epd2in13v2\n#    epd2in13v3\n#    epd2in13bv3\n#    epd2in7\n#    epd3in7\n    picture\n#    inkyWhatRBW\n  ]\n\n# Configuration per screen\n# This doesn't make any effect if screens are not enabled above\n[epd2in13v2]\nmode : candle\n\n[epd2in13v3]\nmode : candle\n\n[epd2in13bv3]\nmode : line\n\n[epd2in7]\nmode : candle\n\n[epd3in7]\nmode : candle\n\n[picture]\nfilename : /home/pi/output.png\n\n[inkyWhatRBW]\nmode : candle\n```\n\n### Autostart\n\nTo make it run on startup you can choose from 2 options:\n\n1. Using the rc.local file\n    1. `sudo nano /etc/rc.local`\n    2. Add one the following before `exit 0`\n   ```\n   /usr/bin/python3 /home/pi/zero-btc-screen/main.py \u0026\n   ```\n   conversely, you can run in `screen` you can install it with `sudo apt-get install screen`\n   ```\n   su - pi -c \"/usr/bin/screen -dm sh -c '/usr/bin/python3 /home/pi/zero-btc-screen/main.py'\"\n   ```\n2. Using the system's services daemon\n    1. Create a new service configuration file\n       ```\n        sudo nano /etc/systemd/system/btc-screen.service\n        ```\n    2. Copy and paste the following into the service configuration file and change any settings to match your\n       environment\n       ```\n        [Unit]\n        Description=zero-btc-screen\n        After=network.target\n \n        [Service]\n        ExecStart=/usr/bin/python3 -u main.py\n        WorkingDirectory=/home/pi/zero-btc-screen\n        StandardOutput=inherit\n        StandardError=inherit\n        Restart=always\n        User=pi\n \n        [Install]\n        WantedBy=multi-user.target\n        ```\n    3. Enable the service so that it starts whenever the RPi is rebooted\n       ```\n        sudo systemctl enable btc-screen.service\n       ```\n    4. Start the service and enjoy!\n       ```\n        sudo systemctl start btc-screen.service\n       ```\n\n       If you need to troubleshoot you can use the logging configurations of this program (mentioned below).\n       Alternatively, you can check to see if there is any output in the system service logging.\n       ```\n        sudo journalctl -f -u btc-screen.service\n       ```\n\n### Support the project\nIf you would like to support this project and and keep me caffeinated, you can do it here:\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/drmod)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdr-mod%2Fzero-btc-screen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdr-mod%2Fzero-btc-screen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdr-mod%2Fzero-btc-screen/lists"}