Skip to content

Installation

The precompiled binary isn't working

  1. Note that it can take ~1 min for it to start.
  2. The OccuPy GUI may be recognized as coming from an untrusted or "unidentified developer", and produce a warning message the first time you run the program. You may need to choose to "keep", "trust" or otherwise confirm that it is ok to run it.
  3. If the above doesn’t work, and the binary is recognized as a vrius or security threat, you can either make an exception for it in your virus software or contact one of the OccuPy developers to resolve the issue.
  4. If the program appears unresponsive, you can try to run it from a terminal. Use the file browser to find occupy_gui.exe (probably in the Downloads folder), then start a terminal as described here . In the terminal, type ./occupy_gui.exe. The program should start, or at least provide some information about what isn't working.
  5. If you still have not been able to resolve the issue, please look through existing issues, and submit a new issue/question if you still can't make it work.
  1. Note that it can take ~1 min for it to start.
  2. The OccuPy GUI may be recognized as coming from an untrusted or "unidentified developer", and produce a warning message the first time you run the program. This requires administrator privileges.
  3. If doulbe-clicking the binary does not open the GUI, right-click on the OccuPy GUI binary file and select "Open", and then click the "Open" button in the window that appears.
  4. If it opens as a text file, you will need to mark the file as an executable. Unfortunately, you need to do this in a terminal as described here. The file icon should now appear to be a small terminal window. Double-clicking the file should open the OccuPy GUI.
  5. If the above doesn’t work, you can run the binary from the terminal, which may provide some more info. Open a terminal in the folder where the OccuPy GUI binary is located, and run it by typing ./occupy_gui
  6. If you still have not been able to resolve the issue, please look through existing issues, and submit a new issue/question if you still can't make it work.
  1. Note that it can take ~1 min for it to start.
  2. If you get a messsage saying "Could not display occupy_gui, thereis no application installed for executable files", then you may need to alter the "permissions". Click "OK", then right-click the binary and select "Properties". Under "Permissions", make sure "Allow to execute file as program" is checked. Alternatively, you can use a terminal to change the permisssions by typing chmod a+x occupy_gui.
  3. If the above doesn’t work, you can run the binary from the command line, which may provide some more info. Open a terminal in the folder where the OccuPy GUI binary is located, and run it by typing ./occupy_gui
  4. If you still have not been able to resolve the issue, please look through existing issues, and submit a new issue/question if you still can't make it work.

The GUI windows looks too big/small/...

On some (e.g. 4K) screens, the high resolution causes graphical elements to be re-scaled. OccuPy knows about this and does its best to get it right, but we have not been able to test on a wide range of screen sizes and resolutions.

Report any issues

If your GUI does not look like the image in the "GUI overview" tutorial, please report this to the developers so that we can make sure that it doesn't happen in the future.

I'd like to install with pip but I don't know how

To help us make the installation instructions better and help you use python and pip, you can request help here. Please try to complete the installation by the instructions provided in the install section first, and see if the below can resolve any issues.

I installed through pip but OccuPy isn't found

Let's first confirm that it was in fact installed.

  1. In the main menu search bar, type "powershell", and open a text-based interface to your system.
  2. Type py -m pip show occupy and hit enter. If you see details regarding occupy, then we're good. If not, try writing out "python" instan of just "py": python -m pip show occupy.
  3. If you still don't see details like version and location, then occupy probably wasn't installed properly. You need to try to install it according to the install procedures, and ask for help if you still can't make it work.

Open a terminal and type pip show occupy, and hit enter. If you don't see details like version and location, then occupy probably wasn't installed properly. If you used a virtual environment when installing, make sure to activate it like you did before, and try again.

Open a terminal and type pip show occupy, and hit enter. If you don't see details like version and location, then occupy probably wasn't installed properly. If you used a virtual environment when installing, make sure to activate it like you did before, and try again.

If OccuPy you managed to confirm that OccuPy was installed, Pip may have installed OccuPy in a location that is not universally known to your system. You can either tell your system where to look when searching for installed applications, or create a shortcut to it that you can find easily. In either case, we need to find where occupy was installed.

  1. In a powershell like you just used to verify the install, type Get-ChildItem $($ENV:userprofile) -force -Recurse -ErrorAction SilentlyContinue occupy_gui.exe Note the reported directory.

  2. Open a file browser and enable hidden files under "view".

  3. Browse to the directory where occupy_gui.exe was found.

  4. Option 1: Create a shortcut. Right-click occupy_gui.exe and click "create shortcut". Move the new shortcut to e.g. the desktop.

  5. Option 2: Make sure the occupy directory is included in the paths where the system looks for programs. Edit the system and/or user environment variable "Path" by adding the directory from step 2, e.g. C:\Users\IEUser\AppData\Local\Programs\Python\Python310\Scripts

  1. In a terminal where pip is avaialble, call pip show occupy. The reported location is a good indication of where occupy was installed. If the locaton is /home/bjornf/.local/lib/python3.8/site-packages, then the location of the program is likely /home/bjornf/.local/bin

  2. To add the path of the program permanently, open the startup list of environment variables. On Ubuntu this is likely /etc/environment. You will need root access for this.

  3. The PATH variable is a colon-separated list. Add the occupy_gui path as new entry in this list.

  4. If you do mot have the access rights to to this system-wide, you can add the following to your session startup file: export PATH=$PATH:</path/to/occupy/program>

  1. In a terminal where pip is avaialble, call pip show occupy. The reported location is a good indication of where occupy was installed. If the locaton is /home/bjornf/.local/lib/python3.8/site-packages, then the location of the program is likely /home/bjornf/.local/bin

  2. To add the path of the program permanently, open the startup list of environment variables. On Ubuntu this is likely /etc/environment. You will need root access for this.

  3. The PATH variable is a colon-separated list. Add the occupy_gui path as new entry in this list.

  4. If you do mot have the access rights to to this system-wide, you can add the following to your session startup file: export PATH=$PATH:</path/to/occupy/program>