|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| forms/ | H | 28-Jan-2021 | - | 8,991 | 8,970 |
| locale/ | H | 28-Jan-2021 | - | 211,471 | 211,385 |
| res/ | H | 28-Jan-2021 | - | 54 | 42 |
| test/ | H | 28-Jan-2021 | - | 1,122 | 793 |
| Makefile | H A D | 28-Jan-2021 | 252 | 10 | 9 |
| README.md | H A D | 28-Jan-2021 | 3.4 KiB | 96 | 58 |
| addressbookpage.cpp | H A D | 28-Jan-2021 | 10.5 KiB | 336 | 266 |
| addressbookpage.h | H A D | 28-Jan-2021 | 2.4 KiB | 87 | 56 |
| addresstablemodel.cpp | H A D | 28-Jan-2021 | 14.4 KiB | 457 | 385 |
| addresstablemodel.h | H A D | 28-Jan-2021 | 3.7 KiB | 106 | 59 |
| askpassphrasedialog.cpp | H A D | 28-Jan-2021 | 11.3 KiB | 299 | 260 |
| askpassphrasedialog.h | H A D | 28-Jan-2021 | 1.4 KiB | 57 | 37 |
| bantablemodel.cpp | H A D | 28-Jan-2021 | 4.4 KiB | 180 | 136 |
| bantablemodel.h | H A D | 28-Jan-2021 | 1.9 KiB | 80 | 52 |
| bitcoin.cpp | H A D | 28-Jan-2021 | 24.2 KiB | 635 | 451 |
| bitcoin.h | H A D | 28-Jan-2021 | 3.4 KiB | 130 | 84 |
| bitcoin.qrc | H A D | 28-Jan-2021 | 5.4 KiB | 87 | 86 |
| bitcoin_locale.qrc | H A D | 28-Jan-2021 | 4.7 KiB | 91 | 90 |
| bitcoinaddressvalidator.cpp | H A D | 28-Jan-2021 | 2.6 KiB | 98 | 60 |
| bitcoinaddressvalidator.h | H A D | 28-Jan-2021 | 943 | 36 | 18 |
| bitcoinamountfield.cpp | H A D | 28-Jan-2021 | 9.2 KiB | 343 | 269 |
| bitcoinamountfield.h | H A D | 28-Jan-2021 | 2.3 KiB | 85 | 38 |
| bitcoingui.cpp | H A D | 28-Jan-2021 | 55.5 KiB | 1,522 | 1,254 |
| bitcoingui.h | H A D | 28-Jan-2021 | 12.2 KiB | 356 | 218 |
| bitcoinstrings.cpp | H A D | 28-Jan-2021 | 13.1 KiB | 214 | 209 |
| bitcoinunits.cpp | H A D | 28-Jan-2021 | 6.5 KiB | 247 | 202 |
| bitcoinunits.h | H A D | 28-Jan-2021 | 3.7 KiB | 115 | 59 |
| clientmodel.cpp | H A D | 28-Jan-2021 | 10.4 KiB | 327 | 257 |
| clientmodel.h | H A D | 28-Jan-2021 | 4 KiB | 129 | 92 |
| coincontroldialog.cpp | H A D | 28-Jan-2021 | 28.6 KiB | 711 | 525 |
| coincontroldialog.h | H A D | 28-Jan-2021 | 2.7 KiB | 115 | 87 |
| coincontroltreewidget.cpp | H A D | 28-Jan-2021 | 1.1 KiB | 35 | 27 |
| coincontroltreewidget.h | H A D | 28-Jan-2021 | 583 | 23 | 13 |
| createwalletdialog.cpp | H A D | 28-Jan-2021 | 2.9 KiB | 91 | 62 |
| createwalletdialog.h | H A D | 28-Jan-2021 | 841 | 37 | 22 |
| csvmodelwriter.cpp | H A D | 28-Jan-2021 | 1.8 KiB | 92 | 71 |
| csvmodelwriter.h | H A D | 28-Jan-2021 | 1.1 KiB | 47 | 27 |
| editaddressdialog.cpp | H A D | 28-Jan-2021 | 4.6 KiB | 167 | 138 |
| editaddressdialog.h | H A D | 28-Jan-2021 | 1.3 KiB | 60 | 37 |
| guiconstants.h | H A D | 28-Jan-2021 | 2 KiB | 59 | 25 |
| guiutil.cpp | H A D | 28-Jan-2021 | 27.7 KiB | 926 | 752 |
| guiutil.h | H A D | 28-Jan-2021 | 10.6 KiB | 309 | 145 |
| intro.cpp | H A D | 28-Jan-2021 | 12 KiB | 371 | 286 |
| intro.h | H A D | 28-Jan-2021 | 2.3 KiB | 87 | 51 |
| macdockiconhandler.h | H A D | 28-Jan-2021 | 596 | 28 | 15 |
| macdockiconhandler.mm | H A D | 28-Jan-2021 | 1.4 KiB | 54 | 42 |
| macnotificationhandler.h | H A D | 28-Jan-2021 | 806 | 28 | 12 |
| macnotificationhandler.mm | H A D | 28-Jan-2021 | 2.1 KiB | 63 | 53 |
| macos_appnap.h | H A D | 28-Jan-2021 | 544 | 25 | 15 |
| macos_appnap.mm | H A D | 28-Jan-2021 | 1.8 KiB | 72 | 59 |
| main.cpp | H A D | 28-Jan-2021 | 677 | 22 | 11 |
| modaloverlay.cpp | H A D | 28-Jan-2021 | 6.5 KiB | 191 | 145 |
| modaloverlay.h | H A D | 28-Jan-2021 | 1.6 KiB | 58 | 38 |
| networkstyle.cpp | H A D | 28-Jan-2021 | 3 KiB | 97 | 64 |
| networkstyle.h | H A D | 28-Jan-2021 | 1.1 KiB | 34 | 21 |
| notificator.cpp | H A D | 28-Jan-2021 | 7.2 KiB | 258 | 195 |
| notificator.h | H A D | 28-Jan-2021 | 2.5 KiB | 78 | 49 |
| openuridialog.cpp | H A D | 28-Jan-2021 | 874 | 43 | 30 |
| openuridialog.h | H A D | 28-Jan-2021 | 606 | 32 | 19 |
| optionsdialog.cpp | H A D | 28-Jan-2021 | 14.6 KiB | 387 | 289 |
| optionsdialog.h | H A D | 28-Jan-2021 | 1.8 KiB | 79 | 52 |
| optionsmodel.cpp | H A D | 28-Jan-2021 | 18.5 KiB | 538 | 423 |
| optionsmodel.h | H A D | 28-Jan-2021 | 4.3 KiB | 125 | 80 |
| overviewpage.cpp | H A D | 28-Jan-2021 | 13 KiB | 299 | 237 |
| overviewpage.h | H A D | 28-Jan-2021 | 1.6 KiB | 67 | 47 |
| paymentserver.cpp | H A D | 28-Jan-2021 | 9 KiB | 293 | 208 |
| paymentserver.h | H A D | 28-Jan-2021 | 3.1 KiB | 110 | 43 |
| peertablemodel.cpp | H A D | 28-Jan-2021 | 6.6 KiB | 241 | 186 |
| peertablemodel.h | H A D | 28-Jan-2021 | 2.3 KiB | 91 | 63 |
| platformstyle.cpp | H A D | 28-Jan-2021 | 4 KiB | 138 | 110 |
| platformstyle.h | H A D | 28-Jan-2021 | 1.6 KiB | 53 | 28 |
| psbtoperationsdialog.cpp | H A D | 28-Jan-2021 | 10.6 KiB | 269 | 227 |
| psbtoperationsdialog.h | H A D | 28-Jan-2021 | 1.4 KiB | 55 | 38 |
| qrimagewidget.cpp | H A D | 28-Jan-2021 | 4 KiB | 146 | 118 |
| qrimagewidget.h | H A D | 28-Jan-2021 | 1.2 KiB | 48 | 28 |
| qvalidatedlineedit.cpp | H A D | 28-Jan-2021 | 2.5 KiB | 124 | 95 |
| qvalidatedlineedit.h | H A D | 28-Jan-2021 | 1.1 KiB | 44 | 27 |
| qvaluecombobox.cpp | H A D | 28-Jan-2021 | 808 | 32 | 22 |
| qvaluecombobox.h | H A D | 28-Jan-2021 | 957 | 38 | 21 |
| receivecoinsdialog.cpp | H A D | 28-Jan-2021 | 10.9 KiB | 306 | 240 |
| receivecoinsdialog.h | H A D | 28-Jan-2021 | 2 KiB | 78 | 58 |
| receiverequestdialog.cpp | H A D | 28-Jan-2021 | 2.9 KiB | 109 | 85 |
| receiverequestdialog.h | H A D | 28-Jan-2021 | 920 | 41 | 26 |
| recentrequeststablemodel.cpp | H A D | 28-Jan-2021 | 7.2 KiB | 237 | 187 |
| recentrequeststablemodel.h | H A D | 28-Jan-2021 | 3.2 KiB | 100 | 70 |
| rpcconsole.cpp | H A D | 28-Jan-2021 | 48.9 KiB | 1,304 | 1,019 |
| rpcconsole.h | H A D | 28-Jan-2021 | 5.9 KiB | 177 | 121 |
| sendcoinsdialog.cpp | H A D | 28-Jan-2021 | 37.8 KiB | 1,004 | 814 |
| sendcoinsdialog.h | H A D | 28-Jan-2021 | 4.2 KiB | 133 | 96 |
| sendcoinsentry.cpp | H A D | 28-Jan-2021 | 7.4 KiB | 254 | 194 |
| sendcoinsentry.h | H A D | 28-Jan-2021 | 2.1 KiB | 82 | 50 |
| sendcoinsrecipient.h | H A D | 28-Jan-2021 | 2.6 KiB | 66 | 39 |
| signverifymessagedialog.cpp | H A D | 28-Jan-2021 | 9.4 KiB | 286 | 237 |
| signverifymessagedialog.h | H A D | 28-Jan-2021 | 1.4 KiB | 54 | 36 |
| splashscreen.cpp | H A D | 28-Jan-2021 | 8 KiB | 242 | 182 |
| splashscreen.h | H A D | 28-Jan-2021 | 2.1 KiB | 75 | 43 |
| trafficgraphwidget.cpp | H A D | 28-Jan-2021 | 4.9 KiB | 180 | 147 |
| trafficgraphwidget.h | H A D | 03-May-2022 | 1.1 KiB | 50 | 35 |
| transactiondesc.cpp | H A D | 28-Jan-2021 | 14.5 KiB | 363 | 278 |
| transactiondesc.h | H A D | 28-Jan-2021 | 899 | 36 | 21 |
| transactiondescdialog.cpp | H A D | 28-Jan-2021 | 878 | 29 | 19 |
| transactiondescdialog.h | H A D | 28-Jan-2021 | 732 | 32 | 19 |
| transactionfilterproxy.cpp | H A D | 28-Jan-2021 | 3.6 KiB | 122 | 95 |
| transactionfilterproxy.h | H A D | 28-Jan-2021 | 2 KiB | 69 | 41 |
| transactionrecord.cpp | H A D | 28-Jan-2021 | 7.9 KiB | 250 | 194 |
| transactionrecord.h | H A D | 28-Jan-2021 | 4.4 KiB | 148 | 85 |
| transactiontablemodel.cpp | H A D | 28-Jan-2021 | 26.1 KiB | 761 | 650 |
| transactiontablemodel.h | H A D | 28-Jan-2021 | 4.4 KiB | 124 | 80 |
| transactionview.cpp | H A D | 28-Jan-2021 | 25 KiB | 655 | 534 |
| transactionview.h | H A D | 28-Jan-2021 | 3.1 KiB | 127 | 93 |
| utilitydialog.cpp | H A D | 28-Jan-2021 | 5.4 KiB | 171 | 127 |
| utilitydialog.h | H A D | 28-Jan-2021 | 1.1 KiB | 54 | 34 |
| walletcontroller.cpp | H A D | 28-Jan-2021 | 11.3 KiB | 334 | 259 |
| walletcontroller.h | H A D | 28-Jan-2021 | 3.9 KiB | 154 | 107 |
| walletframe.cpp | H A D | 28-Jan-2021 | 7.8 KiB | 256 | 206 |
| walletframe.h | H A D | 28-Jan-2021 | 3 KiB | 106 | 57 |
| walletmodel.cpp | H A D | 28-Jan-2021 | 19.6 KiB | 596 | 476 |
| walletmodel.h | H A D | 28-Jan-2021 | 7.8 KiB | 243 | 152 |
| walletmodeltransaction.cpp | H A D | 28-Jan-2021 | 1.6 KiB | 69 | 54 |
| walletmodeltransaction.h | H A D | 28-Jan-2021 | 1.1 KiB | 46 | 27 |
| walletview.cpp | H A D | 28-Jan-2021 | 12 KiB | 355 | 275 |
| walletview.h | H A D | 28-Jan-2021 | 4.5 KiB | 134 | 69 |
| winshutdownmonitor.cpp | H A D | 28-Jan-2021 | 1.9 KiB | 58 | 39 |
| winshutdownmonitor.h | H A D | 28-Jan-2021 | 893 | 28 | 15 |
README.md
1This directory contains the BitcoinQT graphical user interface (GUI). It uses the cross-platform framework [Qt](https://www1.qt.io/developers/).
2
3The current precise version for Qt 5 is specified in [qt.mk](/depends/packages/qt.mk).
4
5## Compile and run
6
7See build instructions ([macOS](/doc/build-osx.md), [Windows](/doc/build-windows.md), [Unix](/doc/build-unix.md), etc).
8
9To run:
10
11```sh
12./src/qt/bitcoin-qt
13```
14
15## Files and directories
16
17### forms
18
19Contains [Designer UI](https://doc.qt.io/qt-5.9/designer-using-a-ui-file.html) files. They are created with [Qt Creator](#using-qt-creator-as-ide), but can be edited using any text editor.
20
21### locale
22
23Contains translations. They are periodically updated. The process is described [here](/doc/translation_process.md).
24
25### res
26
27Resources such as the icon.
28
29### test
30
31Tests.
32
33### bitcoingui.(h/cpp)
34
35Represents the main window of the Bitcoin UI.
36
37### \*model.(h/cpp)
38
39The model. When it has a corresponding controller, it generally inherits from [QAbstractTableModel](https://doc.qt.io/qt-5/qabstracttablemodel.html). Models that are used by controllers as helpers inherit from other Qt classes like [QValidator](https://doc.qt.io/qt-5/qvalidator.html).
40
41ClientModel is used by the main application `bitcoingui` and several models like `peertablemodel`.
42
43### \*page.(h/cpp)
44
45A controller. `:NAMEpage.cpp` generally includes `:NAMEmodel.h` and `forms/:NAME.page.ui` with a similar `:NAME`.
46
47### \*dialog.(h/cpp)
48
49Various dialogs, e.g. to open a URL. Inherit from [QDialog](https://doc.qt.io/qt-5/qdialog.html).
50
51### paymentserver.(h/cpp)
52
53Used to process BIP21 payment URI requests. Also handles URI based application switching (e.g. when following a bitcoin:... link from a browser).
54
55### walletview.(h/cpp)
56
57Represents the view to a single wallet.
58
59### Other .h/cpp files
60
61* UI elements like BitcoinAmountField, which inherit from QWidget.
62* `bitcoinstrings.cpp`: automatically generated
63* `bitcoinunits.(h/cpp)`: BTC / mBTC / etc handling
64* `callback.h`
65* `guiconstants.h`: UI colors, app name, etc
66* `guiutil.h`: several helper functions
67* `macdockiconhandler.(h/mm)`: macOS dock icon handler
68* `macnotificationhandler.(h/mm)`: display notifications in macOS
69
70## Contribute
71
72See [CONTRIBUTING.md](/CONTRIBUTING.md) for general guidelines. Specifically for Qt:
73
74* don't change `local/bitcoin_en.ts`; this happens [automatically](/doc/translation_process.md#writing-code-with-translations)
75
76## Using Qt Creator as IDE
77
78You can use Qt Creator as an IDE. This is especially useful if you want to change
79the UI layout.
80
81Download and install the community edition of [Qt Creator](https://www.qt.io/download/).
82Uncheck everything except Qt Creator during the installation process.
83
84Instructions for macOS:
85
861. Make sure you installed everything through Homebrew mentioned in the [macOS build instructions](/doc/build-osx.md)
872. Use `./configure` with the `--enable-debug` flag
883. In Qt Creator do "New Project" -> Import Project -> Import Existing Project
894. Enter "bitcoin-qt" as project name, enter src/qt as location
905. Leave the file selection as it is
916. Confirm the "summary page"
927. In the "Projects" tab select "Manage Kits..."
938. Select the default "Desktop" kit and select "Clang (x86 64bit in /usr/bin)" as compiler
949. Select LLDB as debugger (you might need to set the path to your installation)
9510. Start debugging with Qt Creator (you might need to the executable to "bitcoin-qt" under "Run", which is where you can also add command line arguments)
96