https://github.com/thelogicmaster/sdh-animationchanger

A Steam Deck Homebrew plugin for changing and randomizing boot/suspend animations
https://github.com/thelogicmaster/sdh-animationchanger

boot-animation homebrew steamdeck

Last synced: about 1 month ago
JSON representation

A Steam Deck Homebrew plugin for changing and randomizing boot/suspend animations

• Host: GitHub
• URL: https://github.com/thelogicmaster/sdh-animationchanger
• Owner: TheLogicMaster
• License: other
• Created: 2022-10-08T00:20:44.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-08T21:08:55.000Z (9 months ago)
• Last Synced: 2024-04-08T23:07:42.170Z (9 months ago)
• Topics: boot-animation, homebrew, steamdeck
• Language: TypeScript
• Homepage:
• Size: 648 KB
• Stars: 52
• Watchers: 4
• Forks: 9
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Animation Changer

This is a Steam Deck Homebrew plugin for easily changing boot/suspend animations and randomizing

on boot.

![screenshot](./assets/screenshot.png)

## Plugin Usage

Use the plugin's animations browser to automatically browser and install animations from

[SteamDeckRepo](https://steamdeckrepo.com/). For now, only boot animations are available automatically. 

From the quick access menu, you can switch between animations or enable randomization on boot.

Ensure that the Startup Movie is set to `deck_startup.web` in the Settings Customization tab for

the custom animation to take effect.

## Fullscreen Suspend Animations

To get support for fullscreen suspend animations, check out the 

[CssLoader](https://github.com/suchmememanyskill/SDH-CssLoader) plugin with the `Full Suspend` theme.

## Manual Usage

This plugin looks in `~/homebrew/animations` for directories containing sets of webm animation videos.

For example, directory `~/homebrew/animations/Test`, which could contain any or all of the three 

animation types.

The name of the directory is used as the animation label and each directory takes an optional

`config.json`. This allows specifying a relative path to each animation if different

from the default names. An empty string `""` or a missing file means to revert to the stock

animation when changing sets (Animation sets not implemented yet). `null` can be used to leave

the existing animation.

Press the reload button in the plugin's quick access menu page for manually added animations

to be detected. 

Example `config.json` configuration (Using default file names):

```json

{

   "boot": "deck_startup.webm",

   "suspend": "deck-suspend-animation.webm",

   "throbber": "deck-suspend-animation-from-throbber.webm"

}

```

`"boot"` refers to the main boot animation, `"suspend"` refers to the suspend animation played when

not in a game, and `"throbber"` refers to the animation played when suspending from in-game.

## Internals

- The main config file and downloaded animations are stored in `~/.config/AnimationChanger/`

- View the current log file at `/tmp/animation_changer.log`

- Animations get enabled by creating symlinks in the override directory, `~/.steam/root/config/uioverrides/movies`

## Building

Install pnpm and run `pnpm i` in the repo directory. Build with: `pnpm run build`. Copying the

project to the SDH plugins directory ~/homebrew/plugins at this point will install it. The VSCode

task does this cleanly without any unnecessary files and handles file permissions.