Repository navigation
Expand file tree
/
Copy pathWindowGuard_Help.html
More file actions
317 lines (315 loc) · 15 KB
/
Copy pathWindowGuard_Help.html
File metadata and controls
317 lines (315 loc) · 15 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
<!DOCTYPE html>
<!DOCTYPE html>
<html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta charset="utf-8"/>
<meta content="pandoc" name="generator"/>
<meta content="width=device-width, initial-scale=1.0, user-scalable=yes" name="viewport"/>
<title>Window Guard - User Guide</title>
<style>
:root{--ink:#202936;--muted:#596575;--line:#dce4eb;--blue:#145d8f}
*{box-sizing:border-box}html{scroll-behavior:smooth}
body{background:#f3f6f9;color:var(--ink);font-family:Segoe UI,Arial,sans-serif;font-size:14px;line-height:1.65;margin:0}
main{max-width:920px;margin:32px auto;background:#fff;border-radius:10px;padding:40px 54px 58px;box-shadow:0 6px 20px rgba(0,0,0,.06)}
h1{font-size:2.2rem;margin:.2em 0 .1em}h2{font-size:1.45rem;border-bottom:1px solid var(--line);padding-bottom:5px;margin-top:2em;page-break-after:avoid}h3{margin-top:1.5em}
a{color:var(--blue)}p,li{overflow-wrap:break-word}ul,ol{padding-left:24px}
nav#TOC{background:#eef4f8;border:1px solid #dce8f0;border-radius:8px;padding:14px 22px;margin:26px 0}
nav#TOC > ul{columns:2;margin:5px 0 0;padding-left:18px} nav#TOC ul ul{columns:1}
nav#TOC li{margin:2px 0;break-inside:avoid}
blockquote{background:#fff4df;border-left:4px solid #ca963c;margin:20px 0;padding:9px 16px}
blockquote p{margin:3px 0}code{font-family:Consolas,"Courier New",monospace;background:#eef1f4;padding:1px 4px;border-radius:3px}
pre{background:#f1f4f6;border:1px solid #d9e0e6;padding:10px 14px;border-radius:6px;overflow-wrap:anywhere;white-space:pre-wrap}
pre code{padding:0;background:none;white-space:pre-wrap}
table{border-collapse:collapse;width:100%;margin:15px 0 22px;font-size:.94em}
th,td{border:1px solid var(--line);padding:8px 10px;text-align:left;vertical-align:top}th{background:#edf3f7}hr{border:0;border-top:1px solid var(--line);margin:26px 0}
@media(max-width:700px){main{margin:0;border-radius:0;padding:26px 20px}nav#TOC ul{columns:1}}
@page{size:A4;margin:17mm 17mm 18mm;@bottom-right{content:"Window Guard 0.6.0 • " counter(page);font-size:8px;color:#687282}}
@media print{body{width:100%;max-width:none;padding:0;background:white;font-size:10pt;line-height:1.48}main{max-width:none;margin:0;padding:0;box-shadow:none;border-radius:0}nav#TOC{padding:10px 18px}nav#TOC > ul{columns:2}nav#TOC ul ul{columns:1}nav#TOC a{color:#202936;text-decoration:none}pre{font-size:8.5pt}table{font-size:9pt}thead{display:table-header-group}tr{break-inside:avoid}h1{font-size:24pt}h2{font-size:15pt;margin-top:20pt}h3{font-size:12pt}}
</style></head>
<body><main>
<h1 id="window-guard-user-guide">Window Guard User Guide</h1>
<p><strong>Version 0.6.0</strong><br/>
<strong>Giorgos Xanthopoulos aka gexos</strong></p><nav id="TOC" role="doc-toc">
<ul>
<li><a href="#window-guard-user-guide" id="toc-window-guard-user-guide">Window Guard User Guide</a>
<ul>
<li><a href="#what-you-need" id="toc-what-you-need">1. What you
need</a></li>
<li><a href="#start-window-guard" id="toc-start-window-guard">2. Start
Window Guard</a></li>
<li><a href="#add-a-program" id="toc-add-a-program">3. Add a
program</a></li>
<li><a href="#set-or-change-the-pin" id="toc-set-or-change-the-pin">4.
Set or change the PIN</a></li>
<li><a href="#lock-and-unlock-apps" id="toc-lock-and-unlock-apps">5.
Lock and unlock apps</a></li>
<li><a href="#what-the-app-remembers" id="toc-what-the-app-remembers">6.
What the app remembers</a></li>
<li><a href="#system-tray-and-windows-startup" id="toc-system-tray-and-windows-startup">7. System tray and Windows
startup</a></li>
<li><a href="#settings" id="toc-settings">8. Settings</a></li>
<li><a href="#keyboard-shortcut" id="toc-keyboard-shortcut">9. Keyboard
shortcut</a></li>
<li><a href="#menus" id="toc-menus">10. Menus</a></li>
<li><a href="#diagnostics" id="toc-diagnostics">11. Diagnostics</a></li>
<li><a href="#build-a-portable-exe" id="toc-build-a-portable-exe">12.
Build a portable EXE</a></li>
<li><a href="#troubleshooting" id="toc-troubleshooting">13.
Troubleshooting</a></li>
<li><a href="#forgotten-pin" id="toc-forgotten-pin">14. Forgotten
PIN</a></li>
<li><a href="#security-limits" id="toc-security-limits">15. Security
limits</a></li>
<li><a href="#github-and-source-code" id="toc-github-and-source-code">16. GitHub and source code</a></li>
</ul></li>
</ul>
</nav>
<p>Window Guard is a small Windows program that hides selected
application windows until you unlock them with a PIN. It remembers which
apps are protected and relocks them when they close.</p>
<blockquote>
<p><strong>Important:</strong> This is a privacy tool, not a Windows
security feature. A user who can end the Window Guard process or modify
its files can bypass it. Windows may also show a protected window
briefly before Window Guard hides it.</p>
</blockquote>
<h2 id="what-you-need">1. What you need</h2>
<ul>
<li>Windows 10 or 11.</li>
<li>For the standalone EXE: no Python installation is needed.</li>
<li>For the source version: Python 3.10 or newer, <code>pystray</code>
and <code>Pillow</code>.</li>
</ul>
<p>Install source dependencies with:</p>
<div class="sourceCode" id="cb1"><pre class="sourceCode bat"><code class="sourceCode dosbat"><span id="cb1-1"><a aria-hidden="true" href="#cb1-1" tabindex="-1"></a>python <span class="at">-m</span> pip install <span class="at">-r</span> requirements.txt</span></code></pre></div>
<h2 id="start-window-guard">2. Start Window Guard</h2>
<p>If you’re using the compiled version, run
<code>WindowGuard.exe</code>. If you’re using the source, run
<code>run_window_guard.bat</code>, or:</p>
<div class="sourceCode" id="cb2"><pre class="sourceCode bat"><code class="sourceCode dosbat"><span id="cb2-1"><a aria-hidden="true" href="#cb2-1" tabindex="-1"></a>python window_guard.py</span></code></pre></div>
<p>The main window shows your protected programs and their current
<strong>Locked / Unlocked</strong> and <strong>Running / Not
running</strong> states.</p>
<h2 id="add-a-program">3. Add a program</h2>
<ol type="1">
<li>Open the Windows program you want to protect.</li>
<li>In Window Guard, choose <strong>Add Running App</strong>.</li>
<li>Find the window you want in the list and check its executable name
and path.</li>
<li>Choose <strong>Add Selected App</strong>.</li>
</ol>
<p>You can use <strong>Browse EXE</strong> instead, but selecting a
running window is usually more reliable.</p>
<p><strong>Firefox Portable:</strong> select the
<code>firefox.exe</code> process that owns the browser window. The
<code>FirefoxPortable.exe</code> launcher is not usually the right
one.</p>
<p>If an app is not listed, open <strong>Tools → Diagnostics</strong>
and check which process owns the visible window. Some elevated programs
may require Window Guard to run with the same privileges.</p>
<h2 id="set-or-change-the-pin">4. Set or change the PIN</h2>
<p>Open <strong>Tools → Set / Change PIN</strong>. Enter a PIN of
<strong>4 to 12 digits</strong>, then confirm it. To change an existing
PIN, enter the current one first.</p>
<p>The PIN is stored as a salted PBKDF2 hash, not as readable text. If
you forget it, see the recovery section below.</p>
<h2 id="lock-and-unlock-apps">5. Lock and unlock apps</h2>
<p>Protected apps start out <strong>Locked</strong>. When Window Guard
detects a window belonging to a locked app, it hides that window and
displays a PIN prompt. Enter the correct PIN to restore the window.</p>
<p>Each application is handled separately. If Firefox is unlocked,
Notepad++ can still be locked.</p>
<p>To lock apps manually:</p>
<ul>
<li>Select an app, then choose <strong>Lock Selected App</strong>.</li>
<li>Use <strong>File → Lock All Now</strong>, the tray menu, or the
optional keyboard shortcut to lock them all.</li>
</ul>
<p>After you close an unlocked program <strong>completely</strong>,
Window Guard returns it to <strong>Locked</strong>. Opening it again
requires the PIN. Simply closing one window may not be enough if the
program keeps background processes running.</p>
<h2 id="what-the-app-remembers">6. What the app remembers</h2>
<p>The protected-app list stays saved when apps close or Windows
restarts. Apps start <strong>Locked</strong> when Window Guard starts;
an unlocked state is only for the current running session.</p>
<p>Window Guard saves the list and settings here:</p>
<pre class="text"><code>%APPDATA%\WindowGuard\config.json</code></pre>
<p>Don’t share this file. It may contain application paths and PIN
verification data.</p>
<h2 id="system-tray-and-windows-startup">7. System tray and Windows
startup</h2>
<p>If <strong>Close main window to system tray</strong> is enabled,
clicking the main window’s <strong>X</strong> hides it instead of
exiting. Right-click the tray icon for options such as <strong>Show
Window Guard</strong>, <strong>Lock All Now</strong> and
<strong>Exit</strong>.</p>
<p>Open <strong>Tools → Settings</strong> to enable <strong>Start with
Windows</strong>. When you move the EXE to a new folder, turn this
setting off and back on so Windows uses its new path.</p>
<p>To keep the main window hidden when Windows starts, enable
<strong>Start hidden when launched by Windows startup</strong>.</p>
<h2 id="settings">8. Settings</h2>
<p>Open <strong>Tools → Settings</strong>, make your changes and click
<strong>Save</strong>.</p>
<table>
<colgroup>
<col style="width: 50%"/>
<col style="width: 50%"/>
</colgroup>
<thead>
<tr class="header">
<th>Setting</th>
<th>What it changes</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td>Start with Windows</td>
<td>Creates or removes a startup entry for your Windows account.</td>
</tr>
<tr class="even">
<td>Close to tray</td>
<td>Hides the main window when you click X. When disabled, X exits.</td>
</tr>
<tr class="odd">
<td>Start hidden at Windows startup</td>
<td>Starts Window Guard without showing its main window.</td>
</tr>
<tr class="even">
<td>Confirm removal</td>
<td>Asks before an app is removed from the protected list.</td>
</tr>
<tr class="odd">
<td>Global shortcut</td>
<td>Enables or disables <strong>Ctrl+Shift+L</strong> for Lock All.</td>
</tr>
<tr class="even">
<td>Monitoring interval</td>
<td>Checks for protected app windows every <strong>250, 350, 500 or 1000
ms</strong>. Default: <strong>350 ms</strong>.</td>
</tr>
</tbody>
</table>
<p>Auto-relocking after an app fully closes remains enabled.</p>
<h2 id="keyboard-shortcut">9. Keyboard shortcut</h2>
<p>Enable <strong>Ctrl+Shift+L</strong> in Settings if you want to lock
apps without opening the Window Guard window. It’s disabled by
default.</p>
<p>If another program already uses that shortcut, Window Guard can’t
register it. Use the tray menu or <strong>File → Lock All Now</strong>
instead.</p>
<h2 id="menus">10. Menus</h2>
<table>
<colgroup>
<col style="width: 50%"/>
<col style="width: 50%"/>
</colgroup>
<thead>
<tr class="header">
<th>Menu</th>
<th>Main commands</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td>File</td>
<td>Lock All Now, hide to tray, exit</td>
</tr>
<tr class="even">
<td>Applications</td>
<td>Add Running App, Browse EXE, Lock Selected App, Remove Selected</td>
</tr>
<tr class="odd">
<td>Tools</td>
<td>Set/Change PIN, Settings, Diagnostics, Export Diagnostics, open
folders</td>
</tr>
<tr class="even">
<td>GitHub</td>
<td>Open repository, Issues, Releases, Check for Updates</td>
</tr>
<tr class="odd">
<td>Help</td>
<td>HTML Help, PDF manual, About</td>
</tr>
</tbody>
</table>
<p><strong>GitHub → Check for Updates</strong> opens the project’s
Releases page in your browser. It doesn’t download or install
anything.</p>
<h2 id="diagnostics">11. Diagnostics</h2>
<p>If app detection doesn’t work, open <strong>Tools →
Diagnostics</strong>. It lists process names, IDs and visible window
titles. Use <strong>Export Diagnostics</strong> to save the report as
text.</p>
<p><strong>Check the file before sharing it.</strong> Window titles and
executable paths can contain your username, document names or other
private information.</p>
<h2 id="build-a-portable-exe">12. Build a portable EXE</h2>
<p>Run <code>build_window_guard.bat</code> on Windows. It installs the
build dependencies, runs PyInstaller and copies the manuals into
<code>dist</code>.</p>
<pre class="text"><code>dist/
WindowGuard.exe
WindowGuard_Help.html
WindowGuard_Help.pdf
README.md
LICENSE</code></pre>
<p>The <code>.ico</code> and <code>.png</code> icon files are bundled in
the executable. The HTML and PDF manuals must stay beside the EXE for
the Help menu to find them.</p>
<p>To generate a SHA-256 checksum for the EXE, run <code>hash_release.bat</code>.</p>
<h2 id="troubleshooting">13. Troubleshooting</h2>
<p><strong>A protected program does not appear in the app
picker.</strong> Make sure it has a visible window, then refresh the
running-app list. Try Diagnostics. For portable applications, select the
actual process rather than its launcher.</p>
<p><strong>A program isn’t hidden.</strong> Confirm its executable in
Diagnostics. If it runs as administrator, Window Guard may need the same
permission level.</p>
<p><strong>The PIN dialog isn’t showing.</strong> Check whether Window
Guard is running in the tray. Confirm you’ve set a PIN. If the app is
still running and was already unlocked, close its processes completely
before testing relock-on-close.</p>
<p><strong>A program’s window flashes before hiding.</strong> That can
happen. Window Guard checks windows periodically; it does not block the
process from launching.</p>
<p><strong>The tray icon isn’t visible.</strong> Look in the
notification-area overflow. If running from source, check that
<code>pystray</code> and <code>Pillow</code> are installed.</p>
<p><strong>Help doesn’t open.</strong> Keep
<code>WindowGuard_Help.html</code> and <code>WindowGuard_Help.pdf</code>
next to <code>WindowGuard.exe</code>.</p>
<p><strong>Start with Windows stopped working after moving the
EXE.</strong> Disable and enable the setting again to update the saved
path.</p>
<h2 id="forgotten-pin">14. Forgotten PIN</h2>
<p>There’s no PIN recovery because the original PIN isn’t stored. To
reset the app, close Window Guard and remove:</p>
<pre class="text"><code>%APPDATA%\WindowGuard\config.json</code></pre>
<p>This also removes the protected-app list and saved settings. Make a
copy of the file first if you need to preserve your configuration for
troubleshooting.</p>
<h2 id="security-limits">15. Security limits</h2>
<p>Window Guard hides windows. It does <strong>not</strong> prevent
someone with enough Windows access from ending the program, changing its
configuration or using other tools to open an app. It also cannot
guarantee that a newly launched protected window is never briefly
visible.</p>
<p>For locking the whole computer, use your Windows login and
<strong>Windows + L</strong>.</p>
<p>Some antivirus products flag PyInstaller-built EXEs. You can inspect
the source and build it yourself. Don’t disable antivirus just to run
Window Guard.</p>
<h2 id="github-and-source-code">16. GitHub and source code</h2>
<p>Source, release notes and issue reporting are available at:</p>
<p><a href="https://github.com/Gexos/window-guard">github.com/Gexos/window-guard</a></p>
<p>The project is released under the <strong>MIT License</strong>. Check
the <code>LICENSE</code> file for the terms.</p>
<p></p>
<hr/>
<p>Window Guard v0.6.0<br/>
Giorgos Xanthopoulos aka gexos</p>
</main></body>
</html>