FluentTweaker Documentation

repository·main·Indexed 25 days ago

https://github.com/builtbybel/fluenttweaker

A modern Windows tweaking application built with WinUI 3 focused on transparency, safety, and reversibility. It provides granular control over UI, Taskbar settings, privacy, AI features, File Explorer behavior, and system policies. The tool supports custom PowerShell extensions via the Tools tab, allowing users to add functionality using specific header metadata for categories, host modes, and input options.

Tokens
6.7K
Snippets
4
Records
46
Agent score
86%

What's inside FluentTweaker

  1. Overview of FluentTweaker

    main

    FluentTweaker is a Windows tweaking utility designed for transparency and safety. Unlike traditional 'optimization' tools, it avoids 'one-click' mystery optimizations. Instead, it provides granular control over various Windows subsystems, allowing users to inspect, categorize, and reverse individual tweaks.

    Key areas of control include:

    • UI and Taskbar settings
    • Privacy and AI features
    • File Explorer behavior
    • Gaming tweaks and performance settings
    • Hidden system policies and system behavior
  2. Optimize plugin naming for Help anchors

    main

    Winslopr can link directly to GitHub documentation by using the plugin's display title as an anchor. To ensure compatibility with GitHub's anchor generation, follow these rules for your plugin title:

    1. Use a title that matches the markdown heading in features.md.
    2. Anchors are generated by converting to lowercase, replacing spaces with hyphens (-), and removing apostrophes.

    Example:

    • Title: Don't Show Sponsored links in new tab page
    • Resulting Anchor: #dont-show-sponsored-links-in-new-tab-page
  3. Uninstall Microsoft OneDrive

    main

    Uninstalls Microsoft OneDrive and attempts to remove leftover integration from Windows Explorer.

    Requirements:

    • Administrator privileges recommended.

    Actions:

    • Runs the OneDrive installer with the /uninstall flag.
    • Removes remaining OneDrive folders.
    • Attempts to remove OneDrive from Explorer integration.

    Undo: Reinstall OneDrive manually via the Microsoft installer.

  4. Clean Taskbar pinned items

    main

    To clear all pinned items from the taskbar on both Windows 10 and 11, you must empty the Favorites value in the registry and then restart Windows Explorer.

    Registry Path: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Taskband
    Value: Favorites (REG_BINARY)

    Warning: This action is not undoable as the original pin layout cannot be reliably restored.

  5. Perform Basic Disk Cleanup

    main

    Deletes all temporary files from the user's %LOCALAPPDATA%\Temp folder and runs the built-in Windows Disk Cleanup utility (cleanmgr.exe).

    Actions performed:

    • Deletes files in %LOCALAPPDATA%\Temp
    • Runs cleanmgr.exe /sageset:1
    • Runs cleanmgr.exe /sagerun:1
    • Runs cleanmgr.exe /verylowdisk

    Note: This action cannot be undone.

  6. Run PowerShell-based tools

    main

    The Tools tab provides PowerShell extensions for advanced system utilities. To use a tool:

    1. Select a tool from the list on the left.
    2. Configure the available options on the right.
    3. Click Run.

    Available Tools

    • Post-setup Cleanup: Disk cleanup, clear update cache, remove Windows.old.
    • Explorer Tweaks: Show file extensions, hidden files, change default view.
    • Power Actions: Restart Explorer, shutdown, restart, sleep.
    • Windows Update Tamer: Control Windows Update behavior.
    • RemoveWindowsAI: Force-remove Copilot, Recall, and AI Actions.
    • Microsoft Defender Maintenance: Update signatures, repair, and show status.
    • Winget Bulk Installer: Install multiple apps at once.
    • Create Restore Point: One-click system restore point creation.

    Note: Tools with a yellow help hint icon have available documentation. You can remove any extension by clicking Uninstall (requires confirmation).

  7. Create PowerShell Extensions for the Tools tab

    main
    You can add custom functionality to the Tools tab by dropping .ps1 scripts into the .\scripts\ directory (subfolders are supported). The system automatically discovers these scripts by parsing the first ~15 lines of the file for specific header metadata comments.
  8. Create a Winslopr plugin

    main

    Winslopr plugins are PowerShell scripts (.ps1) that use an INI-style header to define actions. The tool reads the header to determine which commands to run (Check, Do, Undo) and can validate the state using an optional [Expect] section. Any code outside these INI sections is treated as standard PowerShell logic.

    # Disable Bing Search.ps1
    
    [Commands]
    Info=Disables Bing integration in Windows Search
    Check=reg query "HKCU\Software\Microsoft\Windows\CurrentVersion\Search" /v BingSearchEnabled
    Do=reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Search" /v BingSearchEnabled /t REG_DWORD /d 0 /f && echo BingSearchEnabled set to 0
    Undo=reg add "HKCU\Software\Microsoft\Windows\CurrentVersion\Search" /v BingSearchEnabled /t REG_DWORD /d 1 /f && echo BingSearchEnabled set to 1
    
    [Expect]
    BingSearchEnabled=0x0
  9. Create a System Restore Point

    main

    Creates a System Restore Point named Bloatynosy NueEx Restore Point using WMI (Win32_SystemRestore). This is useful to perform before applying major tweaks.

    Requirements:

    • Must be run as Administrator.

    Behavior:

    • Shows progress and a completion dialog upon success.