{"id":13437577,"url":"https://github.com/glouw/paperview","last_synced_at":"2025-05-16T09:02:48.682Z","repository":{"id":39538334,"uuid":"283962671","full_name":"glouw/paperview","owner":"glouw","description":"A high performance X11 animated wallpaper setter","archived":false,"fork":false,"pushed_at":"2023-03-05T06:23:27.000Z","size":268,"stargazers_count":1469,"open_issues_count":20,"forks_count":47,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-04-09T03:13:09.147Z","etag":null,"topics":["animated","desktop","linux","sdl2","wallpaper","x11"],"latest_commit_sha":null,"homepage":"https://glouw.com/2020/08/02/Paperview.html","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/glouw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-07-31T06:41:50.000Z","updated_at":"2025-03-30T17:55:39.000Z","dependencies_parsed_at":"2024-03-16T16:37:01.970Z","dependency_job_id":"e9e8a4f8-e564-4ba6-811b-44d40edcb8b6","html_url":"https://github.com/glouw/paperview","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glouw%2Fpaperview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glouw%2Fpaperview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glouw%2Fpaperview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/glouw%2Fpaperview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/glouw","download_url":"https://codeload.github.com/glouw/paperview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254501549,"owners_count":22081527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animated","desktop","linux","sdl2","wallpaper","x11"],"created_at":"2024-07-31T03:00:58.452Z","updated_at":"2025-05-16T09:02:48.661Z","avatar_url":"https://github.com/glouw.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"# PAPERVIEW\n\nPaperview is a high performance animated desktop background setter for Linux and X11.\n\n![](screenshot.png)\n\nVideo of the above screenshot: https://www.youtube.com/watch?v=6ZTiA885bWM\n\n## Build\n\n    make # NOTE: SDL2 is required\n\n## Single Monitor Use\n\n    ./paperview FOLDER SPEED\n\nA lower SPEED number will result in a faster frame rate. Only BMP files are supported.\n\n## Multi Monitor Use\n\nPaperview supports any number of monitors with its dynamic parameter list:\n\n    ./paperview FOLDER SPEED X Y W H FOLDER SPEED X Y W H # ... And so on\n\nThe values X, Y, W (width), H (height) are integers and represent a rectangle with pixel\ndimensions specifying where the wallpaper animation will be placed.\nFor instance, with a 1366x768 monitor on the left and a 1920x1080 monitor on the right,\nthe following command will animate the left monitor with a cat animation,\nand the right, a river animation:\n\n    ./paperview \\\n        ~/scenes/cat   5    0   0 1366  768 \\\n        ~/scenes/river 5 1366   0 1928 1080\n\n## Running Background Daemon\n\nAppend an (\u0026) to a paperview command to have it run as a background process. Eg:\n\n    ./paperview FOLDER SPEED \u0026\n\nTo stop this backgroud process, use `killall`:\n\n    killall paperview\n\n## Creating Custom Scenes\n\nCreating a custom BMP scene folder from a GIF requires imagemagick.\nFor example, to create a castle scene folder from a castle.gif:\n\n    mkdir castle\n    mv castle.gif castle\n    cd castle\n    convert -coalesce castle.gif out.bmp\n    rm castle.gif\n\n## Random Animated Wallpapers at Startup\n\nAssuming a scenes folder containing a number of scene folders is present in the home folder,\nrun the following snippet as a background process within .xinitrc before running `startx`,\nor simply execute it after X11 is running:\n\n    while true\n    do\n        scene=$(ls -d ~/scenes/*/ | shuf -n 1)\n        timeout 600 paperview $scene 5 # See Multi-Monitor Use above for multiple monitor support\n    done\n\n## Performance\n\nRunning on a Thinkpad X230 from 2012 at 1920x1080 and 60fps with an integrated Intel GPU:\n\n    intel_gpu_time ./paperview castle 5\n\n    user: 1.904135s, sys: 0.357277s, elapsed: 100.458648s, CPU: 2.3%, GPU: 11.7%\n\n## Known Issues\n\nPicom, Compton (and possibly other compositors) seem to already write to the base root X11 window\nwhich may overwrite the render done by paperview.\n\n## Alternatives\n\nAlternatively, if SDL2 is a problem, or if you are on Windows, two workarounds are currently available:\n\n### Pure X11 (without SDL2)\n\nhttps://gist.github.com/AlecsFerra/ef1cc008990319f3b676eb2d8aa89903\n\n### Windows 10\n\nhttps://github.com/TrAyZeN/sdl-wallpaper\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglouw%2Fpaperview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglouw%2Fpaperview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglouw%2Fpaperview/lists"}