Skip to content

Build from Source

Bytecoin.World edited this page Oct 11, 2026 · 1 revision

Build from source

The community GUI depends on the Bytecoin core project and Qt. The CMake build uses CMake 3.14 or newer and a C++17 compiler. It fetches the pinned ZXing-C++ 1.4.0 source for local QR reading and writing. The qmake project instead needs a prebuilt static ZXing-C++ 1.4.0 installation with reader and writer support.

Windows

  1. Follow the upstream Bytecoin core Windows build prerequisites.
  2. Install Qt and Visual Studio with compatible compiler and architecture selections.
  3. For the CMake build, configure the GUI project with CMake and a C++17-capable Visual Studio toolchain.
  4. For qmake, open src/bytecoin-gui.pro in Qt Creator and build with a compatible MSVC kit. Build and install static ZXing-C++ 1.4.0 with readers and writers enabled, then set ZXING_ROOT to its install prefix.

macOS

Follow the upstream Bytecoin core macOS build prerequisites, install Qt and Xcode, then build the GUI with a compatible Clang kit. For qmake builds, install a static ZXing-C++ 1.4.0 build for the same architecture and set ZXING_ROOT.

Linux (Ubuntu example)

Install Qt and CMake development tools:

sudo apt install qt5-qmake qtbase5-dev qtbase5-dev-tools cmake

Build the core dependency and GUI:

git clone https://github.com/bcndev/bytecoin.git
cd bytecoin
mkdir -p build
cd build
cmake ..
make -j4 bytecoin-crypto
cd ../..
git clone https://github.com/bytecoinworld/bytecoin-gui.git
cd bytecoin-gui
mkdir -p build
cd build
cmake .. -DCMAKE_PREFIX_PATH=/path/to/qt
make -j4

The CMake configuration obtains ZXing-C++ 1.4.0 for QR functionality. QR reading and writing are performed locally; the project does not send payment addresses or QR contents to a QR service.

For additional supported options and platform-specific details, consult the repository's README and the upstream Bytecoin core build instructions. Build dependencies and toolchain details can change over time.

Clone this wiki locally