🌐 Supported Environments

Spacecraft Software is designed to be a ubiquitous, cross-platform experience. It provides configurations and installation scripts for the following environments:

Desktop Environments & Window Managers (Linux)

• GNOME: (GTK4/Libadwaita)
• KDE Plasma: .colors scheme
• COSMIC DE: .ron configuration
• XFCE4 & MATE: GTK3 overrides & Metacity/Xfwm4
• LeftWM & Niri: Tiling WM configurations

Terminals & Shells

• Starship Prompt: Cross-shell configuration
• POSIX Shells: bash, zsh, fish, csh, tcsh
• Modern Shells: nu, ion (Redox OS)
• Linux TTY: TrueColor hex overrides

Developer Tools & Applications

• Editors: VS Code, JetBrains IDEs
• Browsers: Chrome, Edge, Firefox
• Productivity: Microsoft Office (VBA Macros)
• Deployment: Flatpak, Snap, AppImage support

🚀 Installation Guide

We have provided automated POSIX-compliant shell scripts to deploy the theme across Linux/Unix systems, alongside manual templates for Windows and specialized software.

1. Linux / Unix (Automated)

The easiest way to apply Spacecraft Software to your Linux desktop, window managers, and browsers is using the all-in-one script.

git clone https://github.com/Spacecraft-Software/Theme.git
cd Spacecraft-Software/Scripts
./install-spacecraft-software.sh

This script will:

• Install the Spacecraft Software GTK theme (GNOME, XFCE, MATE, COSMIC).
• Apply the .colors scheme to KDE Plasma.
• Set up the Starship prompt configuration.
• Install terminal color presets (Alacritty, Kitty, Konsole, Windows Terminal).
• Apply browser theme extensions (Chrome, Edge, Firefox).
• Configure LeftWM and Niri tiling window managers.
• Apply Linux TTY TrueColor overrides.

🪟 Windows Installation

For Windows users, we provide:

• Microsoft Office: VBA macros to recolor Word, Excel, and PowerPoint.
• Windows Terminal: JSON templates for the Spacecraft Software color scheme.

🛠️ Manual Installation

If you prefer to install components individually, follow the instructions below.

Desktop Environments & Window Managers

GNOME (GTK4/Libadwaita)

1. Copy the spacecraft-software-dark folder to ~/.themes/.
2. Run: gsettings set org.gnome.desktop.interface gtk-theme 'spacecraft-software-dark'

KDE Plasma

1. Copy the spacecraft-software.colors file to ~/.local/share/color-schemes/.
2. Go to System Settings > Appearance > Colors > Import.

COSMIC DE

1. Copy the spacecraft-software.ron file to ~/.config/cosmic/themes/.
2. Run: cosmic-settings theme set spacecraft-software

XFCE4 & MATE

1. Copy the spacecraft-software-dark folder to ~/.themes/.
2. Run: xfconf-query -c xsettings -p /Net/ThemeName -s "spacecraft-software-dark"

Tiling WMs (LeftWM/Niri)

• LeftWM: Copy spacecraft-software.toml to ~/.config/leftwm/themes/.
• Niri: Copy spacecraft-software.ron to ~/.config/niri/themes/.

Terminals & Shells

Starship Prompt

Add the following to your shell profile (~/.bashrc, ~/.zshrc, etc.):

eval "$(starship init bash)"

POSIX Shells (Bash, Zsh, Fish)

Source the spacecraft-software.sh script in your shell profile:

source /path/to/Spacecraft-Software/Scripts/spacecraft-software.sh

Nushell

Add to your env.nu or config.nu:

source /path/to/Spacecraft-Software/Scripts/spacecraft-software.nu

Ion (Redox OS)

Add to your ion.rc:

source /path/to/Spacecraft-Software/Scripts/spacecraft-software.ion

Linux TTY

Run the TTY installation script:

sudo ./install-tty-colors.sh

Developer Tools & Applications

VS Code

Install the Spacecraft Software extension from the VS Code Marketplace.

JetBrains IDEs

1. Copy spacecraft-software.theme to ~/.config/JetBrains/<VERSION>/colors/.
2. Select it in Settings > Editor > Color Scheme.

Browsers (Chrome / Edge / Firefox)

Install the Spacecraft Software theme from the respective extension stores (Chrome Web Store / Firefox Add-ons).

Microsoft Office (VBA)

1. Open Word/Excel/PowerPoint and press Alt+F11.
2. Insert a new module and paste the contents of Spacecraft-Software-Office-Theme.bas.
3. Run the Apply_Spacecraft_Software_Theme macro.

Sandboxed & Containerized Apps

• Flatpak: flatpak override --user --env=GTK_THEME=spacecraft-software-dark
• Snap: snap set-theme spacecraft-software-dark
• AppImage: Set GTK_THEME=spacecraft-software-dark before execution.