Skip to content

octobooth/machine-setup

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Booth Machine Setup

This repository contains setup scripts for configuring booth machines. The scripts install and configure Visual Studio Code, Visual Studio Code Insiders, GitHub CLI, VLC media player, and other necessary tools.

Features

  • Installs and configures Visual Studio Code and Visual Studio Code Insiders.
  • Installs GitHub CLI and a suite of GitHub CLI extensions.
  • Installs the GitHub Copilot CLI (copilot).
  • Installs the GitHub Copilot desktop app (via the github-copilot-app Homebrew cask on macOS; direct download from the github/app releases on Windows).
  • Installs the Microsoft Aspire CLI and registers its MCP server with Copilot CLI.
  • Installs Visual Studio Enterprise with Web + Azure + .NET desktop workloads (Windows only).
  • Registers MCP servers (Playwright, Microsoft Learn, Astro docs, Svelte docs, Aspire, Azure, Azure DevOps) in ~/.copilot/mcp-config.json. Node-based MCP servers (Playwright, Azure, Azure DevOps) are installed globally via npm install -g so they launch from their installed binaries rather than fetching via npx at runtime.
  • Configures VLC media player settings.
  • Sets up Progressive Web Apps (PWAs) for GitHub tools.
  • Creates a demo loader script to launch all required applications and sites.

Configuration

The configuration for the setup scripts is stored in the config.json file. You can customize the settings by modifying this file.

Setup Instructions

macOS

  1. Open a terminal and navigate to the repository directory.

  2. Run the setup script to configure the machine:

    ./setup.sh
  3. A script will be created on the Desktop to load up the necessary applications.

  4. Store any booth videos in the $HOME/videos folder for easier loading from VLC.

Windows

  1. Open PowerShell as an administrator.

  2. Navigate to the repository directory.

  3. Run the setup script to configure the machine:

    .\setup.ps1
  4. A script will be created on the Desktop to load up the necessary applications.

  5. Store any booth videos in the C:\Users\<YourUsername>\Videos folder for easier loading from VLC.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Post-setup configuration

Some integrations require values that the setup script can't guess for you:

Azure DevOps MCP server

The Azure DevOps MCP server needs your organization slug (e.g. contoso for https://dev.azure.com/contoso). Setup will prompt you for it once and cache the answer.

During setup:

Azure DevOps organization name (leave blank to skip the Azure DevOps MCP server)
> contoso
  • Enter your org slug to register the server.
  • Leave it blank to skip the server entirely (the rest of setup continues).
  • On re-runs, the prompt shows your cached value; press Enter to keep it, type a new value to change it, or - to clear it.

Non-interactive runs (CI, piped input, etc.) skip the prompt and either use the cached value or skip the server. To set the org without a prompt, export ADO_ORG=contoso (or ADO_ORG= to explicitly skip) before running setup.

State file: the cached value lives at ${COPILOT_HOME:-~/.copilot}/machine-setup-state.json (Mac/Linux) or %COPILOT_HOME%\machine-setup-state.json / %USERPROFILE%\.copilot\machine-setup-state.json (Windows). Edit or delete this file to change the cached answer outside setup.

Visual Studio (Windows)

Visual Studio is installed via the official Microsoft bootstrapper (vs_enterprise.exe) — not via winget — because winget only publishes manifests for VS 2017/2019/2022. The script downloads the latest Visual Studio 2026 Enterprise bootstrapper from https://aka.ms/vs/stable/vs_enterprise.exe (per the official command-line install docs) and runs it with the configured workloads.

To switch channels or editions, edit config.windows.visual_studio in config.json:

  • Insiders preview instead of stable: change bootstrapper_url to https://aka.ms/vs/insiders/vs_enterprise.exe
  • Different edition: swap to vs_professional.exe or vs_community.exe and update edition accordingly
  • Add/remove workloads: edit the workloads array using official workload IDs

install_path is used for the idempotency check; update it if you change edition (e.g. …\\2026\\Professional).

About

Scripts to make setting up booth machines easier for GitHub events

Topics

Resources

License

Stars

Watchers

Forks

Contributors