how_to_build.md

Use pyinstaller to compile to executable program, so that you can double-click the image to open the HandyView.

1. Use pyinstaller to build

    ./pyinstaller_install.sh

2. Choose the dist/handyview/handyviewer.exe as the default image viewer

Using Anaconda for building will produce app with a very large file size, so we recommend using virtualenv to build the app.

1. Clone the repo

   git clone https://github.com/xinntao/HandyView.git
   cd HandyView

2. Prepare virtualenv

   pip3 install virtualenv
   virtualenv venv
   source venv/bin/activate
   pip install -r requirements.txt

3. Use pyinstaller to build

   ./pyinstaller_install_mac.sh

   the compiled app is located at dist/handyviewer.app
4. [option] Create dmg file

   ./create_dmg.sh

   the dmg file is located at dist/handyviewer.dmg