App Showcase

An opinionated setup app + documentation hub for building a fast, clean, and consistent environment across Windows, Linux, macOS, WSL2, and even your living room stack (Google TV + Stremio) and home server (Home Assistant).

Improve your UX and productivity with a reproducible setup for:

• Development tools and package management
• WSL2 workflows
• GPU drivers
• Terminal UX (Zsh/Oh-My-Zsh/Powerlevel10k)
• Window tiling management
• Home automation (Home Assistant)
• TV setup (Google TV + Stremio)

The image above is the app that runs on your terminal, it supports multiple OSes (Windows, Linux, macOS, WSL2) and can be used with a mouse to click on the buttons. You can follow this repository to get a similar setup on Windows 11, Linux, macOS, or a hybrid workflow (Windows + WSL).

Table of contents

• Awesome OS Setup
  • Get started
    • Linux / WSL2 / MacOS
    • Windows 11
  • What is this repo?
    • Features & Benefits
    • Docs and websites
  • Project TODO / Roadmap
    • Docs & site
    • Quality & UX
  • Check the documentation
  • Contributing (For developers)

Get started with one command in bash/zsh:

sh -c "$(wget https://raw.githubusercontent.com/AmineDjeghri/awesome-os-setup/main/install_unix.sh -O -)"

If you are using a headless server (ubuntu-server for example), prefer to use a client with a GUI and connect to the server via SSH so you can copy-paste the commands and use Awesome-OS with a mouse.

Get started with one command (run it in PowerShell as administrator):

$u='https://raw.githubusercontent.com/AmineDjeghri/awesome-os-setup/main/install_windows.ps1'; $p="$env:TEMP\install_windows.ps1"; iwr $u -UseBasicParsing -OutFile $p; powershell -ExecutionPolicy Bypass -File $p

Run it from the directory where you want the awesome-os-setup folder to be created. I the repertory already exists, it will update it.

This repo is a personal “OS setup Terminal UI App”:

• One‑liner installers

  • Windows: PowerShell script that installs selected apps via winget, enables WSL, applies Windows Terminal defaults, and fetches GlazeWM config.
  • Linux / WSL/ macOS: Bash script that installs Zsh/OMZ/P10k, terminal tools, and optional NVIDIA for Linux.

• Cross‑OS Python TUI

  • TermTk‑based app (main.py) with:
    • OS detection (Windows, WSL, Linux, macOS),
    • System action sections (WSL tools, Windows utilities, package managers).

• Unified package catalog

  • src/awesome_os/config/packages.yaml as a single source of truth for packages.
  • Concrete backends implemented:
    • Linux:
      • Ubuntu: UbuntuAptManager, UbuntuSnapManager,
      • Arch: ArchLinuxYayManager
    • Windows: WindowsWingetManager,
    • macOS: DarwinBrewManager, DarwinBrewCaskManager.

• WSL workflow helpers

  • Actions to:
    • List installed / online distros,
    • Install a distro with optional custom location,
    • Export / import / move / unregister distros,
    • Shutdown and update WSL.

• Windows Terminal helpers

  • Apply consistent defaults (Night Owl scheme, JetBrains Mono font, opacity, elevation).
  • Add a dedicated Ubuntu profile with an icon.

• Curated documentation

  • Windows & Linux workflows, TV setup (Google TV + Stremio), home server (Ubuntu Server + KVM + Home Assistant), app shortcuts, and browser extensions, mirrored to a static site via mkdocs.

• Windows/WSL2 docs: here: windows_workflow_README. / Website

• Linux/WSL2 docs: here: README / website

• macOS docs: here: README / website

• TV setup docs: Read me about it here: README / website

• Home server / Home Assistant docs: here: README

• Apps setup docs: README / website

• Websites & Browser extensions docs: README / website

For Windows users: Why you should use WSL2? WSL2 enables users to run Linux applications and use command-line tools natively on their Windows machines. This integration allows users to enjoy the familiarity of Windows while simultaneously harnessing the power and flexibility of Linux. Also, a surprising number of Linux GUI apps can run on WSL. GUI applications are officially supported on WSL2 and referred to as WSLg(No installation required).

Within the domain of development, Unix-based systems such as Linux and macOS frequently garner attention. Nevertheless, the integration of WSL allows smooth coding alongside the utilization of Adobe and Microsoft products that may lack support on Linux. This flexibility, coupled with the ability to handle resource-intensive games beyond macOS capabilities, positions Windows-WSL as an enticing platform, ensuring a well-rounded computing experience for all users, regardless of their workplace constraints.

Based on your needs, you can choose your OS.

• add missing apps
• Some dotfiles integration (GlazeWM, aerospace, raycast...)
• Chezmoi integration

• Fix broken README one‑liners (curl/wget URLs to this repo) and update URL to main branch
• Update mkdocs.yml:

• Update UX/UI.
  • Display a checkmark when a package is installed.
• Add tests and CI coverage for:
  • Parsing packages.yaml.
  • Package manager factory mapping.
  • Windows/WSL command runner behavior.
  • Docker image to test Arch
  • Docker image to test Ubuntu
  • Docker image to test macOS

You can check the documentation (website).

Check the CONTRIBUTING.md file for more information.

Star History Chart