Repository files navigation

If you are new to the Windows Package Manager, you might want toExplore the Windows Package Manager tool. The client has access to packages from two default sources. The first is "msstore" the Microsoft Store (free Apps rated "e" for everyone). The second is "winget" theWinGet community repository.

The client is distributed within theApp Installer package.

There are two methods to get development releases:

• Install aWindows 10 or Windows 11 Insider build.
• Join the Windows Package Manager Insider program bysigning up.

Once you have received the updated App Installer from the Microsoft Store you should be able to executewinget features to see experimental features. Some users have reportedissues with the client not being on their PATH.

The same Microsoft Store package will be made available via ourReleases. Note that installing this package will give you the WinGet client, but it will not enable automatic updates from the Microsoft Store if you have not joined the Windows Package Manager Insider program.

Please read ourtroubleshooting guide.

Installer behavior can be different depending on whether you are runningWinGet with administrator privileges.

• When runningWinGet without administrator privileges, some applications mayrequire elevation to install. When the installer runs, Windows will prompt you toelevate. If you choose not to elevate, the application will fail to install.

• When runningWinGet in an Administrator Command Prompt, you will not seeelevation prompts if the application requires it. Always use caution when running your command prompt as an administrator, and only install applications you trust.

You can alsobuild the client yourself. While the client should be perfectly functional, we are not ready to provide full support for clients running outside of the official distribution mechanisms yet. Feel free to file anIssue, but know that it may get lower prioritization.

The plan for delivering the next Windows Package Manager release is described and included in ourdiscussions, and will be updated as the project proceeds.

TheWindows Package Manager is a tool designed to help you quickly and easily discover and install those packages that make your PC environment special. By using theWindows Package Manager, from one command, you can install your favorite packages:

winget install <package>

This winget-cli repository includes the source code designed to build the client. You are encouraged to participate in the development of this client. We have plenty of backlog features in ourIssues. You can upvote the ones you want, add more, or evenget started on one.

The client is built around the concept of sources; a set of packages effectively. Sources provide the ability to discover and retrieve the metadata about the packages so that the client can act on it.

• The default "winget" source includes packages in theWindows Package Manager Community Repository.
• The default "msstore" source includes packages in the Microsoft Store.
• It is also possible to host your own privateREST-based source.

Please follow ourdeveloper guidance to build, run & test the client.

We would like to thankKeivan Beigi (@kayone) for his work on AppGet which helped us with the initial project direction for Windows Package Manager.

This project welcomes contributions and suggestions. Most contributions require you to agree to aContributor License Agreement (CLA) declaring that you have the right to, and do, actually grant us the rights to use your contribution. For details, visithttps://cla.opensource.microsoft.com. Moreinformation is available in ourCONTRIBUTING.md file.

When you submit a pull request, a CLA bot will automatically determine whether you need to providea CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructionsprovided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted theMicrosoft Open Source Code of Conduct.For more information, please refer to theCode of Conduct FAQ orcontactopencode@microsoft.com with any additional questions or comments.

The winget.exe client is instrumented to collect usage and diagnostic (error) data and sends it to Microsoft to help improve the product.

If you build the client yourself the instrumentation will not be enabled and no data will be sent to Microsoft.

The winget.exe client respects machine-wide privacy settings and users can opt out on their device, as documented in theMicrosoft Windows privacy statement. In addition, you may also explicitly block telemetry usingsettings

In short, to opt out, do one of the following:

Windows 11: Go toStart, then selectSettings >Privacy & Security >Diagnostics & feedback >Diagnostic data and unselectSend optional diagnostic data.

Windows 10: Go toStart, then selectSettings >Privacy >Diagnostics & feedback, and selectRequired diagnostic data.

See theprivacy statement for more details.