Introduction

These are work-in-progress design documents for the QML-based Bitcoin Core application that is currently in early development. The goal of this site is to document and make easily accessible various considerations and decisions that went into the design of the user interface and user experience.

Provide early feedback

You are invited to be an early tester of the application and provide your feedback to help us in creating a great experience. Keep in mind that the application is experimental, you are installing and running it at your own risk.

The current application only includes a simple onboarding process and the block clock. It does not include wallet features (those will be added in future milestones). It is available for Linux, Windows, MacOS, and Android operating systems.

Desktop and mobile screens showing the block clock
All screens in the initial onboarding flow

Feedback we are looking for right now

  • Did you install it on a phone, tablet or desktop?
  • What is the device brand and model?
  • Which operating system did you use?
  • Were the download instructions easy to understand?
  • How was the initial installation process?
  • How long did it take to sync?
  • How did the installation affect the battery of your device?
  • What do you think of the block clock?
  • How was the overall experience for you?

A few notes

  • Older Android devices may not allow you to install the application
  • If the application crashes on start, see if you have a bitcoin.conf file and all settings it contains are correct
  • Pull requests are likely set to signet, the switch to mainnet will come soon

Test the latest code

This is the latest code that has been reviewed and merged code, but not a milestone, tag, or release. Find the download link for your operating system here.

A note for Apple Silicon macOS devices

The application file must be signed before it can be run. Then right-click the file and select “Open”. To apply a signature, execute the following code in your Terminal (ensure you are in the same folder as the downloaded file):

codesign -s - ./unsecure_mac_arm64_gui

Test work-in-progress

Pull requests include work-in-progress code and features that have not been finalized and reviewed yet. You may help test these updates by finding a pull request you are interested in (find the full list here) and using the respective download link in the top comment. If you provide comments on these, focus on the specific part of the application that the pull request is about.

How to provide feedback

We sincerely appreciate your feedback. We will review it and create tasks and issues as appropriate. Before pointing out missing features, familiarize yourself with what is included in the application and what is not (see above). Please also review issues filed by others first to avoid duplication.

There are 4 ways you can submit feedback:

Thank you for your help.