Files
Windows/README.md
T

116 lines
4.5 KiB
Markdown

<div align="center">
# Windows libre software toolkit
Small Windows toolkit to install libre software packs with `winget` and remove selected built-in Windows apps.
[![Windows](https://img.shields.io/badge/Windows-11%2024H2+-0078D4?style=flat-square&logo=windows&logoColor=white)](#requirements)
[![winget](https://img.shields.io/badge/winget-configuration-0B6AB3?style=flat-square)](#automated-packs)
[![PowerShell](https://img.shields.io/badge/PowerShell-scripts-5391FE?style=flat-square&logo=powershell&logoColor=white)](#interactive-installer)
[![License](https://img.shields.io/badge/license-GPL--3.0--or--later-2E8B57?style=flat-square)](./LICENSE)
**English** | [Français](./README.fr.md)
</div>
---
## What is inside?
| Path | Purpose |
| --- | --- |
| [`powershell/libres-softwares-install.ps1`](./powershell/libres-softwares-install.ps1) | Interactive installer for a curated list of applications. |
| [`powershell/Winget-Remove-BuiltInApps.ps1`](./powershell/Winget-Remove-BuiltInApps.ps1) | Removes selected built-in Windows applications for the current user with winget. |
| [`powershell/Remove-BuiltInApps.ps1`](./powershell/Remove-BuiltInApps.ps1) | Removes selected built-in Appx applications without winget, including provisioned packages for new users. |
| [`winget/libre-soft-start-pack.yaml`](./winget/libre-soft-start-pack.yaml) | Automated starter pack: Firefox ESR, 7-Zip and VLC. |
| [`winget/libre-soft-base-libreoffice.yaml`](./winget/libre-soft-base-libreoffice.yaml) | Starter pack plus LibreOffice. |
| [`winget/libre-soft-base-onlyoffice.yaml`](./winget/libre-soft-base-onlyoffice.yaml) | Starter pack plus ONLYOFFICE. |
## Requirements
Run the commands from an **administrator terminal** on Windows.
Enable winget configuration support first:
```powershell
winget configure --enable
```
The automated YAML packs currently assert **Windows 11 24H2** or newer.
## Interactive Installer
Choose the software you want to install from a PowerShell menu.
![Interactive installer screenshot](./img/interactive.png)
Run from the repository root:
```powershell
powershell -ExecutionPolicy Bypass -File .\powershell\libres-softwares-install.ps1
```
Available applications:
| Application | winget ID |
| --- | --- |
| Firefox ESR (FR) | `Mozilla.Firefox.ESR.fr` |
| 7-Zip | `7zip.7zip` |
| VLC Media Player | `VideoLAN.VLC` |
| ONLYOFFICE | `ONLYOFFICE.DesktopEditors` |
| LibreOffice | `TheDocumentFoundation.LibreOffice` |
| GIMP | `GIMP.GIMP.3` |
| Inkscape | `Inkscape.Inkscape` |
| Chromium | `Hibbiki.Chromium` |
| Bitwarden | `Bitwarden.Bitwarden` |
| Thunderbird | `Mozilla.Thunderbird` |
## Automated Packs
Use winget configuration files when you want a repeatable installation.
| Pack | Includes | Command |
| --- | --- | --- |
| Starter pack | Firefox ESR, 7-Zip, VLC | `winget configure --file .\winget\libre-soft-start-pack.yaml --accept-configuration-agreements` |
| LibreOffice pack | Starter pack, LibreOffice | `winget configure --file .\winget\libre-soft-base-libreoffice.yaml --accept-configuration-agreements` |
| ONLYOFFICE pack | Starter pack, ONLYOFFICE | `winget configure --file .\winget\libre-soft-base-onlyoffice.yaml --accept-configuration-agreements` |
Example:
```powershell
winget configure --file .\winget\libre-soft-start-pack.yaml --accept-configuration-agreements
```
## Remove Built-In Apps
Use the Appx cleanup script when you want to remove selected built-in applications without winget and prevent them from being provisioned for newly created users.
```powershell
powershell -ExecutionPolicy Bypass -File .\powershell\Remove-BuiltInApps.ps1
```
OneDrive is not an Appx package on most Windows installations. To also call the built-in OneDrive uninstaller, pass `-IncludeOneDrive`:
```powershell
powershell -ExecutionPolicy Bypass -File .\powershell\Remove-BuiltInApps.ps1 -IncludeOneDrive
```
The older winget-based cleanup script is still available, but it only targets the current user:
```powershell
powershell -ExecutionPolicy Bypass -File .\powershell\Winget-Remove-BuiltInApps.ps1
```
Targeted applications include Xbox components, Outlook for Windows, Feedback Hub, Power Automate, Sticky Notes, Weather, Teams, Microsoft To Do, Bing apps, Clipchamp, Windows Web Experience Pack and related built-in packages.
## Maintenance Note
When changing scripts, package IDs, pack contents or documented commands, update both README files:
- [`README.md`](./README.md) for English.
- [`README.fr.md`](./README.fr.md) for French.
## License
This project is distributed under the [GPL-3.0-or-later license](./LICENSE).