Customize
Add or remove features, change how it looks, and update it later.
- 20 min
- On the Pi
Everything here is optional. Most changes mean rebuilding the firmware, which means letting the Pi back online for a while.
Let the Pi back online
Your wallet has Wi-Fi switched off. To change its firmware:
- Unplug the wallet and put its memory card into your computer.
- Open the file
config.txton the card, and delete the two linesdtoverlay=disable-wifianddtoverlay=disable-bt. Save. - Put the card back, plug the wallet in, wait a minute, and log in with
ssh you@diywallet.localas before.
When you’re done, the install script switches the radios off again.
Firmware options
| Option | How |
|---|---|
| Bitcoin only | Add BITCOIN_ONLY=1 to the compile command in step 4, then reinstall. |
| Forget the wallet when unplugged | Run the install script with --ram-only. Without it, the wallet stays on the card. |
| Turn the picture around | Put DIY_OLED_ROTATE=180 in /etc/diywallet.conf, as in step 5. |
| Language | On the device, in its settings. No rebuild needed. |
After changing a compile option, clear out the old build, then compile again and reinstall. The make ... clean line matters: without it, parts built with the old settings get mixed into the new firmware.
. ~/wallet-venv/bin/activate
cd ~/wallet/legacy
make -C emulator clean && make clean && make -C firmware clean
EMULATOR=1 DIY_HAT=1 DEBUG_LINK=0 BITCOIN_ONLY=1 ./script/cibuild
cd ~/wallet
sudo ./diy/install.sh --ram-only
sudo rebootYour own home-screen icon
The 24-by-24 pixel icon above the wallet name is a picture you can replace.
- Draw a 24×24 pixel black-and-white PNG. White pixels light up.
- Copy it onto the Pi. From your computer:
scp my-icon.png you@diywallet.local:wallet/ - Put it into the firmware, then compile and install as above:
. ~/wallet-venv/bin/activate
pip install pillow
cd ~/wallet
python3 diy/set-home-icon.py my-icon.pngThe script prints your icon as a grid of # and . so you can check it before compiling.
App options
The app’s theme (light, dark, or following your computer) is in its settings and needs no rebuild.
If you change the app’s code, for example its colours in packages/components/colors/, rebuild it as in step 6.
Updating later
New versions of the DIY firmware will be listed in Sources. To update, let the Pi back online, then:
cd ~/wallet
git fetch --depth 1 origin diy
git log -1 --format=%H FETCH_HEADCompare the commit with the one listed in Sources and read what changed. Then switch to it and compile and reinstall as above:
git checkout FETCH_HEAD
git submodule update --init --recursive --depth 1The official OneKey firmware updates offered in the app are for OneKey’s own devices and will not install on this one.