{"id":26880828,"url":"https://github.com/raphaeltannous/pyprpaper","last_synced_at":"2025-05-07T22:23:16.811Z","repository":{"id":239815253,"uuid":"800956482","full_name":"raphaeltannous/pyprpaper","owner":"raphaeltannous","description":"Randomly change wallpaper for all monitors in hyprpaper.","archived":false,"fork":false,"pushed_at":"2024-11-05T19:27:02.000Z","size":46,"stargazers_count":7,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-18T06:51:08.514Z","etag":null,"topics":["hyprland","hyprpaper","python-script","python3","wallpaper-changer"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/raphaeltannous.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,"publiccode":null,"codemeta":null}},"created_at":"2024-05-15T10:20:05.000Z","updated_at":"2025-01-24T15:09:34.000Z","dependencies_parsed_at":"2024-05-15T15:42:41.818Z","dependency_job_id":"25c3d423-08d6-47fa-9d98-ed81508d5afa","html_url":"https://github.com/raphaeltannous/pyprpaper","commit_stats":null,"previous_names":["rofe33/pyprpaper","raphaeltannous/pyprpaper"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphaeltannous%2Fpyprpaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphaeltannous%2Fpyprpaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphaeltannous%2Fpyprpaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raphaeltannous%2Fpyprpaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raphaeltannous","download_url":"https://codeload.github.com/raphaeltannous/pyprpaper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252962928,"owners_count":21832426,"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":["hyprland","hyprpaper","python-script","python3","wallpaper-changer"],"created_at":"2025-03-31T14:39:57.136Z","updated_at":"2025-05-07T22:23:16.789Z","avatar_url":"https://github.com/raphaeltannous.png","language":"Python","readme":"# Pyprpaper\n\nPyprpaper  is  a   `hyprpaper`  client,  its  main\npurpose   is   to   change   wallpapers   randomly\n(for  given   set  of   monitors)  from   a  given\ndirectory(ies).\n\n## Features\n\n- Randomly change wallpapers for given monitors.\n- Recursive image look-up in all directories.\n- Timer to change wallpaper each n seconds.\n- Support for none-hyprpaper/hyprland setup.\n\n## Installation\n\nYou can install [pyprpaper](https://pypi.org/project/pyprpaper/) using `pip`:\n\n```sh\npip install pyprpaper\n```\n\nIt is also available in the AUR ([pyprpaper](https://aur.archlinux.org/packages/pyprpaper)) for the arch linux\nbtw users:\n\n```sh\n# With yay\nyay -S pyprpaper\n```\n\nThe `PKGBUILD` and `.SRCINFO` files are at\n[rofe33/pyprpaper-aur](https://github.com/rofe33/pyprpaper-aur).\n\n## Usage\n\n```\nusage: pyprpaper [-h] [-v] -m monitor1 monitor2 [monitor1 monitor2 ...]\n                 [-s SOCKET_PATH] [-k] [-K] [-r]\n                 [-f [additional file types ...]] [-t TIMER]\n                 path/to/directories [path/to/directories ...]\n\nA simple wallpaper changer.\n\npositional arguments:\n  path/to/directories   Path to directories containing the images.\n\noptions:\n  -h, --help            show this help message and exit\n  -v, --version         show program's version number and exit\n  -m monitor1 monitor2 [monitor1 monitor2 ...], --monitors monitor1 monitor2 [monitor1 monitor2 ...]\n                        Monitor(s) to change wallpapers on.\n  -s SOCKET_PATH, --socket-path SOCKET_PATH\n                        Override socket path.\n  -k, --keep-wallpapers-loaded\n                        Whether to keep wallpapers loaded in RAM or not.\n  -K, --keep-wallpapers-consistent\n                        Whether to randomly set the same wallpaper for all the\n                        monitors.\n  -r, --recursive       Whether to recursive get the images from the\n                        directories.\n  -f [additional file types ...], --additional-file-types [additional file types ...]\n                        Additional image file types.\n  -t TIMER, --timer TIMER\n                        Timer to change the wallpaper each n seconds\n\nAll The Glory To Jesus God...\n```\n\n### Example\n\nChange  wallpaper  for  all monitors in hyprland/hyprpaper set-up:\n\n```sh\npyprpaper -m $(hyprctl -j monitors | jq -r '.[].name' | tr '\\n' ' ') -- /path/to/wallpaper/directories\n```\n\n### My Hyprpaper/Pyprpaper setup\n\nI am  running hyprland/hyprpaper,  if you  are not\nusing hyprland things will defer depending on what\nyou are  using. However  `pyprpaper` will  work on\nany wayland compositor if you are using hyprpaper.\n\nYou  can  have  an  empty  `hyprpaper.conf`  setup\nand  just run  `pyprpaper` in  the `exec-once`  in\n`hyprland.conf`.\n\nMy current `hyprpaper.conf` config:\n\n```\nsplash = off\n```\n\nand in `hyprland.conf` I have:\n\n```\nexec-once = pyprpaper -t 600 -m $(hyprctl -j monitors | jq -r '.[].name' | tr '\\n' ' ') -- /path/to/directory(ies)\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphaeltannous%2Fpyprpaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraphaeltannous%2Fpyprpaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphaeltannous%2Fpyprpaper/lists"}