Skip to content

installation.md

Latest commit

 

History

History
98 lines (67 loc) · 2.33 KB

installation.md

File metadata and controls

98 lines (67 loc) · 2.33 KB

Installation

Requirements

  • Go 1.23+
  • webkit2gtk (GUI runtime)
  • gtk-layer-shell (animated wallpaper layer)
  • gstreamer, gst-plugins-good (video playback for animated wallpapers)
  • ffmpeg (video thumbnail and color extraction)
  • Node.js 18+ (build only)

Arch Linux (AUR)

yay -S aether
# or
paru -S aether

Debian / Ubuntu

Download the .deb package from the latest release:

sudo dpkg -i aether_*.deb
sudo apt-get install -f

The .deb package includes both aether and aether-wp binaries and pulls in all required dependencies automatically.

macOS

Requirements

  • Go 1.23+
  • Wails CLI (go install github.com/wailsapp/wails/v2/cmd/wails@latest)
  • Node.js 18+
  • ffmpeg (for video thumbnail and color extraction): brew install ffmpeg
  • Xcode Command Line Tools: xcode-select --install

Build

git clone https://github.com/bjarneo/aether.git
cd aether && make build

This builds aether as a macOS app in build/bin/. The animated wallpaper service (aether-wp) is Linux-only and is skipped on macOS.

Install

make install

This copies the app to /Applications/Aether.app or the binary to /usr/local/bin/aether.

Aether runs in standalone mode on macOS — theme files are generated but not applied system-wide. See Standalone Usage for integration details.

Build from Source

Arch Linux

sudo pacman -S go webkit2gtk gtk-layer-shell gstreamer gst-plugins-good ffmpeg

Debian / Ubuntu

sudo apt install golang libgtk-3-dev libwebkit2gtk-4.1-dev libgtk-layer-shell-dev \
  libgstreamer1.0-dev gstreamer1.0-plugins-good ffmpeg nodejs npm pkg-config

Note: Debian Bookworm and Ubuntu 22.04+ ship only webkit2gtk-4.1. The build system handles this automatically via the -tags webkit2_41 flag, so no manual workaround is needed.

Build

git clone https://github.com/bjarneo/aether.git
cd aether && make build

This builds two binaries to build/bin/:

  • aether — the main application
  • aether-wp — animated wallpaper service (.gif, .mp4, .webm)

Desktop Entry (Optional)

cp li.oever.aether.desktop ~/.local/share/applications/

Verify Installation

./build/bin/aether