Beetle Optimiser

Windows PC maintenance suite. Tray-resident, zero network calls, single-file portable build.

This repo contains binaries only — no source code

This repository contains ZERO source code and ZERO source-code archives.

• No .cs, .xaml, .csproj, .sln files
• No Source code (zip) / Source code (tar.gz) assets on GitHub Releases
• No archive/refs/tags/<tag>.{zip,tar.gz} archives served for any tag
• No source code of any kind exposed anywhere on GitHub

All source code lives only in a private local development environment. This is a deliberate proprietary-licensing decision: not a "convenience" we forgot to flip off. See docs/SOP-EXE-RETENTION.md for the verification commands we run after every release to enforce this.

What you WILL find in this repo:

• publish/portable/BeetleOptimiser.exe — self-contained, ~70 MB
• publish/framework-dependent/BeetleOptimiser.exe — requires .NET 8 Desktop Runtime, ~3 MB
• docs/ — SOPs, UI test reports, screenshots from closed issues
• Standard project files — README, CHANGELOG, LICENSE, etc.

What you will NOT find:

• src/ — no .cs, .xaml, .csproj, .sln files
• .github/workflows/ — no CI
• scripts/ — release/cleanup scripts live locally
• assets/ — logo files live locally
• Source code (zip) or Source code (tar.gz) assets on any release
• https://github.com/mooned-dev/BeetleOptimiser/archive/refs/tags/* archives

Download

Variant	Size	Requires	Download
Portable	~70 MB	Nothing — runs on any Win10/11	Latest release
Framework-dependent	~3 MB	.NET 8 Desktop Runtime	Latest release

The "latest release" redirects to the newest version on GitHub. We maintain two separate releases per version (one per variant) so the auto-updater can pick the right one by tag suffix.

What it does

A tray-resident Windows utility with:

• 9 tabs: Dashboard, Scanner, Advisor, All Tools, Clean Up, Optimize, Tune Up, Protect, Settings
• Live hardware telemetry in the status bar (CPU/GPU/RAM/NET/SSD/HDD)
• Smart Advisor recommendations that route to the right page
• Dark / light themes with runtime toggle (navy palette matching logo)
• Single-file portable build that runs without installing

Everything runs locally. No telemetry, no analytics, no update checks, no network code of any kind. The app reads settings from %LOCALAPPDATA%\BeetleOptimiser\appsettings.json and writes back to it.

Features

Feature	Status
One-click memory optimization	✓
System tray icon with project logo	✓
Live memory ring (rotates as % used)	✓
Live hardware telemetry (CPU/GPU/RAM/NET/SSD/HDD)	✓
Run at startup (per-user Run key)	✓
Run as administrator (one-click UAC relaunch)	✓
Process exclusion list	✓
Manual optimization (working set / standby / file cache)	✓
Disk Cleanup (5 categories: temp, recycle, thumbs, logs, WU)	✓
Browser cache cleanup (Chrome, Edge, Firefox, Opera, Brave)	✓
Startup Manager (HKCU/HKLM/Startup folder)	✓
Program Uninstaller (HKLM\Wow6432Node\Uninstall)	✓
5 Tune Up optimizers (CPU/GPU/Storage/Registry/Compact)	✓
Smart Advisor recommendations (7+ types)	✓
Top Memory + Top CPU + Top Disk process lists (with Refresh)	✓
System Health Score card (composite 0-100)	✓
Scan overdue warning banner (after 7+ days)	✓
Balloon notification on X-close	✓
Dark and light themes with runtime toggle	✓
Per-tab scan feedback with progress checklist	✓
Persistent settings (JSON in %LOCALAPPDATA%)	✓
Single-file portable build	✓
Global hotkey for "optimize now"	planned
Auto-update from GitHub Releases	planned

SmartScreen note

Windows SmartScreen will show "Unknown publisher" and "Windows protected your PC" the first time you launch either binary. This is because the project is signed with a self-signed certificate (CN=MOONED DEV STUDIO) which chains to a root that is not in Windows' Trusted Root Certification Authorities store. The signature is real and verifiable (right-click the file → Properties → Digital Signatures → Details), but SmartScreen reputation is built from a cloud-based trust list and self-signed certs do not appear in it.

