Skip to content

imchocomint/paperlike

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

81 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Paperlike, dynamic wallpaper for Linux

Thanks weebp

This is a rewrite of weebp in Python. It is a wrapper for mpv/mpvpaper.

This rewrite is only compatitable with .mp4 files, athough indirectly supporting other formats through a convert feature.

This was written with the help of AI. Of course, I'm still the main contributer though.

Why, you ask? This offers argumentless switching (quite neat for people who do want to change their BG regularly) and more convenient feature.

Watch paperlike in action (Hyprland):

paperlike in action (Hyprland)

Roadmap

  • Works on Wayland (Hyprland; other untested)
  • Works on X11 (i3wm; others untested)
  • External arguments to mpv
  • Have a convert function for any other file type --> .mp4
  • Load playlist/anything from the Internet
  • Works on KDE Plasma (fuck that shit)

Installation & Usage (stable)

Dependencies: mpv, mpvpaper, ffmpeg

To compile mpvpaper: libmpv-dev (apt), mpv-libs-devel (dnf). Arch users need not to worry about this

wget https://github.com/imchocomint/paperlike/releases/download/dotone/install.sh
sudo ./install.sh

Launch

paperlike <your video file>

Same applies to the source Python file

The software defaults to rendering by CPU. External arguments is needed to use the GPU (see below).

There are demo files on the /demo-files/ directory. You can try them.

Launch arguments

paperlike <file> "(your mpv arguments go here)"

mpv arguments are available at their wiki. Some crucial arguments are added in the source code.

Here is how you can force to render by GPU (I'm defaulting to VAAPI protocol):

paperlike main.mp4 "--vo=gpu --hwdec=vaapi"

Install (development/debugging)

Currently no debugging version is active/live/available. The software will be in this form for a while.

For extended development, clone the repository. Install moviepy.

Issues

Currently our only issue is with KDE Plasma.