# Interceptor-APS

**Interceptor, the State of the Art APS (Active Protection System)**
<small>Version A-2</small>

<p><b>I</b><small>nteraction-based</small> <b>N</b><small>ondominant</small> <b>T</b><small>erminal-</small><b>E</b><small>xecutable</small> <b>R</b><small>evertible</small> <b>C</b><small>entral</small> <b>E</b><small>lectronic</small> <b>P</b><small>ythonic</small> <b>T</b><small>echnological</small> <b>OR</b><small>ienter</small></p>

Interceptor APS by P7MJ is the newest derivation of the surveillance detections software, first created by OctolinkYT.

*(I did all of this myself, no code or and little concepts from his original work were used. ONLY TESTED ON NHRHS SCHOOL COMPUTERS IN JANURARY 2026. NOT GUARANTEED TO WORK ELSEWHERE.)*

<h2>Introduction</h2>

**Interceptor APS** is an APS (Active Protection System) designed to protect your computer from unwanted surveillance, especially from software like **Senso** (A common monitoring software found in schools and businesses). The program will allow you to select a window and start the counter-surveillance work. Once you are being watched, Interceptor will detect it. All windows will be minimized and your predetermined window will be brought to the front, all within 0.5 seconds and without human intervention.

<h2>Installation</h2>
To install, some python libraries are required. Ensure <b>Python 3.13</b> or above is installed, and run the following in your terminal or PowerShell:

`pip install watchfiles pygetwindow pyautogui termcolor`

Then, download the python file from above. You can choose to run it through double-clicking (assuming the settings are default and it opens in a python terminal window), running from a IDE or **IDLE (Python 3.13)**, or running from the terminal by navigating to the directory and running:

`python interceptor-aps.py`

<h2>Config</h2>
At the start of the code, there is this config section:

```
# ---------- CONFIGURATION ---------- #

monitor_path = r"C:\Program Files\Renato Software\Senso.Cloud.Client"    # Path to be monitored
```
You should not have to change the path, but if it is neccesary, redirect it to the Senso.Cloud.Client directory which should be located at `C:\Program Files\Renato Software\Senso.Cloud.Client`.

<h2>Usage</h2>
On launch, Interceptor will display this in the console:

```
================================================================================
Interceptor APS (Active Protection System) ===== TESTMODE: False
--------------------------------------------------------------------------------
Choose a cover app to open:
[1] Chrome (1)
[2] Edge (1)
[3] Adobe Illustrator (2)
[4] Onenote (3)
[5] Enter a path (4)
[6] Specify Chrome Tab Number (5)
[7] Specify Window Name (6)

[x] Help
[y] Set test mode

Enter your option > 
```

Enter an option to begin, add more parameters if prompted, and enjoy your peace.


If you used help:

```
- (1): Opens a new, empty window of this program
- (2): Opens the window. You have to open the application first and set it up to the desired state to have it work.
- (3): Opens an identical but new window of what you already have. The program can be closed, but you must set it up to the desired state before closing it.
- (4): Enter a path to the program. This only opens the program and requires you to do research on the program behavior when opened. I am still verifying if you need to enter "\\" for each \.
- (5): Opens the specified chrome tab. This method is newly developed and is a bit slower to respond, but can precisely open any tab in chrome.
- (6): Specifies a window name. Partial names (wildcards) are default.
```

<h3>Known Errors</h3>

I was unable to finish this, but I will. Known errors include:

<b>Monitoring without paramters</b>: It is possible to do this. Additionally, after using the Help function and Set Test Mode, the program automatically starts monitoring without a specified cover window.

<b>Test Mode</b>: This is intended to trigger the cover immediately for test purposes. The test mode toggle is broken and it does not work, so the program is locked in `testmode = false` now.

<b>Unable to detect large grid</b>: Unable to detect when teacher is looking at all of you. A known limitation for monitoring the Senso directory.

I am also in the progress of turning the `main()` function into a `while True:` loop. If you encounter more problems, create an Issue.