Click "More info" → "Run anyway" to launch. Windows remembers the choice per-file so you only see the dialog once.

The only way to suppress SmartScreen warnings entirely is to sign the binaries with an Extended Validation (EV) code signing certificate issued by a public CA (DigiCert, Sectigo, etc.). This is a paid yearly service ($200-500/year) and is not currently in use.

Running

1. Download BeetleOptimiser-portable.exe from the latest release.
2. Place it anywhere (Desktop, Program Files, USB stick — anywhere).
3. Double-click.

First time it will:

1. Acquire a per-user mutex (single-instance enforcement).
2. Read settings from %LOCALAPPDATA%\BeetleOptimiser\appsettings.json (creates defaults on first run).
3. Show the main window with the Dashboard tab active.
4. Register a tray icon with the project logo.
5. Start polling system memory every 1 second.
6. Start a 2-second telemetry timer that updates the status bar.

Closing the window minimizes to the tray with a balloon notification. Double-click the tray icon to restore.

Configuration

Settings live in %LOCALAPPDATA%\BeetleOptimiser\appsettings.json:

Known limitations

• Dynamic tray % overlay is not implemented. H.NotifyIcon does not accept RenderTargetBitmap on .NET 8 with PublishSingleFile=true. The static logo is shown in the tray. The status bar shows the live percentage instead.
• Temperature readings return empty on systems that don't expose the WMI MSAcpi_ThermalZoneTemperature class. The status bar shows - (no unit) rather than a fake value.
• Network rate is total sent + received in kbps (sum), not per-direction.

Documentation

• CHANGELOG.md — version history
• SUPPORT.md — getting help
• SECURITY.md — vulnerability reporting
• ACKNOWLEDGMENTS.md — credits
• CODE_OF_CONDUCT.md — contributor code of conduct
• docs/TRUST.md — release authenticity
• docs/SOP-EXE-RETENTION.md — release process + auto-update plan
• docs/UI_TEST_REPORT.md — UI test history + GitHub issue tracker

Development workflow

Important: This repo does not contain source code. To develop, build, or modify the app, you must work from a local copy.

The canonical local dev copy lives at our development setup. It contains the full source code (C#, XAML, .csproj, etc.) but is not pushed to GitHub.

Daily workflow

1. All edits happen locally at our development setup/.
2. Tests run locally: dotnet test
3. Build + publish locally: see docs/SOP-EXE-RETENTION.md
4. Bugs found during testing → open a GitHub issue per SOP (with inline screenshot if applicable)
5. Fix locally
6. Re-build + re-test locally
7. Publish new binary to GitHub Releases via the manual script: the release script -Version X.Y.Z -Notes "..."
8. Attach screenshots to the issue close-comment (light + dark theme)
9. Close the issue with state_reason: completed
10. Update CHANGELOG.md + docs/UI_TEST_REPORT.md with the new round
11. Commit + push the doc updates to this repo

What gets pushed to this repo

File	When
publish/portable/BeetleOptimiser.exe	When a new portable release is published
publish/framework-dependent/BeetleOptimiser.exe	When a new framework-dependent release is published
CHANGELOG.md	After every release
docs/SOP-EXE-RETENTION.md	When the release process changes
docs/UI_TEST_REPORT.md	After every UI test round
docs/screenshots-r*/	Visual proof attached to closed GitHub issues
README.md, LICENSE, etc.	When project info changes

What NEVER gets pushed

• Any *.cs, *.xaml, *.csproj file
• Directory.Build.props, Directory.Packages.props
• .github/workflows/ CI definitions
• scripts/ release automation
• assets/ logo source files
• Local-only test scripts, PS1 power tools

License

Proprietary — all rights reserved.

The source code is not distributed with this repo. To obtain a copy of the source for development, auditing, or any other purpose, contact the maintainer through GitHub's private vulnerability reporting flow (see SECURITY.md).

---

_{This is an independent project, not affiliated with Microsoft.}