Installation

Download and install GoLogo on Windows, Linux and macOS.

GoLogo ships as ready-to-use binaries for Windows, Linux and macOS. They are available from the Releases section of the GitHub repository. Pick the file that matches your system, then follow the steps below.

Unsigned binaries. On Windows and macOS the executables are not digitally signed. The first time you run the program, your operating system may show a security warning : this is normal. How to handle it is explained below, under Security warnings.

Windows

A standard installer is provided.

  1. From the Releases page, download the Windows installer (GoLogo-Setup-x.x.exe).
  2. Double-click it and follow the wizard (install folder, optional desktop shortcut).
  3. GoLogo then appears in the Start menu. The example programs are installed next to the executable.

On the very first launch, see the Windows SmartScreen note below.

Linux (Debian / Ubuntu)

A .deb package is provided for Debian-based distributions (Debian, Ubuntu, Linux Mint...), 64-bit architecture (amd64).

  1. From the Releases page, download the package (gologo_x.x_amd64.deb).
  2. Install it with apt, which handles dependencies automatically : 
    sudo apt install ./gologo_x.x_amd64.deb
  3. Run gologo from a terminal or from the applications menu. The example programs are installed in /usr/share/doc/gologo/examples.

The Linux package is not affected by the signing warnings : it installs normally.

macOS (Apple Silicon)

Apple Silicon only. The macOS build runs only on Apple Silicon Macs (M1 and later : M1, M2, M3...). Intel-based Macs are not supported.
  1. From the Releases page, download the macOS archive and unzip it.
  2. Drag GoLogo.app into your Applications folder.
  3. On the first launch, see the macOS Gatekeeper note below.

Security warnings

GoLogo is free software. The executables are not digitally signed (code signing certificates are expensive and not justified for a free application). Because of this, your operating system may display a security warning the first time you run the program. This is normal and expected : here is how to handle it on each platform.

Windows

When you run GoLogo for the first time, Windows SmartScreen may show a blue warning window saying “Windows protected your PC”.

  1. Click More info (the link below the warning text).
  2. Click Run anyway.

This warning only appears once. After that, Windows remembers your choice and won't ask again.

macOS

macOS Gatekeeper blocks applications from unidentified developers by default. When you try to open GoLogo for the first time, you will see a message saying the app “can't be opened because it is from an unidentified developer” (or “Apple cannot check it for malicious software”).

  1. Close the warning dialog.
  2. Open System Settings (Apple menu > System Settings).
  3. Go to Privacy & Security.
  4. Scroll down : you will see a message saying GoLogo was blocked. Click Open Anyway.
  5. Enter your password or use Touch ID to confirm.
  6. A new dialog appears : click Open.

This authorization only needs to be done once. After that, macOS lets you open GoLogo normally.