Skip to content

nofuturekid/ViVeTool-GUI

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

249 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

ViVeTool GUI

GitHub all releases GitHub License

Windows Feature Control GUI based on ViVeTool

Overview

ViVeTool GUI is a modern, user-friendly graphical interface for managing hidden Windows features in Insider Preview builds. It provides an intuitive way to enable, disable, and search for features without requiring command-line expertise.

Key Highlights:

  • 🎯 Simple button-based feature management
  • πŸ” Powerful search and filtering capabilities
  • πŸŒ™ Modern UI with light/dark/system theme support (WPF)
  • βš™οΈ Advanced feature scanning and discovery tools
  • πŸ“‹ Community-maintained feature lists

Getting Started

System Requirements

  • Windows Version: Windows 10 Build 18963 (Version 2004) or newer
  • WPF Version (.NET 9): Recommended for latest features and Windows 11 Fluent design
  • WinForms Version (.NET Framework 4.8): Legacy support for older systems

Installation

  1. Download the latest release from GitHub Releases
  2. Run the executable (no installation required)
  3. Select your Windows build
  4. Start managing features

How to Use

Method 1: Browse and Select Features

  1. Select your Windows build from the dropdown
  2. Wait for the feature list to load
  3. Expand feature groups by clicking the arrow
  4. Select the feature you want to modify
  5. Click "Perform Action" and choose your desired action

Method 2: Manually Enter Feature ID

  1. Click "Manually change a Feature"
  2. Enter a Feature ID
  3. Click "Perform Action" and select your action

Features

Core Capabilities

  • Enable/Disable Features - Easily toggle hidden Windows features on and off
  • Search & Filter - Quickly find features by name, ID, or description
  • Feature Organization - Group features by:
    • Always Enabled
    • Always Disabled
    • Enabled by Default
    • Disabled by Default
    • Modifiable
  • Smart Sorting - Sort by feature name, ID, or current state
  • Clipboard Integration - Right-click to copy feature names and IDs

Advanced Features

  • Multi-Build Support - Load feature lists for different Windows builds
  • Theme Customization - Dark, light, and system mode support
  • Feature Scanner - Scan your Windows build to discover hidden features

Documentation

πŸ“– User Documentation

πŸ‘¨β€πŸ’» Developer Documentation

Version Comparison: WPF vs Legacy

WPF Version (.NET 9) - Recommended

Modern Features:

  • βœ… Windows 11 Fluent Design - Native Windows 11 UI with accent color integration
  • βœ… ThemeMode API - System theme detection and integration
  • βœ… Modern .NET Runtime - Better performance and security updates
  • βœ… Enhanced Accessibility - Improved keyboard navigation and screen reader support
  • βœ… Smart Feature Feed Caching - ETag-based caching with offline fallback
  • βœ… Feature Scanner Integration - Built-in discovery tools for new features
  • βœ… GitHub Actions Publishing - Direct feature list publishing for maintainers

Not Implemented:

  • ❌ Store/A/B Testing repair tools (planned for next release)
  • ❌ Multi-language localization (planned for next release)

Recommended For:

  • Windows 11 users
  • Users wanting the latest UI/UX improvements
  • Advanced feature scanning needs
  • Active Insider program participants

Legacy WinForms Version (.NET Framework 4.8)

Capabilities:

  • βœ… Core feature enable/disable functionality
  • βœ… Search and filtering
  • βœ… Feature grouping and sorting
  • βœ… Basic theme support (Windows default)
  • βœ… Multi-build feature list loading
  • βœ… Multi-language localization support
  • βœ… Store/A/B Testing repair tools
  • βœ… LastKnownGood Store fixing capabilities

Recommended For:

  • Windows 10 users
  • Users needing store repair functionality
  • Users requiring multi-language support
  • Legacy system compatibility

Direct Feature Comparison

Feature WPF Version Legacy WinForms
UI Framework Windows 11 Fluent Classic WinForms
Theme Support Light/Dark/System Windows Default
Multi-Language Support ❌ βœ…
Store Repair Tools ❌ βœ…
A/B Testing Fix ❌ βœ…
Feature Scanner βœ… Advanced ⚠️ Limited
Smart Caching βœ… ETag-based ⚠️ Basic
GitHub Publishing βœ… Native ❌
Keyboard Accessibility βœ… Enhanced ⚠️ Standard
Performance βœ… Modern .NET 9 ⚠️ .NET Framework
Windows 10 Support βœ… Works βœ… Optimized
Windows 11 Support βœ… Optimized βœ… Works

