zencleaner 1.0.1__tar.gz

zencleaner-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZenCleaner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

zencleaner-1.0.1/MANIFEST.in

@@ -0,0 +1,15 @@
+include LICENSE
+include README.md
+recursive-include zencleaner/templates *
+recursive-include zencleaner/static *
+global-exclude *.py[cod] __pycache__
+global-exclude *.exe *.spec
+prune build
+prune dist
+prune node_modules
+prune .pw_browsers
+prune .pytest_cache
+prune .test_lic
+prune .venv
+prune tests
+prune zenkeygen-cs

zencleaner-1.0.1/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: zencleaner
+Version: 1.0.1
+Summary: ZenCleaner - type 'zencleaner' in your terminal to open a localhost web UI that actually cleans your PC.
+Author: ZenCleaner
+License: MIT
+Project-URL: Homepage, https://github.com/zencleaner/zencleaner
+Keywords: pc-cleaner,windows,privacy,temp-files,localhost,flask,system-cleaner
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flask>=3.0
+Requires-Dist: flask-cors>=4.0
+Dynamic: license-file
+
+# ZenCleaner 🧹
+
+> **`pip install zencleaner`** → type **`zencleaner`** in your terminal → a localhost web UI opens → click buttons → it actually cleans your PC.
+
+The website is just the remote control. The real work happens **on your own PC** via a tiny local server bound to `127.0.0.1` — nothing is sent to the internet.
+
+---
+
+## Quick start (Windows)
+
+```bash
+pip install zencleaner
+```
+
+Open a **new** terminal and type:
+
+```bash
+zencleaner
+```
+
+Your browser opens automatically at `http://127.0.0.1:8765` with the ZenCleaner web UI.
+
+## Troubleshooting
+
+**`'zencleaner' is not recognized as an internal or external command`**
+
+The install worked, but Windows can't find the command because pip's `Scripts` folder is not on your `PATH` (pip even prints a yellow `WARNING: The script zencleaner.exe is installed in ... which is not on PATH` during install). Any of these fixes work — try them in order:
+
+```bash
+py -m zencleaner
+```
+
+or run the shim directly:
+
+```bash
+python -m zencleaner
+```
+
+Or add the `Scripts` folder to PATH: pip's warning shows the exact folder, e.g. `C:\Users\<you>\AppData\Local\Python\pythoncore-3.14-64\Scripts`. Add it via **Settings → search "environment variables" → Edit the system environment variables → Environment Variables → Path → Edit → New**, paste that folder, OK, then open a **new** terminal and `zencleaner` will work.
+
+**`'pip' is not recognized as an internal or external command`**
+
+Python itself isn't installed or wasn't added to PATH. Install Python from [python.org/downloads](https://www.python.org/downloads/) and make sure the **"Add python.exe to PATH"** checkbox is ticked in the installer's first screen, then reopen the terminal and run `py -m pip install zencleaner`.
+
+## What it can clean
+
+| Task | What it does |
+|---|---|
+| Temp Files | `%TEMP%`, `C:\Windows\Temp` |
+| Prefetch | `C:\Windows\Prefetch` (admin only) |
+| Recycle Bin | Empty recycle bin |
+| Registry MRU | RunMRU, RecentDocs, ComDlg32 (safe keys only) |
+| DNS Cache | `ipconfig /flushdns` |
+| Clean All | All of the above at once |
+
+## Command-line options
+
+```
+zencleaner --help
+
+  --port PORT        Port to run on (default 8765)
+  --no-browser       Don't auto-open the browser
+  --host HOST        Bind address (default 127.0.0.1 — localhost only)
+  --no-elevate       Skip the Windows UAC admin prompt
+  --no-auto-kill     Don't kill an old ZenCleaner already on this port
+```
+
+## Admin rights
+
+Some tasks (Prefetch, Registry, Forensic) need Windows Admin. On startup ZenCleaner shows a **UAC prompt** — accept it for full power, or cancel/click `--no-elevate` and the UI still works with admin-only tasks disabled.
+
+## Security
+
+- Server binds to `127.0.0.1` only — **nobody on your network or the internet can reach it**.
+- No telemetry, no data collection, no outbound calls.
+- Every clean action is a real Python function running locally on your machine.
+
+## Stop it
+
+Press `Ctrl+C` in the terminal. The localhost site stops instantly.
+
+## License
+
+MIT — see [LICENSE](LICENSE)

zencleaner-1.0.1/README.md

@@ -0,0 +1,84 @@
+# ZenCleaner 🧹
+
+> **`pip install zencleaner`** → type **`zencleaner`** in your terminal → a localhost web UI opens → click buttons → it actually cleans your PC.
+
+The website is just the remote control. The real work happens **on your own PC** via a tiny local server bound to `127.0.0.1` — nothing is sent to the internet.
+
+---
+
+## Quick start (Windows)
+
+```bash
+pip install zencleaner
+```
+
+Open a **new** terminal and type:
+
+```bash
+zencleaner
+```
+
+Your browser opens automatically at `http://127.0.0.1:8765` with the ZenCleaner web UI.
+
+## Troubleshooting
+
+**`'zencleaner' is not recognized as an internal or external command`**
+
+The install worked, but Windows can't find the command because pip's `Scripts` folder is not on your `PATH` (pip even prints a yellow `WARNING: The script zencleaner.exe is installed in ... which is not on PATH` during install). Any of these fixes work — try them in order:
+
+```bash
+py -m zencleaner
+```
+
+or run the shim directly:
+
+```bash
+python -m zencleaner
+```
+
+Or add the `Scripts` folder to PATH: pip's warning shows the exact folder, e.g. `C:\Users\<you>\AppData\Local\Python\pythoncore-3.14-64\Scripts`. Add it via **Settings → search "environment variables" → Edit the system environment variables → Environment Variables → Path → Edit → New**, paste that folder, OK, then open a **new** terminal and `zencleaner` will work.
+
+**`'pip' is not recognized as an internal or external command`**
+
+Python itself isn't installed or wasn't added to PATH. Install Python from [python.org/downloads](https://www.python.org/downloads/) and make sure the **"Add python.exe to PATH"** checkbox is ticked in the installer's first screen, then reopen the terminal and run `py -m pip install zencleaner`.
+
+## What it can clean
+
+| Task | What it does |
+|---|---|
+| Temp Files | `%TEMP%`, `C:\Windows\Temp` |
+| Prefetch | `C:\Windows\Prefetch` (admin only) |
+| Recycle Bin | Empty recycle bin |
+| Registry MRU | RunMRU, RecentDocs, ComDlg32 (safe keys only) |
+| DNS Cache | `ipconfig /flushdns` |
+| Clean All | All of the above at once |
+
+## Command-line options
+
+```
+zencleaner --help
+
+  --port PORT        Port to run on (default 8765)
+  --no-browser       Don't auto-open the browser
+  --host HOST        Bind address (default 127.0.0.1 — localhost only)
+  --no-elevate       Skip the Windows UAC admin prompt
+  --no-auto-kill     Don't kill an old ZenCleaner already on this port
+```
+
+## Admin rights
+
+Some tasks (Prefetch, Registry, Forensic) need Windows Admin. On startup ZenCleaner shows a **UAC prompt** — accept it for full power, or cancel/click `--no-elevate` and the UI still works with admin-only tasks disabled.
+
+## Security
+
+- Server binds to `127.0.0.1` only — **nobody on your network or the internet can reach it**.
+- No telemetry, no data collection, no outbound calls.
+- Every clean action is a real Python function running locally on your machine.
+
+## Stop it
+
+Press `Ctrl+C` in the terminal. The localhost site stops instantly.
+
+## License
+
+MIT — see [LICENSE](LICENSE)

zencleaner-1.0.1/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zencleaner"
+version = "1.0.1"
+description = "ZenCleaner - type 'zencleaner' in your terminal to open a localhost web UI that actually cleans your PC."
+authors = [{name="ZenCleaner"}]
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+keywords = ["pc-cleaner", "windows", "privacy", "temp-files", "localhost", "flask", "system-cleaner"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "flask>=3.0",
+    "flask-cors>=4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/zencleaner/zencleaner"
+
+[project.scripts]
+zencleaner = "zencleaner.cli:main"
+zenkeygen = "zencleaner.keygen_app:main"
+
+[tool.setuptools.packages.find]
+include = ["zencleaner*"]
+
+[tool.setuptools.package-data]
+zencleaner = ["templates/*", "static/*"]

zencleaner-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zencleaner-1.0.1/zencleaner/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

zencleaner-1.0.1/zencleaner/__main__.py

@@ -0,0 +1,11 @@
+"""Allow running the package as a module: ``py -m zencleaner``.
+
+This works even when the pip Scripts folder is not on PATH (a very common
+Windows install where ``zencleaner`` alone is "not recognized as an internal
+or external command").
+"""
+
+from zencleaner.cli import main
+
+if __name__ == "__main__":
+    main()