# Interceptor-APS

**Interceptor, the State of the Art APS (Active Protection System)**
<small>Version Alpha-3, Patch i</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 automated derivation of the surveillance detection software, first created by OctolinkYT.

*(All code original. A small amounts of concepts might come from OctolinkYT, namely using watchdog and associating file changes with active monitoring. ONLY TESTED ON NHRHS SCHOOL COMPUTERS, TESTED EFFECTIVE THROUGHOUT JANURARY 2026. NOT GUARANTEED TO WORK ELSEWHERE OR IN THE FUTURE.)*

<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 prompt you to select a cover option. 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 <b>IDLE (Python 3.13)</b>, or running from the terminal by navigating to the directory and running:

`python interceptor-aps.py`

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

```
# ---------- Monitor Path ---------- #
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` or any other folder in the case it had been modified.

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

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

[x] Help (w/notes)
[y] Toggle test mode

[c] Exit
Enter your option >
```

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


If you used help:

```
Help Section
- (Note 1): Opens a new, empty window of this program
- (Note 2): Opens the window. You have to open the application first and set it up to the desired state to have it work.
- (Note 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.
- (Note 4): Enter a path to the program. This only opens the program and requires you to do research on the program behavior when opened.
- (Note 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. You must only have one Chrome window open, or the selector might not select the correct window.
- (Note 6): Specifies a window name. Partial names (wildcards) are default.
```

<h3>Known Errors</h3>

I have finished this, and everything should work. But ther might be errors, and known errors include:

<b>Monitoring without paramters</b>: It is possible to do this. You can enter empty inputs for paths and window names.

<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.

If you encounter more problems, create an Issue on this repo.