How to build the Guitar (en) (draft)



- Compiler

-- Windows

Microsoft Visual C++ 2013 or later
Ruby :
Perl :

-- mac OS


-- Linux

Ruby : apt-get install ruby
Perl : apt-get install perl


Dependent libraries

- Qt :
--Please download and install Qt SDK suitable for your platform.

- zlib :

- OpenSSL : |
-- required openssl-1.0.x
--- openssl-1.1.x is not supported


Download sources

- Guitar

-- (https) git clone
-- (ssh) git clone

- zlib

-- git clone

- OpenSSL

-- git clone
-- ...or download source from


Directories (example)



Make the zlib

- Start the Qt Creator and open Guitar/
-- Set build directory to:
--- (ex. for Windows) C:\work\_build_zlib
--- (ex. for Linux/mac) /home/my/work/_build_zlib_Debug|Release
- Run [Build] menu (or press Ctrl+B)


Make OpenSSL on Windows

please read the INSTALL.W32

recommended to install the OpenSSL on C:\openssl

- > perl Configure VC-WIN32 --prefix=c:\openssl


Make OpenSSL on macOS

$ cd openssl
$ git checkout -b OpenSSL_1_0_2-stable origin/OpenSSL_1_0_2-stable
$ ./Configure darwin64-x86_64-cc --prefix=/usr/local
$ make -j4
$ sudo make install


Install OpenSSL on Linux

$ sudo apt-get install libssl-dev


Make the Guitar

- first, run the script 'prepare.rb'

$ cd Guitar
$ ruby prepare.rb

- start the Qt Creator, open the project file ''
-- Set build directory to:
--- (ex. for Windows) C:\work\_build_Guitar
--- (ex. for Linux/mac) /home/my/work/_build_Guitar_Debug|Release
-- do [Run qmake] (in [Build] menu)
-- do [Build] (or press Ctrl+B)



(on Windows) necessary to copy OpenSSL's 'libeay32.dll' and 'ssleay32.dll' to the same folder as 'Guitar.exe'.