Skip to content

Widget with price action for your favorite cryptocurrencies... on your desk

Notifications You must be signed in to change notification settings

piotrwawrzyn/bitcoin-watch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bitcoin-watch

Bitcoin watch is a ESP8266 based project that allows you to monitor price action of all your favorite cryptocurrencies... on your desk.

I encourage anyone who's excited about crypto to go and build this project. It's really cool - it's a little bit like having a small binance widget right on your desk.

Bitcoin watch preview 1

Table of Contents

  1. Features
  2. Hardware requirements
  3. Instalation and usage
  4. Problems? Happy to help
  5. Credits

Features

  • Monitor 10+ cryptocurrencies
  • Add any cryptocurrency that is supported by CoinGecko (over 6000 different coins)
  • Pick image (logo) of your choice for every cryptocurrency
  • Tons of information for every coin: USD price, BTC price, ETH price, 24h change, 7 days change all fitted on a compact 1"x1" screen
  • Light theme and dark theme
  • Connect to your home Wi-Fi network

Bitcoin watch preview 2

Hardware requirements

Instalation and usage

So you have the ESP8266 D1 Mini and D1 Mini TFT Shield already? Great, installation is straightforward and should only take you about 10 to 20 minutes. No deeper technical knowledge required. Below I will guide you step by step how to upload the software on your board and then how to add your own customized cryptos as well!

Uploading the project to your board (step by step)

  1. Download Arduino IDE software from official arduino website

  2. Download the project from github as a zip file

Download project zip

  1. Unzip it in your desired location on your computer (for example on the desktop)

  2. Follow this little tutorial to install ESP8266 Add-on in Arduino IDE

  3. Select the correct board in Arduino IDE

    • Go to Tools > Board > ESP8266 Boards
    • Select LOLIN(WEMOS) D1 R2 & mini

    Selecting the correct board

  4. Follow this little tutorial to install ESP8266 Filesystem Uploader in Arduino IDE. It is needed to upload images from your computer to your board

  5. Install necessary libraries. We will need: ArduinoJson, TFT_eSPI and TJpg_Decoder

    • Download zip file with these 3 libs
    • Place the libs from the zip file in the Arduino's libraries folder
    • The path to this folder is by default something like C:\Users\<user>\Documents\Arduino\libraries

    libraries folder

  6. Set up your Wi-fi connection in the project

    • Open bitcoin-watch.ino file in Arduino IDE
    • Put your Wi-fi ssid and password in configurations section.

    configurations

  7. Wire your ESP8266 D1 Mini board to your computer.

  8. Upload images from the data folder to your ESP8266 D1 Mini

    • Click tools > ESP8266 Sketch Data Upload

    tools > ESP8266 Sketch Data Upload

    • It will automatically upload all the images from the data folder to your board
    • If you don't see the ESP8266 Sketch Data Upload in the menu it means that you didn't install ESP8266 Filesystem Uploader properly
  9. Upload the project to your board

    • Click "Upload" button in the top menu

      Upload

    • Uploading should take about 20-30 seconds

  10. That's it. You should now see the application running on your board's screen. Good job! If you still have a problem or some of my explanations were not clear enough, consider opening and issue on GitHub or message me directly. I'm always happy to help.

Adding another cryptocurrency of your choice (step by step)

You can track any cryptocurrency that is supported by CoinGecko

  1. Get CoinGecko id of your cryptocurrency

    • Open CoinGecko all coins list
    • Use search to look for your cryptocurrency ticker. For example if you are looking to add VeChain (VET) look for "VET" (include quotation marks)

    Search for symbol

    • CoinGecko id is located next to the symbol. In our example the id is vechain

    VeChain id

    • Copy this id, we will need it in the next steps
  2. Add coin to the list in the project

    • Open cryptos.h file in the project

    • Find the cryptos array inside the file

      cryptos list

    • You can remove some of the already added coins from the array if you don't want to monitor their prices

    • In my case I will remove everything besides bitcoin and ethereum

    bitcoin and ethereum

    • Add the id of the coin that you copied from CoinGecko's list in the same format as other coins

      image

  3. Add 80px x 80px coin logo to the data folder

    • Download logo image of your choice for your coin
    • Use a simple graphics editor tool to scale it to 80px x 80px. I recommend Paint for this one
    • Save it as JPG image with name as id of the coin the logo is designed for inside of the data folder. In my example I will save it as vechain.jpg
    • If the image is not in JPG format, it won't work. If the logo is not in the right dimensions it will look poor in the UI
  4. Upload images from the data folder to your ESP8266 D1 Mini

    • Click tools > ESP8266 Sketch Data Upload
    • It will automatically upload all the images from the data folder to your board
  5. Upload the project to your board

Changing the theme to dark

  1. Open bitcoin-watch.ino file in ArduinoIDE

  2. Find the Theme config section inside the file

  3. Comment out #define LIGHT_THEME 1 and uncomment #define DARK_THEME 1

Theme config

  1. Upload the project to your board

Problems? Happy to help

If you have problems of any kind or need help with setting this thing up, I'm more than happy to help you! Consider either opening an issue on GitHub or message me directly.

Credits

I would like to personally thank Brian Lough for sending me the board and the display and giving the opportunity to work on this project. The Bitcoin Watch is also inspired by his old project Simple Arduino Crypto Display which used NodeMCU ESP8266 Board and OLED Display 1.3".

About

Widget with price action for your favorite cryptocurrencies... on your desk

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published