Skip to content

keggan-std/AuraShield

Repository files navigation

AuraShield

A professional Windows desktop application built with WinUI 3 that provides automatic theme scheduling and comprehensive firewall service management.

Features

🎨 Theme Management

  • Automatic Theme Scheduling: Automatically switches between light and dark modes based on time of day or user-defined schedules
  • Manual Theme Control: Switch between light, dark, and automatic modes at any time
  • Schedule Configuration: Set custom time-based theme transitions for your preferred working environment

🔒 Firewall Service Management

  • Service Discovery: Comprehensive view of all Windows services and their firewall access status
  • Service Details: Display service information including parent process relationships
  • Access Control:
    • Block/allow individual services from firewall access
    • Block services globally across all network access
    • Block entire applications as a parent to prevent internet access
    • Apply restrictions individually or in bulk
  • Real-time Monitoring: Monitor active services and their firewall status

Technology Stack

  • Framework: .NET 10.0
  • UI Framework: WinUI 3
  • Target Platform: Windows 10.0.19041.0 and later
  • Architecture: MVVM (Model-View-ViewModel)
  • Supported Platforms: x86, x64, ARM64

Project Structure

AuraShield/
├── Views/              # XAML UI pages
│   ├── HomePage.xaml
│   ├── FirewallPage.xaml
│   └── SettingsPage.xaml
├── ViewModels/         # MVVM ViewModels
│   ├── MainViewModel.cs
│   ├── FirewallViewModel.cs
│   └── SettingsViewModel.cs
├── Services/           # Business logic
│   ├── ThemeService.cs
│   ├── ThemeSchedulerService.cs
│   ├── FirewallService.cs
│   └── ServiceMonitorService.cs
├── Models/             # Data models
│   └── ServiceInfo.cs
├── Converters/         # XAML value converters
│   └── BoolToBlockedTextConverter.cs
└── Assets/             # App resources and icons

Getting Started

Prerequisites

  • Windows 10 (Build 19041) or later
  • .NET 10.0 SDK
  • Visual Studio 2022 or Visual Studio Code with C# extension

Installation & Build

  1. Clone the repository:
git clone https://github.com/yourusername/AuraShield.git
cd AuraShield
  1. Restore NuGet packages:
dotnet restore
  1. Build the project:
dotnet build
  1. Run the application:
dotnet run

Platform-Specific Builds

Build for specific platforms:

# x64 (recommended)
dotnet publish -c Release -r win-x64

# x86
dotnet publish -c Release -r win-x86

# ARM64
dotnet publish -c Release -r win-arm64

Usage

Theme Settings

  1. Open the Settings page
  2. Select your preferred theme mode:
    • Light: Always use light theme
    • Dark: Always use dark theme
    • Automatic: Use scheduled times
  3. If Automatic is selected, set your preferred:
    • Light mode start time
    • Dark mode start time
  4. Changes apply immediately

Firewall Management

  1. Open the Firewall page
  2. View all services with firewall access
  3. Click on a service to see details:
    • Service name and description
    • Parent application
    • Current firewall status
  4. Use action buttons to:
    • Block individual service access
    • Block service globally
    • Block parent application entirely

Testing

Run unit tests:

dotnet test

Architecture

The application follows MVVM architecture:

  • Views: XAML-based UI components
  • ViewModels: Contain presentation logic and handle user interactions
  • Services: Encapsulate business logic for themes, firewall, and system monitoring
  • Models: Define data structures for services and application state

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Created as a professional Windows application for system administrators and power users.

Support

For issues, questions, or suggestions, please open an issue on the GitHub repository.

About

A professional Windows desktop application with automatic theme scheduling and comprehensive firewall service management.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages