Video-to-Plasma-SplashScreen

A solution that can easily convert your .mp4 video to KDE Plasma Splash Screen!

English | 简体中文

---

1. Dependency

• Arch Linux

sudo pacman -S qt5-base qt5-declarative qt5-quickcontrols ffmpeg jq

---

2. User Guide

• Step 1: clone this project to your device

git clone https://github.com/ziheng5/Video-to-Plasma-SplashScreen

• Step 2: use the create.sh

cd Video-to-Plasma-SplashScreen
bash ./create.sh

• Step 3: enter correct variables according to the tips on your shell

== ✨ Video to Plasma Splash Screen ✨ ==

[INFO] Checking dependencies...
[OK] ffmpeg
[OK] jq
[1/7] Author name: author1
[2/7] Work name: work1
[3/7] MP4 video path (enter 'exit' to exit): /home/lengyu/Videos/megma.mp4
[OK] Video found
[4/7] Clip range (hh:mm:ss~hh:mm:ss, less than 5 seconds recommended): 00:00:00~00:00:04
[5/7] FPS (30~120 recommended): 60
[6/7] Width scale (1920 recommended): 1920
[7/7] Preview image:
      1) Auto-generate from video
      2) Use custom png
      3) Skip
Choose [1/2/3] (default: 1): 1

Generation summary:
  Author:  author1
  Work:    work1
  Output:  /home/lengyu/.local/share/plasma/look-and-feel/author1.work1
  Video:   /home/lengyu/Videos/megma.mp4
  Clip:    00:00:00 ~ 00:00:04
  FPS:     60
  Width:   1920
  Preview: auto-generate from video

Continue? [Y/n]: Y
[INFO] Creating theme directory...
[OK] Theme directory created
[INFO] Extracting video clip...
[OK] Video clip extracted
[INFO] Generating palette...
[OK] Palette generated
[INFO] Generating GIF...
[OK] GIF generated
[INFO] Writing theme metadata...
[OK] Theme metadata written
[OK] Preview image generated

[DONE] Your splash screen has been created:
       /home/lengyu/.local/share/plasma/look-and-feel/author1.work1

Parameter descriptions:

• author_name: Author's name.
• work_name: Name of the splash screen work.
• mp4 video path: Path to the .mp4 video to be converted.
• period: Time range for the video clip to be extracted; format: hh:mm:ss~hh:mm:ss. A duration of less than 5 seconds is recommended.
• FPS: Frame rate for the generated splash screen; recommended range: 30–120.
• scale: Width scaling parameter for the splash screen; recommended value: 1920.
• preview image: Preview image mode. You can auto-generate it from the video, use a custom .png, or skip it.

• Step 4: Enable the splash screen in System Settings

Once generation is complete, you can find and enable the splash screen you created here:

System Settings > Colors & Themes > Splash Screen > your_work_name

The directory for the generated work is located at:

~/.local/share/plasma/look-and-feel/your_work_name

If you chose to skip the preview image in Step 7, you can manually place the image at the following path later:

~/.local/share/plasma/look-and-feel/your_work/contents/previews/splash.png

Note: The preview image filename must be splash.png.