Installation instructions and checksums for GuidScreener

Revised April 5th, 2017

Windows Installation

GuidScreener is supported on Windows operating systems Windows 7 or Windows Server 2008 R2 and later versions, and has been tested on Windows 7, Windows Server 2008 R2, and Windows 10.

GuidScreener is normally installed by running the installer "Install_GuidScreener32.exe", which may be packaged inside a zip file for distribution, i.e. "Install_GuidScreener32.zip". The 64 bit version is installed by "Install_GuidScreener64.exe", packaged as "Install_GuidScreener64.zip"

The 32 bit version will run on 32 bit and 64 bit Windows. The 64 bit version will run only on 64 bit Windows.

Run the installer normally (do not start it by running "as administrator"). Windows will display a User Account Control dialog to ask if you want to allow the program to make changes on your computer. You will need to allow this to get installation rights.

Assuming you click "Yes" to that, then the installer will show a Welcome page which recommends that you close all other applications, although this is not normally essential.

Clicking Next takes you to the Licence Agreement page. All licence details, including third-party licences, will be available in the installation directory after installation. After you click I Agree, the installer takes you to Installation Options. You can choose to install for all users (application will be available to all users who log on to the computer - this is the most common type of installation for the average Windows user), or for the current user only (application will be available only to the installing user).

Clicking Next takes you to the Install Location page, where you can modify the default installation location if required, although this should not normally be necessary.

Clicking Next takes you to the Start menu options page, where you can choose to add a Start menu shortcut or not - the selection is made by a checkbox, which is checked by default.

Clicking Install then starts the installation process. At the end of the installation log displayed on this page, you should see "Completed".

When installation is complete, clicking Next displays a page that is titled "Completing GuidScreener Setup". This includes a checkbox to run GuidScreener, which you can check if you want to run GuidScreener immediately, and a checkbox to create a desktop shortcut. If you don't want to have a shortcut on your desktop to launch GuidScreener, uncheck the "Create desktop shortcut" checkbox. You can then click Finish to close the installer. If you don't run GuidScreener from the installer, you can start it from the Start Menu, or the desktop shortcut if you created it.

Uninstallation

Close the app first if it is running, type 'remove' into the Start menu search box and select 'Change or remove a program', then uninstall GuidScreener from the list by right-clicking on it.

Checksums

Sha-256 checksums generated by the following command:

CertUtil -hashfile GuidScreener.exe SHA256

SHA256 hash of file GuidScreener.exe (32-bit 28 Mar 2017 build):

e3 ae 2f ef e9 d1 59 6a d0 41 9f d4 63 54 52 5c 9c 1f b8 76 4e 19 90 ea c3 d8 3d b5 55 39 88 5a

SHA256 hash of file GuidScreener.exe (64-bit 28 Mar 2017 build):

3a 44 9c b4 84 ed af 45 19 76 40 92 b2 0e ca 34 20 f2 b6 74 62 49 54 9c 88 8e 0f 16 31 2a f0 a5

Linux Installation

Download and/or copy the GuidScreener.tar.gz file to the installation location of your choice. You will need to have rw permissions for that directory.

Unpack the GuidScreener.tar.gz file either by:

Using the following command on Ubuntu, Linux Mint, or Fedora Gnome Terminal, or Debian Konsole:

tar xf GuidScreener.tar.gz

OR

Using the file manager included with your desktop, i.e. in Ubuntu or Fedora: Files, or Linux Mint: Nemo, right click on GuidScreener.tar.gz, then click on "Extract Here". In Debian Dolphin, right click on GuidScreener.tar.gz, then click on "Extract" > "Extract Archive Here".

You can then remove the GuidScreener.tar.gz file to save disk space, if you wish. Alternatively, you can leave the documentation in the GuidScreener.tar.gz file and only extract the GuidScreener executable.

You can now run Guidscreener directly from your installation location.

Note that to run GuidScreener on Fedora Workstation 25 and similar, you will need the libpng12.so.0 shared library. You can get it using the following command:

"sudo yum install libpng12"

Also on Fedora Workstation 25 the hex keypad dialog button labels don't show up (there are known button rendering problems on Fedora 25), but you can still use the equivalent keyboard keys to enter the digits via the keypad dialog.

