Installation¶
There are two ways to install STonitor, you can use the provided Installer for Windows, or you can install it manually. The Installer is not guaranteed to work, and may potentially cause a false-positive in your antivirus software. If you are concerned about this, you can install it manually.
Installer¶
As of version 2.2.0, STonitor has an installer for Windows. This is the easiest way to install STonitor, although less stable than the manual installation (if you know what you’re doing when performing the manual installation).
Downloading the Installer¶
Head over to the releases page and grab the latest version. This link also brings you there.
Once you’ve found a proper release, check the assets section near the bottom and download the Installer (
STonitor_Setup_X.X.X.exe
, the Xs are version numbers).
Running the Installer¶
Once you have the Installer downloaded, you’ll need to run it. In order to do this, head over to the location where you
downloaded the Installer, and double-click it. Windows SmartScreen may pop up, warning you about the Installer being
potentially unsafe, this is because the Installer is not signed. You can safely ignore this warning and continue with
the installation by clicking More info
, then Run Anyway
.
Continue through the installation process, and you should be good to go! Once the installation is complete, you can get started on the Setup.
Manual Installation¶
STonitor’s manual installation is neither streamlined or easy, depending on how experienced you are with things like this, things may go wrong (solutions to some common issues may be available in the FAQ). If you want something easy to install, you can use the Installer or check out Sonitor by MSWS.
Emphasis and warnings aside, the installation instructions below are fairly detailed, as long as you follow them, you should be fine. This installation process is also fairly standard, if you encounter an issue not covered in the FAQ, you’ll likely be able to find a solution fairly fast by Googling it.
Installing Python¶
STonitor is made using Python, and needs Python to run. If you’ve already installed a 3.X version, great, you can skip this part. If not, follow the steps below:
- Download a 3.X version of Python, to do so, head to Python’s official site. Don’t install the version on the Microsoft Store, that commonly causes odd problems.
Note
This program was developed on the 3.8.2 version, however the majority of modern v3.X versions should all work fine
- Run the installer (may differ depending on Operating System).
Attention
Be on the lookout for a checkbox labeled
Add to PATH
while installing, make sure that it’s checked or you’ll likely run into issues.
- Once the installation has been completed, test it. Open up a command prompt window and type
python --version
. If the version number you installed pops up, it’s installed properly, congrats!
If the command is unrecognized, make sure that it’s installed properly AND added to PATH.
If the version number is wrong, you may already have a version installed, as long as it’s 3.X, you can use it.
- Once the installation has been completed, test it. Open up a command prompt window and type
Downloading STonitor¶
Congrats on installing Python. The next part is fairly straightforward, download the most recent version of STonitor.
Head over to the releases page and grab the latest version. This link also brings you there.
Once you’ve found a proper release, check the assets section near the bottom and download the one labeled
Source code (zip)
.When the download has finished, extract the ZIP file to your location of choice. This is where the program will reside, so it’s recommended not to leave it in Downloads and rather someplace accessible and memorable.
Installing Requirements¶
That was easy, wasn’t it? This one’s slightly harder, but still not horrible. We’re going to be installing the packages (requirements) that are needed for STonitor to operate properly.
- Open up a command prompt window and navigate to the folder where you installed STonitor. There are multiple ways of doing this, here’s the most common two:
This is the fastest way. Open up Windows Explorer to where you extracted STonitor, then click the address bar (the thing at the top that shows where you are) and enter
cmd
then press enter. This will automatically open up command prompt to the proper locationThis is another slower way if the first one doesn’t work out. Press Windows + R, and enter
cmd
in the Run dialog. Press enter and it’ll open Command Prompt, after that, cd (change directory) to where you installed STonitor. To do so, entercd path/to/stonitor/here
, replacingpath/to/stonitor/here
with the path to STonitor’s install location
- Once you’ve opened up a command prompt window and properly navigated to STonitor’s install location (make sure you’re in the root folder, that’s the folder that has the file named
requirements.txt
), enter the following command:pip install -r requirements.txt
. You should see an output and multiple progress bars installing the packages. Tip
If it says command not found, first try to replace
pip
withpip3
. If it still doesn’t work, try to replace it withpython -m pip
. If it still doesn’t work, go back and make sure you installed Python properly.Tip
If it says that it couldn’t find
requirements.txt
, make sure you’re in the right folder
- Once you’ve opened up a command prompt window and properly navigated to STonitor’s install location (make sure you’re in the root folder, that’s the folder that has the file named
Make sure that everything has been properly installed (you should see
Successfully installed
then a lot of names)
Done¶
Congrats! You’ve finished the installation portion, now get started on the Setup.