# SmartCube V1

**SmartCube** is a tiny, customizable desk toy built with an ESP8266 D1 Mini. It can display messages on an OLED, monitor battery voltage, control a buzzer, and respond to button presses. 

The guide how to make one is [available here](https://git.kopic.hr/tomislav/SmartCubeV1)

---

# How to flash EPSHome on the SmartCube?

## 1️⃣ Clone the Repository

You may need to install [git first](https://git-scm.com/downloads/win)
If you are on **Windows**, open **Command Prompt (CMD)**:

1. Press **Win + R**, type `cmd`, and press **Enter**.

2. Clone the repo:

```bash
git clone https://git.kopic.hr/tomislav/SmartCube_ESPHome.git
cd SmartCube_ESPHome
```

This downloads all the files for your SmartCube.

---

## 2️⃣ Install Python

1. Download Python 3.13+ from [python.org](https://www.python.org/downloads/).
2. During installation, **check “Add Python to PATH”**.
3. Verify installation in CMD:

```bash
python --version
```

---

## 3️⃣ Install ESPHome

Install ESPHome using Python’s package manager:

```bash
pip install esphome
```

Check installation:

```bash
esphome version
```

---

## 4️⃣ Flash the SmartCube

1. Connect your SmartCube to your PC using a **data-capable USB cable**.

2. Upload the firmware:

```bash
esphome run smartcube.yaml
```

**3. ESPHome may ask which device to flash.**
Look for the entry that says something like:

```
(USB Serial Port (COMX))
```

Select that one by typing its number and pressing **Enter**.

ESPHome will compile and flash the firmware.

4. After flashing, the cube will connect to the Wi-Fi if you configured it in the smartcube.yaml file.

   * If you did not, that's okay, it will start a fallback AP named **SmartCube** with password **12345678**.
   * Connect to this AP with your phone or PC to configure the Wi-Fi.