Skip to content

INSTALL.md

Latest commit

 

History

History
216 lines (146 loc) · 4.94 KB

INSTALL.md

File metadata and controls

216 lines (146 loc) · 4.94 KB

UNIWA

UNIVERSITY OF WEST ATTICA
SCHOOL OF ENGINEERING
DEPARTMENT OF COMPUTER ENGINEERING AND INFORMATICS

University of West Attica · Department of Computer Engineering and Informatics

Human-Computer Interaction

Virtual Gym

Vasileios Evangelos Athanasiou
Student ID: 19390005

GitHub · LinkedIn

Viktor Romanyuk
Student ID: 713242017024

GitHub · LinkedIn

Panagiotis Petropoulos
Student ID: 20390188

GitHub

Georgios Theocharis
Student ID: 19390283

GitHub

Supervision

Supervisor: Christos Troussas, Assistant Professor

UNIWA Profile · LinkedIn

Co-Supervisor: Panagiotis Strousopoulos, Postdoctoral Researcher

UNIWA Profile

Athens, July 2024

INSTALL

Virtual Gym

This guide explains how to install, configure, and run the Virtual Gym project.
The application is developed with Unity and does NOT require WebGL.
A pre-built Windows executable (.exe) is already included in the repository.

1. Prerequisites

1.1 Operating System

  • Windows 10 / Windows 11 (required for running the .exe build)

1.2 Software

If you only want to run the application, no additional software is required.
If you want to open or modify the project, you will need:

1.2.1 Unity Hub

1.2.2 Unity Editor

  • Install the exact Unity version defined in: ProjectSettings/ProjectVersion.txt

Do not upgrade the Unity version unless explicitly required.

2. Steps to Run from Source

A ready-to-run executable is already provided.

2.1 Clone or Download the Repository

git clone https://github.com/Human-Computer-Interaction/Virtual-Gym.git

or download the ZIP and extract it.

2.2 Run the Executable

Navigate to the build/ directory

Locate the application file:

VirtualGym.exe

Double-click the .exe file to launch the application

No Unity installation is required to run the executable

2.2.1 Or

  1. Add Project
    Open Unity Hub and select Add, then choose the Virtual-Gym project folder.

  2. Build Application

    • Open the project in the Unity Editor.
    • Press Ctrl + Shift + B to open Build Settings.
    • Press Ctrl + B to build and run the executable.

  3. Launch
    Navigate to the generated Build folder and run VirtualGym.exe.

3. Development Setup

Only follow this section if you want to edit, inspect, or extend the project.

3.1 Open Project in Unity

  1. Launch Unity Hub
  2. Click Add → Add project from disk
  3. Select the Virtual-Gym project folder
  4. Open the project using the specified Unity version

3.2 Run Inside Unity Editor

  1. Open the main scene (usually located in Assets/Scenes/)
  2. Press the ▶ Play button
  3. Interact with the Virtual Gym environment

4. Building the Project (Optional)

To rebuild the executable:

  1. File → Build Settings
  2. Platform: PC, Mac & Linux Standalone
  3. Target Platform: Windows
  4. Architecture: x86_64
  5. Click Build

The output will generate a new .exe inside a selected folder.

5. Open the Manuals

  1. Navigate to the docs/ directory
  2. Open the report corresponding to your preferred language:
    • English: User-Manual.pdf, Technical-Manual.pdf
    • Greek: Εγχειρίδιο-Χρήστη.pdf, Τεχνικό-Εγχειρίδιο.pdf