https://github.com/lessup/dig-your-windows
https://github.com/lessup/dig-your-windows
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/lessup/dig-your-windows
- Owner: LessUp
- License: mit
- Created: 2025-11-24T06:04:22.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2026-03-09T06:26:56.000Z (2 months ago)
- Last Synced: 2026-03-09T06:49:44.808Z (2 months ago)
- Language: C#
- Size: 3.77 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: changelog/2025-02-27-directory-restructure.md
- License: LICENSE
Awesome Lists containing this project
README
# DigYourWindows
[](https://github.com/LessUp/dig-your-windows/actions/workflows/ci.yml)
[](https://github.com/LessUp/dig-your-windows/actions/workflows/pages.yml)
[](https://opensource.org/licenses/MIT)
[](https://github.com/LessUp/dig-your-windows/releases)
[](https://github.com/LessUp/dig-your-windows/releases)
English | [็ฎไฝไธญๆ](README.zh-CN.md)
> ๐ **Documentation**: [https://lessup.github.io/dig-your-windows/](https://lessup.github.io/dig-your-windows/)
**Windows Deep Diagnostics Tool** โ One-click hardware information collection, event log analysis, reliability records, system health scoring, and optimization recommendations.
## ๐ธ Screenshots
## โจ Features
| Feature | Description |
|---------|-------------|
| ๐ **Hardware Detection** | Collect CPU, GPU, RAM, Disk (with SMART), Network adapters, USB devices |
| ๐ **Real-Time Monitoring** | CPU temp/load/frequency, GPU temp/load/VRAM, network traffic |
| ๐ **Event Log Analysis** | Auto-extract System/Application errors and warnings |
| ๐ **Reliability Records** | Windows Reliability Monitor data with trend visualization |
| โ
**Health Scoring** | Comprehensive stability, performance, memory, disk assessment |
| ๐ก **Smart Recommendations** | AI-generated targeted optimization suggestions |
| ๐ **Report Export** | HTML and JSON formats with offline viewing |
| ๐จ **Theme Support** | Dark/Light theme instant toggle |
## ๐ Quick Start
### Prerequisites
- Windows 10/11 (Build 19041+)
- [.NET 10.0 SDK](https://dotnet.microsoft.com/download) (for building)
### Installation
#### Option 1: Download Release (Recommended)
Download the latest installer from [Releases](https://github.com/LessUp/dig-your-windows/releases):
| Version | Size | Requirements |
|---------|------|--------------|
| `DigYourWindows_Setup.exe` | ~5MB | Downloads .NET if needed |
| FDD (Framework-Dependent) | ~60MB | Requires .NET 10 Runtime |
| SCD (Self-Contained) | ~180MB | No dependencies |
#### Option 2: Build from Source
```powershell
# Clone repository
git clone https://github.com/LessUp/dig-your-windows.git
cd dig-your-windows
# Build and run
dotnet restore
dotnet run --project src/DigYourWindows.UI/DigYourWindows.UI.csproj
```
> โ ๏ธ **Note**: Some features (GPU monitoring, SMART data) require administrator privileges.
### First Run
1. Launch `DigYourWindows.UI.exe` (or run via `dotnet run`)
2. Click "Run Diagnostics" to collect system information
3. View real-time hardware monitoring on the dashboard
4. Export reports via JSON or HTML format
## ๐๏ธ Tech Stack
| Component | Technology | Version | Purpose |
|-----------|------------|---------|---------|
| Runtime | .NET + WPF | 10.0 | Desktop application framework |
| UI Library | WPF-UI | 4.0 | Fluent Design components |
| MVVM | CommunityToolkit.Mvvm | 8.4 | Data binding & commands |
| Charts | ScottPlot | 5.1 | Performance visualization |
| Hardware | LibreHardwareMonitor | 0.9 | CPU/GPU temp, load, frequency |
| Testing | xUnit + FsCheck | 2.9 / 2.16 | Unit & property-based tests |
## ๐ Project Structure
```
dig-your-windows/
โโโ src/
โ โโโ DigYourWindows.Core/ # Core business logic
โ โโโ DigYourWindows.UI/ # WPF user interface
โโโ tests/
โ โโโ DigYourWindows.Tests/ # Unit & property tests
โโโ docs/ # VitePress documentation (bilingual)
โโโ installer/ # Inno Setup scripts
โโโ scripts/ # Build & release scripts
โโโ changelog/ # Detailed changelogs
```
## ๐งช Testing
```powershell
# Run all tests
dotnet test DigYourWindows.slnx
# Run with coverage
dotnet test --collect:"XPlat Code Coverage"
# Filter specific tests
dotnet test --filter "FullyQualifiedName~ReportServiceTests"
```
## ๐ Documentation
- [๐ Getting Started Guide](https://lessup.github.io/dig-your-windows/guide/getting-started)
- [๐๏ธ Architecture Documentation](https://lessup.github.io/dig-your-windows/guide/architecture)
- [๐งช Testing Guide](https://lessup.github.io/dig-your-windows/guide/testing)
- [๐ Data Schema Reference](https://lessup.github.io/dig-your-windows/reference/data-schema)
- [โ FAQ](https://lessup.github.io/dig-your-windows/guide/faq)
Documentation is available in **English** and **็ฎไฝไธญๆ**.
## ๐ค Contributing
We welcome contributions! Please see our [Contributing Guide](https://lessup.github.io/dig-your-windows/guide/contributing) for details.
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit changes (`git commit -m 'feat: add amazing feature'`)
4. Push to branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## ๐ฆ Release Process
Push a `v*` tag to trigger automatic release:
```powershell
git tag v1.1.0
git push origin v1.1.0
```
GitHub Actions will automatically build and publish the release with bilingual release notes.
## ๐ Security
This tool:
- โ
Runs entirely offline
- โ
Does not upload any data to external servers
- โ
Uses local file system for all operations
- โ
Is open source and auditable
## ๐ License
[MIT License](LICENSE) - Copyright ยฉ 2025-2026 LessUp
---
Made with โค๏ธ by LessUp