<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. |
| [`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

The cleanup script uninstalls selected Windows applications for the current user.

```powershell
powershell -ExecutionPolicy Bypass -File .\powershell\Winget-Remove-BuiltInApps.ps1
```

Targeted applications include Xbox components, Outlook for Windows, Feedback Hub, OneDrive, Teams, Microsoft To Do, Bing apps, Clipchamp 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).