pi-extension-change-background
v1.0.0
Published
A Pi extension for changing the Windows Terminal background image
Readme
pi-extension-change-background
A Pi extension that adds /change-background for Windows Terminal.
Features
- Set a background image from an absolute or working-directory-relative path.
- Disable the background with
offornone. - Preserve other Windows Terminal settings while updating
profiles.defaults. - Use readable defaults: 25% opacity, centered, and
uniformToFillscaling.
Requirements
- Pi
- Windows Terminal on Windows.
Install
pi install git:github.com/izzathilmi/pi-extension-change-backgroundAfter installation, reload Pi with /reload.
Usage
/change-background C:\\Users\\you\\Pictures\\background.jpg
/change-background .\\images\\background.png
/change-background offRun /change-background without an argument to display the current image and usage.
Changes are written to the Windows Terminal settings.json file. Open a new Windows Terminal tab to apply them.
Platform scope
The slash command is available in Pi. The setting it changes belongs to Windows Terminal, so the selected background is also visible to other CLI programs running inside Windows Terminal, including Claude Code, Codex CLI, PowerShell, and WSL. It does not configure unrelated terminal applications such as the VS Code integrated terminal.
Security note
Pi extensions run with full system permissions. Review the source before installing. This extension only reads and updates the detected Windows Terminal settings file and validates that the requested image path points to a regular file.
License
MIT