To create desktop shortcuts in Linux:

Ubuntu 14.04.5 LTS (Trusty Tahr), Ubuntu 16.04.2 LTS (Xenial Xerus):

Holding down Shift+Ctrl, drag-and-drop the executable with the mouse from "Files" to the desktop to create a symbolic link.

Debian GNU/Linux 8.2 (jessie):

Holding down Shift+Ctrl, drag-and-drop the executable with the mouse from Dolphin file manager to the desktop to create a symbolic link.

Linux Mint 18.1 'Serena' Cinnamon:

Holding down Shift+Ctrl, drag-and-drop the executable with the mouse from Nemo file manager to the desktop to create a symbolic link.

Fedora Workstation 25:

When you log in, after selecting your user name, select the settings/gear icon next to "Sign In", and select "GNOME on Xorg", then finish logging in.

Issue the following "set" command in the Terminal:

gsettings set org.gnome.desktop.background show-desktop-icons true

After that, the following "get" command should report back "true":

gsettings get org.gnome.desktop.background show-desktop-icons

Now you can use Shift+Ctrl drag-and-drop on the executable from the file manager to the desktop to create a symbolic link.

Checksums

SHA-256 checksums generated by the following command on Ubuntu, Linux Mint or Fedora Gnome Terminal, or Debian Konsole:

sha256sum GuidScreener

SHA256 hash of file GuidScreener.tar.gz (installation package created 28 Mar 2017):

59062dc13979020fc881a0888c3110c9f32e4a3db2f0c96c8ec9c8c10fc01d1c

SHA256 hash of file GuidScreener (64-bit 27 Mar 2017 build):

657698d460213c97ea9c0644ba34adca3cb060a78c9662f47f0cb83226008010 GuidScreener

Note: Release available for 64 bit installations only.

Mac OS X Installation

Note: Before downloading in Safari, in order to check the checksum of the zip file, and perform any other screening tasks on the zip file that you wish, you must stop Safari automatically unzipping downloaded files as follows:

  • Open Safari, e.g. from the Safari icon in the Dock.
  • Click on the Preferences row of the Safari drop-down menu in your browser menu.
  • Under the General tab, uncheck the checkbox option 'Open "safe" files after downloading'.
  • Click on the red circle (x) at the top left-hand corner of the Preferences window.

Download the GuidScreener.zip file (typically it will end up in your Downloads folder). You will need to have rw permissions for that directory. Check the checksum of the file as described below, and if it matches, unzip the contents (right click in Finder and select "Open", or "Open With/Archive Utility"), which should extract a macOS Application Bundle (a folder structure following a standard Apple format) named GuidScreener.app (the .app extension may be hidden). You can move the Application Bundle to any suitable location, such as a folder in your user hierarchy or to the desktop.

When you run the app for the first time, macOS may display a dialog warning you: '"GuidScreener" is an application downloaded from the internet. Are you sure you want to open it?' If you wish to continue to run the app, click the 'Open' button (macOS should remember this choice and not show the dialog in future).

Checksums

The SHA-1 checksum is generated by the following terminal command on macOS X El Capitan or Sierra:

$ shasum <path to file>

OR:

$ openssl sha1 <path to file>

You don't have to enter <path to file> manually, simply enter "shasum " or "openssl sha1 ", making sure there is a space at the end, drag the GuidScreener.zip file from Finder to the Terminal, click on the Terminal window to ensure it has the keyboard focus, then hit the "Return/Enter" key in Terminal.

SHA1 hash of Zipped Application Bundle GuidScreener.app (64-bit 3rd April 2017 build, packaged 4th April):

SHA1(GuidScreener.zip)= 97b5c0d1f000105d1b659ba6eead669adbcdf81f

To uninstall, ensure the app isn't running, right-click on the Application Bundle, and select "Move to Trash".

Note: Release available for 64 bit installations only.

If you have problems getting the app to run, have a look at the following links:

  1. How to install and run Mac apps that don't come from the Mac App Store
  2. macOS Sierra: Open an app from an unidentified developer
  3. How to run apps that are not from the App Store in macOS Sierra Public Beta
  4. Why the Mac App Store Doesn’t Have the Applications You Want