https://github.com/probablyxs/backscene

BackScene lets you set video wallpapers on Windows 10 using MPV and weebp. Easy setup and configuration for a dynamic desktop experience with video backgrounds.
https://github.com/probablyxs/backscene

background-changer backscene custom-wallpaper desktop live-wallpaper livewallpaper media-player mpv open-source software video-wallpaper visualization wallpaper-engine webp weebp windows windows-10 windows-11

Last synced: 3 months ago
JSON representation

BackScene lets you set video wallpapers on Windows 10 using MPV and weebp. Easy setup and configuration for a dynamic desktop experience with video backgrounds.

• Host: GitHub
• URL: https://github.com/probablyxs/backscene
• Owner: ProbablyXS
• Created: 2024-08-30T18:58:33.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-12T13:07:24.000Z (over 1 year ago)
• Last Synced: 2025-01-11T20:41:02.363Z (over 1 year ago)
• Topics: background-changer, backscene, custom-wallpaper, desktop, live-wallpaper, livewallpaper, media-player, mpv, open-source, software, video-wallpaper, visualization, wallpaper-engine, webp, weebp, windows, windows-10, windows-11
• Language: C#
• Homepage:
• Size: 21.5 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# BackScene

BackScene is a tool designed to display video wallpapers on your Windows desktop background using MPV and weebp.



  





  

  

  

    

  

  

    

  

  

    

  



## Information

- **Drag and drop** to change the wallpaper folder.

## [CONFIG.INI]

[BackScene]

- display=0

- clean_memory=true

- show_logs=false

- start_minimized=true

- close_minimizes=true

- start_with_windows=true

- wallpaperPath=C:\Users\Admin\Videos\wallpapers\zidpVl1rabzWFWk_Yae Miko 4K Live Wallpaper.mp4

[Mpv]

- mute_audio=true

- shuffle=true

- play_at_startup=true

- limit_fps=true

- fps=30

- hardware_acceleration=true

- pause_on_fullscreen=true

## Showcase



  

  



## Features

- **Display video wallpapers** on your Windows desktop background.

- **Utilizes MPV** for video playback.

- **Uses weebp** for WebP image decoding.

##### BackScene Settings

- **Show logs**: Display the console logs.

- **Start minimized**: Start BackScene in a minimized state.

- **Close minimizes**: Close BackScene when minimized.

- **Clean memory**: Clean process memory for "BackScene" and "MPV".

- **Start with windows**: Launch BackScene at Windows startup.

##### MPV Settings

- **Mute audio**: Mute the audio for the video running.

- **Shuffle**: Start the video randomly from the playlist folders.

- **Play at startup**: Start MPV when BackScene is running.

- **Limit FPS**: Limit the frame rate of the video.

##### Systray Options

Right-click on the BackScene icon in the system tray to access the following options:

- **Start**: Start MPV video.

- **Stop**: Stop MPV video.

- **Next**: Play the next video.

- **Previous**: Play the previous video.

- **Play**: Play the current video.

- **Pause**: Pause the current video.

- **Mute**: Mute the video.

- **Unmute**: Unmute the video.

- **Show**: Display the BackScene program.

- **Settings**: Open the settings menu.

- **Help**: Open the GitHub page for help.

- **Exit**: Exit the program.

## Installation

### Prerequisites

- **Windows 11** (Tested environment)

- [MPV](https://mpv.io/)

- [weebp](https://github.com/Francesco149/weebp)

### Setup Instructions

1. **Clone the Repository**

   ```bash

   git clone https://github.com/yourusername/BackScene.git

## Crossfade Script (Optional)

You can enhance your wallpapers with a smooth **fade in/out + zoom + blur** effect using MPV scripts. Place the script in the `BackScene/tools/mpv/scripts/` folder.

### crossfade_clean.lua

```lua

-- crossfade_clean.lua

local fade_duration = 0.5

local zoom_factor = 1.03

local blur_strength = 1

local function apply_vf()

    local duration = mp.get_property_number("duration")

    if not duration then return end

    -- Clear existing video filters

    mp.commandv("vf", "clr")

    -- Calculate fade out start time

    local fade_out_start = duration - fade_duration

    -- Build filter chain

    local vf_str = string.format(

        "fade=t=in:st=0:d=%f,fade=t=out:st=%f:d=%f,scale=iw*%f:ih*%f,boxblur=%d:%d",

        fade_duration,

        fade_out_start,

        fade_duration,

        zoom_factor,

        zoom_factor,

        blur_strength,

        blur_strength

    )

    -- Apply filters

    mp.commandv("vf", "add", vf_str)

    mp.msg.info("Filtres appliqués proprement")

end

-- Apply filters when a file is loaded

mp.register_event("file-loaded", function()

    mp.add_timeout(0.2, apply_vf)

end)

mp.msg.info("crossfade_clean.lua actif")