Scope Visual Object Tracking Software /Download

🚨First Release Published ! See how to try it below.

The software is under active development. New releases are published frequently, so check for updates regularly (at the top of this website or directly on the GitHub Releases page).

Windows version and all-in-one executable files are under development (Only works on Linux).

For now, you need to go by the following instructions to run the Program using the Terminal. You can also install a development environment like Visual Studio Code wich can be easier to use (download the .deb file on the VS Code Website and run "sudo apt install [path_of_the_downloaded_file].deb" in your Terminal, snap installation will not work).

Note: This tutorial is made for Ubuntu. It should work for Debian too, but I don't know for other Linux distribution.

GitHub Preview

If you want, you can see the code without downloading it with the link above (Source Code).

How to Install

Note: If you already have the software, installing a new release will overwrite your actual one. If you want to keep it, rename the parent folder (the "S-V-O-T" on your desktop).

• Downloading the Release

Go to the GitHub Release Page of the software and look for a release you want to install. Before downloading, read the description of the release to check OS and hardware compatibility. For each version, you can choose between "Software only", "Demo only", or the "Full" package (See Program Explanation below). If it's compatible, you can download the version you want.

• Preparing the Computer

Open a new Linux Terminal. Install / Update Python dependencies and give the program access to the USB ports with the following command (click to copy) and then restart your computer (or log out and back in) to apply:

sudo apt update && sudo apt install -y python3.12-venv python3-pip && sudo usermod -a -G dialout $USER

Note: You may have to enter your password.

• Installing the Software

Then, enter this command to install the code (click to copy):

unzip -o ~/Downloads/S-V-O-T_v*.zip -d ~/Desktop && mv ~/Desktop/S-V-O-T_v*/S-V-O-T ~/Desktop/ && rm -rf ~/Desktop/S-V-O-T_v* && rm ~/Downloads/S-V-O-T_v*.zip && cd ~/Desktop/S-V-O-T && python3 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt

If you have installed VS Code:

Enter "code ." in the Terminal to open the folder in VS Code.

Running a Program

Note: Before running a program, ensure the Virtual Environment is active with this command (click to copy):

You need to enter it in the Linux or the VS Code terminal each time you close it. You should see "(.venv)" at the start of the command line.

If you have installed VS Code:

Open VS Code, expand the "/src" folder, click on the "__main__.py" and run it (arrow at the top) to launch the software or try the demo programs in the "/demo" folder (see Program Explanation below).

To run a Program, enter "python3 [path_of_the_program].py".

Example: "python3 src/__main__.py" (see Program Explanation below).

Program Explanation

Note: Depending of the release and version you picked, you may not have all the folders and files.

When you enter the S-V-O-T folder (or open it in VS Code), you will see different folders: "/.venv", "/data", "/demo", "/src" and "/tests" (this one doesn't matter). You should also have three files: ".gitignore", "README.md" and "requirements.txt".

The only things that you will use are the "/demo" and "/src" folders:

• /demo

• /Dependencies: Dependencies Programs for the communication with the scope or the camera. You don't need to touch it.
• Com-Scope-Demo.py: Program to test the communication with the scope. You need to connect it. You don't need your camera.
• Img-Analyzing-Demo.py: Program to show the functioning of the image's analyzing. You don't need your camera or your scope.
• Program-No-Scope-Demo.py: Demo of the software without neither the camera nor the scope.
• Program-w-Scope-Demo: Demo of the software with the scope (pre-recorded video). You don't need your camera.

• /src

• /Dependencies: Dependencies Programs for the communication with the scope or the camera. You don't need to touch it.
• __main.py__: Main program, that's the one that starts the software.