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
  • To ensure you see the onboarding flow, start the application with -resetguisettings

Test the latest code

This is the latest code that has been reviewed and merged code, but not a milestone, tag, or release.

  • Log in to GitHub
  • Navigate to the Actions page
  • Find the latest successful “Merge” entry and click it
  • Scroll down to artifacts and download the one for your operating system
A note for Apple Silicon macOS devices

There are two things you might need to do before you can run the application.

If MacOS sees the downloaded file as a document and not as an application, run this code in the Terminal (in the folder you download the file to):

chmod +x ./bitcoin-qt

It must also be signed before it can be run, via this command:

codesign -s - ./bitcoin-qt

Then right-click the file and select “Open”.

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), finding the latest successful build on the Actions page (make sure you are logged in), and using the respective download link for your operating system. 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.