An open API service indexing awesome lists of open source software.

https://github.com/yangyus8/lwe

LWE is a Linux desktop app for browsing, managing, and applying Wallpaper Engine content.
https://github.com/yangyus8/lwe

appimage aur desktop-app dynamic-wallpaper linux linux-desktop live-wallpaper niri rust steam-workshop svelte tauri-app tauri-v2 tauri2 video-wallpaper wallpaper wallpaper-engine wallpaper-engine-linux wallpaper-manager wayland

Last synced: 3 days ago
JSON representation

LWE is a Linux desktop app for browsing, managing, and applying Wallpaper Engine content.

Awesome Lists containing this project

README

          


LWE logo


AUR lwe-git
AUR lwe
Quality Check
Prerelease
Stable release

# LWE

English | [简体中文](README_CN.md)

LWE is a Linux desktop app for browsing, managing, and applying Wallpaper Engine content.

It is designed for practical Linux migration workflows:

- Browse Workshop content in-app
- Import supported wallpapers into your local library
- Check compatibility before applying wallpapers
- Assign wallpapers to monitors in a desktop-oriented workflow

## Documentation

- Online documentation: https://yangyus8.top/lwe/
- Local documentation source: `docs/`
- Simplified Chinese documentation: https://yangyus8.top/lwe/zh/

## Tested desktop environment

LWE is currently tested on:

- Wayland session with `niri`

## Prerequisites

LWE relies on Wallpaper Engine content from Steam Workshop. To use it properly, make sure:

- Your Steam library owns Wallpaper Engine
- Steam client is installed on your device
- Wallpaper Engine client is installed on your device

## Workshop setup (Steam Web API key)

LWE Workshop features require a Steam Web API key configured in Settings.

- Open LWE `Settings` and fill in `Steam Web API Key`
- Without this key, in-app Workshop browsing/search will not work correctly

How to get a Steam Web API key:

- Official page: https://steamcommunity.com/dev/apikey
- You must sign in with your Steam account first

## Wallpaper support scope

First-release runtime focus:

- Video wallpapers

Not first-release runtime targets:

- Scene wallpapers (private format reverse engineering cost is currently too high)
- Web wallpapers (recognized for compatibility reporting, not primary runtime target)

## Installation

### Arch Linux (AUR)

- Stable package: `lwe`
- Development package: `lwe-git`

Install with your preferred AUR helper, for example:

```bash
yay -S lwe
```

or

```bash
yay -S lwe-git
```

### GitHub Releases

Pre-release and stable builds publish Linux artifacts:

- `.deb`
- `.rpm`
- `.AppImage`

Download from the repository Releases page.

## Contributor and agent notes

Contributor guidance is documented in `docs/contributing/guide.md` and published in the online documentation.