Creating Binary Packages

Windows

Setting up to run Horus-GUI

• Use stock Python 3.7 for Windows (no Anaconda Python!!!). (Note - Python 3.7 is used to ensure Win 7 support)
  • https://www.python.org/ftp/python/3.7.9/python-3.7.9-amd64.exe
  • When installing, ensure the Python install is added to the system path.
• Create and enter venv
  • python -m venv
  • venv\Scripts\activate.bat
• Install PyAudio from wheel here: https://www.lfd.uci.edu/~gohlke/pythonlibs/#pyaudio (get the cp37m-win_amd64 wheel, then pip install filename.whl)
  • For python 3.7: https://download.lfd.uci.edu/pythonlibs/archived/cp37/PyAudio-0.2.11-cp37-cp37m-win_amd64.whl
• Then get rest of dependencies with: pip install -r requirements.txt
• Download libhorus.dll and put into the current directory: https://github.com/projecthorus/horusdemodlib/releases/download/v0.1.21/libhorus.dll
• Can now test starting Horus-GUI by running: python horus-gui.py

(So what happens if we use a newer python version? Horus-GUI does work fine under Python 3.9, so maybe we try that? That means no more Windows 7 support, but oh well.)

Building a EXE file

• pip install pyinstaller

• Copy the following DLLs from a MinGW-64 installation (C:\mingw64\bin) into the current directory:

  • libgcc_s_seh-1.dll
  • libwinpthread-1.dll
  • libstdc++-6.dll

• Now run: pyinstaller horus-gui_win.spec

• Should build OK!

• This will create a directory 'dist/' with horus-gui.exe in it! That's it!

OSX

(Assuming you have Python 3.7 available via Macports)

• Get to the point of having horus-gui running from the terminal, by following the instructions on the main README.md
• Note that you need to have horusdemodlib in a directory up from horus-gui (e.g. ../horusdemodlib/ exists, and is built. In particular, we need ../horusdemodlib/build/src/libhorus.dylib)
• pip install pyinstaller
• pyinstaller horus-gui_osx.spec

Then, you will need to edit the Info.plist file within the generated appbundle, and add into the <dict> section:

	<key>NSMicrophoneUsageDescription</key>
	<string>Horus-GUI needs audio access to receive telemetry.</string>