Skip to content
imchocomintPublic

Latest commit

 

History

87 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

Paperlike, dynamic wallpaper for Linux

A wrapper for mpv/mpvpaper.

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

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

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
  • Automatically use GPU rendering
  • Load playlist/anything from the Internet
  • Works on KDE Plasma (fuck that shit)
  • Additional start/stop/quit arguments

Installation & Usage

Dependencies: mpv, mpvpaper, ffmpeg, libmpv

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)"

Stop the wallpaper:

paperlike --stop

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

On Wayland, the wallpaper automatically pauses when a fullscreen window is detected.

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.

Releases

Contributors

Languages