mirror of
https://github.com/microsoft/PowerToys.git
synced 2026-04-03 17:56:44 +02:00
Windows Command Palette ("CmdPal") is the next iteration of PowerToys Run. With extensibility at its core, the Command Palette is your one-stop launcher to start _anything_.
By default, CmdPal is bound to <kbd>Win+Alt+Space</kbd>.


----
This brings the current preview version of CmdPal into the upstream PowerToys repo. There are still lots of bugs to work out, but it's reached the state we're ready to start sharing it with the world. From here, we can further collaborate with the community on the features that are important, and ensuring that we've got a most robust API to enable developers to build whatever extensions they want.
Most of the built-in PT Run modules have already been ported to CmdPal's extension API. Those include:
* Installed apps
* Shell commands
* File search (powered by the indexer)
* Windows Registry search
* Web search
* Windows Terminal Profiles
* Windows Services
* Windows settings
There are a couple new extensions built-in
* You can now search for packages on `winget` and install them right from the palette. This also powers searching for extensions for the palette
* The calculator has an entirely new implementation. This is currently less feature complete than the original PT Run one - we're looking forward to updating it to be more complete for future ingestion in Windows
* "Bookmarks" allow you to save shortcuts to files, folders, and webpages as top-level commands in the palette.
We've got a bunch of other samples too, in this repo and elsewhere
### PowerToys specific notes
CmdPal will eventually graduate out of PowerToys to live as its own application, which is why it's implemented just a little differently than most other modules. Enabling CmdPal will install its `msix` package.
The CI was minorly changed to support CmdPal version numbers independent of PowerToys itself. It doesn't make sense for us to start CmdPal at v0.90, and in the future, we want to be able to rev CmdPal independently of PT itself.
Closes #3200, closes #3600, closes #7770, closes #34273, closes #36471, closes #20976, closes #14495
-----
TODOs et al
**Blocking:**
- [ ] Images and descriptions in Settings and OOBE need to be properly defined, as mentioned before
- [ ] Niels is on it
- [x] Doesn't start properly from PowerToys unless the fix PR is merged.
- https://github.com/zadjii-msft/PowerToys/pull/556 merged
- [x] I seem to lose focus a lot when I press on some limits, like between the search bar and the results.
- This is https://github.com/zadjii-msft/PowerToys/issues/427
- [x] Turned off an extension like Calculator and it was still working.
- Need to get rid of that toggle, it doesn't do anything currently
- [x] `ListViewModel.<FetchItems>` crash
- Pretty confident that was fixed in https://github.com/zadjii-msft/PowerToys/pull/553
**Not blocking / improvements:**
- Show the shortcut through settings, as mentioned before, or create a button that would open CmdPalette settings.
- When PowerToys starts, CmdPalette is always shown if enabled. That's weird when just starting PowerToys/ logging in to the computer with PowerToys auto-start activated. I think this should at least be a setting.
- Needing to double press a result for it to do the default action seems quirky. If one is already selected, I think just pressing should be enough for it to do the action.
- This is currently a setting, though we're thinking of changing the setting even more: https://github.com/zadjii-msft/PowerToys/issues/392
- There's no URI extension. Was surprised when typing a URL that it only proposed a web search.
- [x] There's no System commands extension. Was expecting to be able to quickly restart the computer by typing restart but it wasn't there.
- This is in PR https://github.com/zadjii-msft/PowerToys/pull/452
---------
Co-authored-by: joadoumie <98557455+joadoumie@users.noreply.github.com>
Co-authored-by: Jordi Adoumie <jordiadoumie@microsoft.com>
Co-authored-by: Mike Griese <zadjii@gmail.com>
Co-authored-by: Niels Laute <niels.laute@live.nl>
Co-authored-by: Michael Hawker <24302614+michael-hawker@users.noreply.github.com>
Co-authored-by: Stefan Markovic <57057282+stefansjfw@users.noreply.github.com>
Co-authored-by: Seraphima <zykovas91@gmail.com>
Co-authored-by: Jaime Bernardo <jaime@janeasystems.com>
Co-authored-by: Kristen Schau <47155823+krschau@users.noreply.github.com>
Co-authored-by: Eric Johnson <ericjohnson327@gmail.com>
Co-authored-by: Ethan Fang <ethanfang@microsoft.com>
Co-authored-by: Yu Leng (from Dev Box) <yuleng@microsoft.com>
Co-authored-by: Clint Rutkas <clint@rutkas.com>
334 lines
9.0 KiB
C++
334 lines
9.0 KiB
C++
#include "pch.h"
|
|
|
|
#include "Generated Files/resource.h"
|
|
#include "PowerRenameConstants.h"
|
|
#include "PowerRenameExt.h"
|
|
|
|
#include <interface/powertoy_module_interface.h>
|
|
#include <settings.h>
|
|
#include <trace.h>
|
|
#include <VersionHelpers.h>
|
|
|
|
#include <common/SettingsAPI/settings_objects.h>
|
|
#include <common/logger/logger.h>
|
|
#include <common/utils/logger_helper.h>
|
|
#include <common/utils/package.h>
|
|
#include <common/utils/process_path.h>
|
|
#include <common/utils/resources.h>
|
|
|
|
#include <atomic>
|
|
|
|
std::atomic<DWORD> g_dwModuleRefCount = 0;
|
|
HINSTANCE g_hInst = 0;
|
|
|
|
class CPowerRenameClassFactory : public IClassFactory
|
|
{
|
|
public:
|
|
CPowerRenameClassFactory(_In_ REFCLSID clsid) :
|
|
m_refCount(1),
|
|
m_clsid(clsid)
|
|
{
|
|
ModuleAddRef();
|
|
}
|
|
|
|
// IUnknown methods
|
|
IFACEMETHODIMP QueryInterface(_In_ REFIID riid, _COM_Outptr_ void** ppv)
|
|
{
|
|
static const QITAB qit[] = {
|
|
QITABENT(CPowerRenameClassFactory, IClassFactory),
|
|
{ 0 }
|
|
};
|
|
return QISearch(this, qit, riid, ppv);
|
|
}
|
|
|
|
IFACEMETHODIMP_(ULONG)
|
|
AddRef()
|
|
{
|
|
return ++m_refCount;
|
|
}
|
|
|
|
IFACEMETHODIMP_(ULONG)
|
|
Release()
|
|
{
|
|
LONG refCount = --m_refCount;
|
|
if (refCount == 0)
|
|
{
|
|
delete this;
|
|
}
|
|
return refCount;
|
|
}
|
|
|
|
// IClassFactory methods
|
|
IFACEMETHODIMP CreateInstance(_In_opt_ IUnknown* punkOuter, _In_ REFIID riid, _Outptr_ void** ppv)
|
|
{
|
|
*ppv = NULL;
|
|
HRESULT hr;
|
|
if (punkOuter)
|
|
{
|
|
hr = CLASS_E_NOAGGREGATION;
|
|
}
|
|
else if (m_clsid == CLSID_PowerRenameMenu)
|
|
{
|
|
hr = CPowerRenameMenu::s_CreateInstance(punkOuter, riid, ppv);
|
|
}
|
|
else
|
|
{
|
|
hr = CLASS_E_CLASSNOTAVAILABLE;
|
|
}
|
|
return hr;
|
|
}
|
|
|
|
IFACEMETHODIMP LockServer(BOOL bLock)
|
|
{
|
|
if (bLock)
|
|
{
|
|
ModuleAddRef();
|
|
}
|
|
else
|
|
{
|
|
ModuleRelease();
|
|
}
|
|
return S_OK;
|
|
}
|
|
|
|
private:
|
|
~CPowerRenameClassFactory()
|
|
{
|
|
ModuleRelease();
|
|
}
|
|
|
|
std::atomic<long> m_refCount;
|
|
CLSID m_clsid;
|
|
};
|
|
|
|
BOOL WINAPI DllMain(HINSTANCE hInstance, DWORD dwReason, void*)
|
|
{
|
|
switch (dwReason)
|
|
{
|
|
case DLL_PROCESS_ATTACH:
|
|
g_hInst = hInstance;
|
|
Trace::RegisterProvider();
|
|
break;
|
|
|
|
case DLL_PROCESS_DETACH:
|
|
Trace::UnregisterProvider();
|
|
break;
|
|
}
|
|
return TRUE;
|
|
}
|
|
|
|
//
|
|
// Checks if there are any external references to this module
|
|
//
|
|
STDAPI DllCanUnloadNow(void)
|
|
{
|
|
return (g_dwModuleRefCount == 0) ? S_OK : S_FALSE;
|
|
}
|
|
|
|
//
|
|
// DLL export for creating COM objects
|
|
//
|
|
STDAPI DllGetClassObject(_In_ REFCLSID clsid, _In_ REFIID riid, _Outptr_ void** ppv)
|
|
{
|
|
HRESULT hr = E_FAIL;
|
|
*ppv = NULL;
|
|
CPowerRenameClassFactory* pClassFactory = new CPowerRenameClassFactory(clsid);
|
|
hr = pClassFactory->QueryInterface(riid, ppv);
|
|
pClassFactory->Release();
|
|
return hr;
|
|
}
|
|
|
|
STDAPI DllRegisterServer()
|
|
{
|
|
return S_OK;
|
|
}
|
|
|
|
STDAPI DllUnregisterServer()
|
|
{
|
|
return S_OK;
|
|
}
|
|
|
|
void ModuleAddRef()
|
|
{
|
|
g_dwModuleRefCount++;
|
|
}
|
|
|
|
void ModuleRelease()
|
|
{
|
|
g_dwModuleRefCount--;
|
|
}
|
|
|
|
class PowerRenameModule : public PowertoyModuleIface
|
|
{
|
|
private:
|
|
// Enabled by default
|
|
bool m_enabled = false;
|
|
std::wstring app_name;
|
|
//contains the non localized key of the powertoy
|
|
std::wstring app_key;
|
|
|
|
public:
|
|
// Return the localized display name of the powertoy
|
|
virtual PCWSTR get_name() override
|
|
{
|
|
return app_name.c_str();
|
|
}
|
|
|
|
// Return the non localized key of the powertoy, this will be cached by the runner
|
|
virtual const wchar_t* get_key() override
|
|
{
|
|
return app_key.c_str();
|
|
}
|
|
|
|
// Return the configured status for the gpo policy for the module
|
|
virtual powertoys_gpo::gpo_rule_configured_t gpo_policy_enabled_configuration() override
|
|
{
|
|
return powertoys_gpo::getConfiguredPowerRenameEnabledValue();
|
|
}
|
|
|
|
// Enable the powertoy
|
|
virtual void enable()
|
|
{
|
|
Logger::info(L"PowerRename enabled");
|
|
m_enabled = true;
|
|
|
|
if (package::IsWin11OrGreater())
|
|
{
|
|
std::wstring path = get_module_folderpath(g_hInst);
|
|
std::wstring packageUri = path + L"\\PowerRenameContextMenuPackage.msix";
|
|
|
|
if (!package::IsPackageRegisteredWithPowerToysVersion(PowerRenameConstants::ModulePackageDisplayName))
|
|
{
|
|
package::RegisterSparsePackage(path, packageUri);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Disable the powertoy
|
|
virtual void disable()
|
|
{
|
|
m_enabled = false;
|
|
Logger::info(L"PowerRename disabled");
|
|
}
|
|
|
|
// Returns if the powertoy is enabled
|
|
virtual bool is_enabled() override
|
|
{
|
|
return m_enabled;
|
|
}
|
|
|
|
// Return JSON with the configuration options.
|
|
// These are the settings shown on the settings page along with their current values.
|
|
virtual bool get_config(_Out_ PWSTR buffer, _Out_ int* buffer_size) override
|
|
{
|
|
HINSTANCE hinstance = reinterpret_cast<HINSTANCE>(&__ImageBase);
|
|
|
|
// Create a Settings object.
|
|
PowerToysSettings::Settings settings(hinstance, get_name());
|
|
settings.set_description(GET_RESOURCE_STRING(IDS_SETTINGS_DESCRIPTION));
|
|
settings.set_icon_key(L"pt-power-rename");
|
|
|
|
// Link to the GitHub PowerRename sub-page
|
|
settings.set_overview_link(GET_RESOURCE_STRING(IDS_OVERVIEW_LINK));
|
|
|
|
settings.add_bool_toggle(
|
|
L"bool_persist_input",
|
|
GET_RESOURCE_STRING(IDS_RESTORE_SEARCH),
|
|
CSettingsInstance().GetPersistState());
|
|
|
|
settings.add_bool_toggle(
|
|
L"bool_mru_enabled",
|
|
GET_RESOURCE_STRING(IDS_ENABLE_AUTO),
|
|
CSettingsInstance().GetMRUEnabled());
|
|
|
|
settings.add_int_spinner(
|
|
L"int_max_mru_size",
|
|
GET_RESOURCE_STRING(IDS_MAX_ITEMS),
|
|
CSettingsInstance().GetMaxMRUSize(),
|
|
0,
|
|
20,
|
|
1);
|
|
|
|
settings.add_bool_toggle(
|
|
L"bool_show_icon_on_menu",
|
|
GET_RESOURCE_STRING(IDS_ICON_CONTEXT_MENU),
|
|
CSettingsInstance().GetShowIconOnMenu());
|
|
|
|
settings.add_bool_toggle(
|
|
L"bool_show_extended_menu",
|
|
GET_RESOURCE_STRING(IDS_EXTENDED_MENU_INFO),
|
|
CSettingsInstance().GetExtendedContextMenuOnly());
|
|
|
|
settings.add_bool_toggle(
|
|
L"bool_use_boost_lib",
|
|
GET_RESOURCE_STRING(IDS_USE_BOOST_LIB),
|
|
CSettingsInstance().GetUseBoostLib());
|
|
|
|
return settings.serialize_to_buffer(buffer, buffer_size);
|
|
}
|
|
|
|
// Passes JSON with the configuration settings for the powertoy.
|
|
// This is called when the user hits Save on the settings page.
|
|
virtual void set_config(PCWSTR config) override
|
|
{
|
|
try
|
|
{
|
|
// Parse the input JSON string.
|
|
PowerToysSettings::PowerToyValues values =
|
|
PowerToysSettings::PowerToyValues::from_json_string(config, get_key());
|
|
|
|
CSettingsInstance().SetPersistState(values.get_bool_value(L"bool_persist_input").value());
|
|
CSettingsInstance().SetMRUEnabled(values.get_bool_value(L"bool_mru_enabled").value());
|
|
CSettingsInstance().SetMaxMRUSize(values.get_int_value(L"int_max_mru_size").value());
|
|
CSettingsInstance().SetShowIconOnMenu(values.get_bool_value(L"bool_show_icon_on_menu").value());
|
|
CSettingsInstance().SetExtendedContextMenuOnly(values.get_bool_value(L"bool_show_extended_menu").value());
|
|
CSettingsInstance().SetUseBoostLib(values.get_bool_value(L"bool_use_boost_lib").value());
|
|
CSettingsInstance().Save();
|
|
|
|
Trace::SettingsChanged();
|
|
}
|
|
catch (std::exception& e)
|
|
{
|
|
Logger::error("Configuration parsing failed: {}", std::string{ e.what() });
|
|
}
|
|
}
|
|
|
|
// Signal from the Settings editor to call a custom action.
|
|
// This can be used to spawn more complex editors.
|
|
virtual void call_custom_action(const wchar_t* /*action*/) override
|
|
{
|
|
}
|
|
|
|
// Destroy the powertoy and free memory
|
|
virtual void destroy() override
|
|
{
|
|
delete this;
|
|
}
|
|
|
|
void init_settings()
|
|
{
|
|
m_enabled = CSettingsInstance().GetEnabled();
|
|
Trace::EnablePowerRename(m_enabled);
|
|
}
|
|
|
|
void save_settings()
|
|
{
|
|
Trace::EnablePowerRename(m_enabled);
|
|
}
|
|
|
|
PowerRenameModule()
|
|
{
|
|
init_settings();
|
|
app_name = GET_RESOURCE_STRING(IDS_POWERRENAME_APP_NAME);
|
|
app_key = PowerRenameConstants::ModuleKey;
|
|
LoggerHelpers::init_logger(app_key, L"ModuleInterface", LogSettings::powerRenameLoggerName);
|
|
}
|
|
|
|
~PowerRenameModule(){};
|
|
};
|
|
|
|
extern "C" __declspec(dllexport) PowertoyModuleIface* __cdecl powertoy_create()
|
|
{
|
|
return new PowerRenameModule();
|
|
}
|