StreamDeck-Animated-Screensaver

KO | EN

gitlite — search

#hacktoberfest #typescript #golang #linux #docker #macos #nodejs #java #windows #awesome #awesome-list #mcp #openai #open-source

StreamDeck-Animated-Screensaver

(★ 21)

Convert videos to Elgato Stream Deck preset files to be used as a screensaver

StreamDeck-Animated-Screensaver Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Stream Deck Animated Screensaver

This project allows you to create an animated wallpaper that you can set up on your Elgato Stream Deck as a preset, and switch to it using a button. This is the same as the screensavers that you can get on the [Elgato Marketplace](https://marketplace.elgato.com/stream-deck/screensavers), but you can use your own videos with this project.

Any video format that ffmpeg understands is supported. Any video height or width should work, however the script is designed to work best with 5:3 aspect ratio (or 2:1 on StreamDeck XL). I've tested as many edge cases as I could think of, but if you have a video that is failing to process, please let me know by opening an issue.

## How this works

This script generates a fully compatible Stream Deck preset file where each key is a "Switch Preset" action that's set to switch to the next preset, and each key's icon is an animated `.webp` file that's taken from the source video. `.webp` is used as that's what the Elgato app converts `.gif` files to, meaning we can achieve a much higher quality for the resulting video and remove unnecessary conversions.

**Please note** that pressing any buttons while the screensaver is active will automatically switch to the next preset, so you'll want to ensure that the screensaver is last in the preset list.

If this isn't desired, you can manually change which preset is used for each key in the Stream Deck app. Advanced users can also modify all `ProfileUUID` values in `template/91EBCF7F-C727-43EF-BE2F-58EE5B617867.sdProfile/Profiles/CS3KF237953I337M0QTB32DD3KZ/manifest.json` to contain the ProfileUUID of your preferred preset, which you can find by exporting a preset that contains a "Switch Profile" button with your desired preset. The presets that the Elgato app saves are just ZIP archives with JSON files inside.

## Usage

### Windows (and Linux)

[Set up WSL and install Ubuntu from the Windows Store](https://ubuntu.com/tutorials/install-ubuntu-on-wsl2-on-windows-11-with-gui-support#1-overview), then once that's done, run these commands:

```sh
sudo apt update
sudo apt install --no-install-recommends wslu
sudo apt install ffmpeg p7zip-full git
git clone https://github.com/illixion/StreamDeck-Animated-Screensaver.git
cd StreamDeck-Animated-Screensaver

# Put the video on your desktop and change video.mp4 to the correct file name
./elgatoscreensaver.sh "$(wslpath "$(wslvar USERPROFILE)")/Desktop/video.mp4"

# To move the resulting file back to your Desktop:
mv *.streamDeckProfile $(wslpath "$(wslvar USERPROFILE)")/Desktop/
```

To generate a screensaver for Stream Deck XL, add the `XL` argument at the end of the command like this:
```sh
./elgatoscreensaver.sh "$(wslpath "$(wslvar USERPROFILE)")/Desktop/video.mp4" XL
```

### macOS

Install [Homebrew](https://brew.sh), then run these commands:

```sh
brew install ffmpeg 7z git
git clone https://github.com/illixion/StreamDeck-Animated-Screensaver.git
cd StreamDeck-Animated-Screensaver

./elgatoscreensaver.sh /path/to/video.mp4

# You can also drag the file into the terminal window to paste the path

# To open the resulting file:
open *.streamDeckProfile
```

To generate a screensaver for Stream Deck XL, add the `XL` argument at the end of the command like this:
```sh
./elgatoscreensaver.sh /path/to/video.mp4 XL
```

The resulting preset file will be saved in the **same folder as the script**, which you can then open using the Elgato Stream Deck software, and assign a "Switch Profile" action to switch to the preset containing the screensaver.

## Licensing

This project is licensed under [MIT](https://github.com/illixion/StreamDeck-Animated-Screensaver/blob/main/LICENSE.txt).

StreamDeck-Animated-Screensaver

StreamDeck-Animated-Screensaver Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

StreamDeck-Animated-Screensaver

StreamDeck-Animated-Screensaver Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README