p7mj/Interceptor-APS
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source 
Accommodating for A-3
This commit is contained in:
P7MJ
2026-02-06 20:00:41 -05:00
parent b8487a0bc4
commit 23cc385fba
1 changed files with 23 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
README.md
View File

@@ -1,24 +1,24 @@
# Interceptor-APS
**Interceptor, the State of the Art APS (Active Protection System)**
<small>Version A-2</small>
<small>Version A-3</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.
Interceptor APS by P7MJ is the automated derivation of the surveillance detection 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.)*
*(All code original. A small amounts of concepts might come from OctolinkYT, namely using watchdog and associating file changes with active monitoring. None original work were used. 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 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.
**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 **IDLE (Python 3.13)**, or running from the terminal by navigating to the directory and running:
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`
@@ -30,28 +30,29 @@ At the start of the code, there is this config section:
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`.
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) ===== TESTMODE: False
Interceptor APS (Active Protection System) Alpha-3| 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)
[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
[y] Set test mode
[x] Help (w/notes)
[y] Toggle test mode
Enter your option >
[c] Exit
Enter your option >
```
Enter an option to begin, add more parameters if prompted, and enjoy your peace.
@@ -63,19 +64,19 @@ 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.
- (4): Enter a path to the program. This only opens the program and requires you to do research on the program behavior when opened.
- (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:
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. Additionally, after using the Help function and Set Test Mode, the program automatically starts monitoring without a specified cover window.
<b>Monitoring without paramters</b>: It is possible to do this. You can enter empty inputs for paths and window names.
<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.
If you encounter more problems, create an Issue on this repo.