Choosing Your Version

Use WPF if you:

  • Are on Windows 11
  • Want the latest UI/UX improvements
  • Don't need store repair functionality
  • Want GitHub feature publishing

Use Legacy (WinForms) if you:

  • Are on Windows 10
  • Need store repair functionality
  • Require multi-language support
  • Prefer the classic interface
  • Need backward compatibility

Migration Path

If you're currently using the Legacy WinForms version, see MIGRATION_NOTES.md for detailed migration instructions to the new WPF version.

Feature Feed System

ViVeTool GUI uses a GitHub-hosted feature feed to provide current feature lists for supported Windows builds.

Feed Architecture

  • latest.json - Metadata about available builds and latest build numbers
  • features/{build}/features.csv or features.json - Per-build feature lists

Feature Feed Usage

The application automatically fetches feature lists from the feed with:

  • Smart Caching - Minimizes bandwidth usage
  • Offline Fallback - Uses cached data when network is unavailable
  • Legacy Support - Falls back to mach2 format for older builds

Feature Scanner & Publishing

For Power Users & Maintainers:

  1. Launch the Feature Scanner from the main application
  2. Run a complete scan of your Windows build
  3. Click "Publish via GitHub Actions" in the publish panel
  4. Provide your build number, select format (CSV/JSON), and authenticate
  5. Your feature list is automatically committed to the repository

Note: Publishing requires maintainer permissions. Contact repository maintainers if you encounter 403 errors.

Why Use ViVeTool GUI?

Compared to the command-line ViVeTool, ViVeTool GUI offers:

Feature CLI ViVeTool ViVeTool GUI
User-Friendly UI ❌ βœ…
Feature Search ⚠️ Limited βœ… Full-featured
One-Click Actions ❌ βœ…
Modern Theme Support ❌ βœ… (WPF)
Feature Scanning ⚠️ Limited βœ… Advanced

Project Structure

ViVeTool-GUI/
β”œβ”€β”€ ViVeTool-GUI.Wpf/          # Modern WPF application (recommended)
β”œβ”€β”€ ViVeTool-GUI.FeatureScanner/ # Feature discovery and scanning tools
β”œβ”€β”€ Albacore.ViVe/              # ViVe API wrapper and core functionality
β”œβ”€β”€ vivetool-gui/               # Legacy WinForms version
β”œβ”€β”€ lib/                        # External dependencies
β”œβ”€β”€ images/                     # UI screenshots and icons
β”œβ”€β”€ MIGRATION_NOTES.md          # WPF migration guide
└── building.md                 # Build instructions

Building from Source

For detailed build instructions, see building.md.

Quick Start:

git clone https://github.com/mta1124-1629472/ViVeTool-GUI.git
cd ViVeTool-GUI
dotnet build -c Release

Troubleshooting

Feature List Won't Load

  • Ensure you're connected to the internet (first-time setup)
  • Check that your Windows build number is supported
  • Try clearing the local cache and restarting
  • See TROUBLESHOOTING.md for detailed help

"Access Denied" Errors

  • Run ViVeTool GUI as Administrator
  • Ensure your user account has sufficient privileges
  • Check Windows Defender or antivirus software isn't blocking the app
  • See TROUBLESHOOTING.md for more solutions

Need More Help?

Check FAQ.md, TROUBLESHOOTING.md, or KNOWN_ISSUES.md for comprehensive guidance.

Disclaimer

⚠️ Important: Modifying Windows features can affect system stability and performance. Use this tool at your own risk.

No oneβ€”including the ViVeTool GUI creators, the ViVeTool developers, or the mach2 creatorsβ€”is responsible for any damage or unintended side effects resulting from feature modifications. Always create a system restore point before making changes.

Credits & Attribution

Built With:

Special Thanks:

License

ViVeTool GUI is open source. See LICENSE for details.

Community & Support

Contributing

Contributions are welcome! Whether it's:

  • πŸ› Bug reports and fixes
  • ✨ Feature suggestions and implementation
  • πŸ“š Documentation improvements

See our guidelines in DEVELOPMENT.md and building.md for more information.

Want to help with WPF improvements? Start with CODE_ANALYSIS.md and WPF_ISSUES_QUICK_FIX.md for priority issues and ready-to-use code.


Made with ❀️ for Windows power users and Insider testers

⬆ Back to top

About

Windows Feature Control GUI based on ViVe / ViVeTool

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Visual Basic .NET 100.0%