Shield Configurator Desktop Downloads

Download the ByteHide Shield Desktop Configurator for visual configuration of your .NET solution protection settings.

Windows Downloads

macOS Downloads

System Requirements

Windows

• OS: Windows 10 version 1903 or later
• Memory: 2 GB RAM minimum, 4 GB recommended
• Storage: 200 MB available space
• Runtime: .NET 6.0 Desktop Runtime

macOS

• OS: macOS 10.15 Catalina or later
• Memory: 2 GB RAM minimum, 4 GB recommended
• Storage: 200 MB available space
• Runtime: .NET 6.0 Runtime

Installation

Windows

1. Download the EXE installer
2. Run as administrator (right-click → "Run as administrator")
3. Follow the installation wizard
4. Launch "Shield Configurator" from Start Menu or Desktop

macOS - Special Installation Steps Required

Step 1: Download and Mount

1. Download the appropriate DMG file for your Mac architecture:
   • Intel Macs: Choose "macOS Intel (x64)"
   • Apple Silicon Macs (M1/M2/M3): Choose "macOS Apple Silicon (ARM64)"
2. Double-click the downloaded DMG file to mount it

Step 2: Attempt Installation

1. Drag "Shield Configurator" to your Applications folder
2. Try to launch the application from Applications folder
3. macOS will show a security warning: "Shield Configurator cannot be opened because it is from an unidentified developer"

Step 3: Allow the Application

1. Go to System Preferences (or System Settings on macOS 13+)
2. Click Security & Privacy (or Privacy & Security)
3. Click the General tab
4. You'll see a message: "Shield Configurator was blocked from use because it is not from an identified developer"
5. Click Open Anyway
6. Confirm by clicking Open in the dialog

Step 4: Launch Successfully

1. The application will now open
2. Future launches will work normally without these steps
3. You can find "Shield Configurator" in your Applications folder

Alternative Method: Right-Click to Open

If the Security & Privacy method doesn't work:

1. In Applications folder, right-click on "Shield Configurator"
2. Select Open from the context menu
3. Click Open in the security dialog that appears

What's Next?

After downloading and installing the Shield Desktop Configurator, follow these guides to get started:

Getting Started

1. Introduction & Overview - Understand the capabilities and features
2. Installation & Setup - Complete installation guide with troubleshooting
3. Configuration Workflow - Learn the step-by-step process

Advanced Usage

• Protection Settings - Configure advanced protection options
• Advanced Features - Expert-level configuration
• Video Tutorials - Watch comprehensive video guides

Related Documentation

• MSBuild Integration - Alternative integration method
• Configuration Files - Understanding Shield configuration
• CI/CD Integration - Automated protection workflows

Release Notes

Version 1.3.0 - September 28, 2025

🚀 New Features

Global Settings Management

• NEW: Added comprehensive Global Settings modal accessible from the footer
• NEW: Environment variable support for global settings (BYTEHIDE_SHIELD_ENABLED)
• NEW: Visual indicator when Shield protection is globally disabled
• NEW: Toggle between manual configuration and environment variable control

Assembly Signing Configuration

• NEW: Complete assembly signing options support
• NEW: Strong name signing configuration (.snk files and passwords)
• NEW: Enhanced signing configuration with custom signatures
• NEW: Delay signature option for postponed signing workflows
• NEW: Individual property-level configuration (not nested objects)

Protection Enhancements

• NEW: Added Virtualization protection option
• IMPROVED: Protection presets now include virtualization in maximum configuration

🛠️ Improvements

User Interface

• IMPROVED: Enhanced sidebar scrolling with proper container management
• IMPROVED: Fixed project list cutoff issues with responsive design
• IMPROVED: Global Settings modal with larger size for better usability
• IMPROVED: Consistent toggle design patterns across all settings

Configuration Management

• IMPROVED: Individual assembly signing properties saved at project level
• IMPROVED: Enhanced copy settings functionality includes all signing options
• IMPROVED: Better error handling and debugging for configuration saving/loading

API Integration

• FIXED: Corrected NuGet API URL for Bytehide.Shield.Integration package versions
• IMPROVED: More reliable version fetching with proper endpoint

🐛 Bug Fixes

Project Management

• FIXED: Project list in sidebar no longer cuts off at the bottom
• FIXED: Proper padding added to prevent footer overlap
• FIXED: Assembly signing options now correctly save and load from JSON

Configuration Persistence

• FIXED: Individual signing properties properly persist to bytehide.shield.global.json
• FIXED: Global options correctly load from existing configuration files
• FIXED: Environment variable initialization issues resolved

UI/UX Fixes

• FIXED: Modal accessibility and click-outside-to-close functionality
• FIXED: Toggle state management for environment variable switches
• FIXED: Proper visual feedback for save operations

📋 Technical Changes

Data Structure Updates

• Assembly signing properties moved from nested signing object to individual project properties
• Global options now include useEnvEnabled flag for environment variable control
• Enhanced project initialization with complete default values

Environment Variable Support

• BYTEHIDE_SHIELD_ENABLED: Controls global Shield protection state
• BYTEHIDE_SHIELD_TOKEN: Project token authentication (existing)
• Runtime evaluation of environment variables in main process

Configuration Schema

{
  "globalOptions": {
    "enabled": true,
    "throwOnError": true,
    "copyMagicKey": false
  },
  "projects": [{
    "SignFilePath": "",
    "SignPublicFilePath": "",
    "SignSignatureFilePath": "",
    "SignSignaturePublicFilePath": "",
    "SignFilePassword": "",
    "SignSignaturePassword": "",
    "DelaySignature": false
  }]
}

🔧 Developer Notes

Breaking Changes

• Assembly signing configuration structure changed from nested to flat properties
• Global options initialization moved to application startup

Migration

• Existing configurations will automatically migrate to new structure
• No manual intervention required for existing projects

Version 1.0.0 - September 21, 2025

🎉 Initial Release Features

Core Functionality

• Complete Visual Studio solution integration
• Protection configuration management
• Real-time configuration preview
• Multiple protection presets (Basic, Balanced, Maximum)

Project Management

• Multi-project solution support
• Individual project configuration
• Settings copy between projects
• JSON configuration export/import

Protection Options

• Renaming obfuscation
• Control flow obfuscation
• String encryption
• Anti-debugging protection
• Invalid metadata injection
• Call hiding

User Interface

• Modern, intuitive interface
• Dark/light theme support
• Responsive design
• Real-time validation

This release establishes the foundation for visual .NET protection configuration with comprehensive solution management capabilities.