{"id":28420025,"url":"https://github.com/melonencoder/simple-wallpaper-switcher","last_synced_at":"2026-05-23T11:04:35.185Z","repository":{"id":272652062,"uuid":"915956138","full_name":"MelonEncoder/simple-wallpaper-switcher","owner":"MelonEncoder","description":"Simple GUI for swaping wallpapers by utilizing wallpaper manager's cli interfaces.","archived":false,"fork":false,"pushed_at":"2025-05-27T14:41:51.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-05T03:14:59.355Z","etag":null,"topics":["cpp","sfml","simple","wallpaper-changer"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MelonEncoder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-01-13T07:16:01.000Z","updated_at":"2025-05-27T14:42:23.000Z","dependencies_parsed_at":"2025-01-15T21:44:15.434Z","dependency_job_id":"35463196-b708-41b8-8519-20882b002898","html_url":"https://github.com/MelonEncoder/simple-wallpaper-switcher","commit_stats":null,"previous_names":["ianseeingbeing/simple_wallpaper_swaper","ianseeingbeing/simple_wallpaper_switcher","melonencoder/simple_wallpaper_switcher","melonencoder/simple-wallpaper-switcher"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MelonEncoder/simple-wallpaper-switcher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MelonEncoder%2Fsimple-wallpaper-switcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MelonEncoder%2Fsimple-wallpaper-switcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MelonEncoder%2Fsimple-wallpaper-switcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MelonEncoder%2Fsimple-wallpaper-switcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MelonEncoder","download_url":"https://codeload.github.com/MelonEncoder/simple-wallpaper-switcher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MelonEncoder%2Fsimple-wallpaper-switcher/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262484088,"owners_count":23318392,"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":["cpp","sfml","simple","wallpaper-changer"],"created_at":"2025-06-04T23:40:34.007Z","updated_at":"2025-12-26T11:51:16.038Z","avatar_url":"https://github.com/MelonEncoder.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple Wallpaper Swaper\nAlmost all desktops environments and especially window managers should have some form of cli tool for switching wallpapers.\nThis GUI tool is designed to be desktop agnostic, allowing the user to choose how they switch their wallpaper.\nSWPS uses a configuration file to define its look and the commands for execution.\n\n## Code Dependencies\n- [SFML](https://www.sfml-dev.org/) \u003e= v3.0.0\n\n# Usage\n1. Create a config file using the info below.\n2. Run the program and you should see your wallpapers loaded.\n3. Move with VIM or Arrows Keys.\n4. Press enter to execute wallpaper command.\n\n## Config File\n```\nswps -c /path/to/config/file.conf\n```\n| VARIABLE    | DESCRIPTION | TYPE | DEFAULT |\n|---------|-------------|------|---------|\n| wallpaper_directory | The path to the wallpaper directory. | string | \"\" |\n| window_size | Size of the window. | int, int | 800, 600 |\n| exec | An array of commands to execute. Use {wp} to represent the wallpaper path. (put each command on new line if multiple) | string[] | [] |\n| column_count | Number of columns to display. | int | 3 |\n| inner_gaps | Gaps inbetween thumbnails. (vertical, horizontal) | int, int | 10 |\n| outer_gaps | Gaps between thumbnails and the window edge. (vertical, horizontal) | int, int | 25 |\n| outline_thickness | Size of wallpaper thumbnail borders on hover. | float | 2.0 |\n| outline_color | Wallpaper thumbnail border color. | [int8, int8, int8] | [255, 255, 0] |\n| background_color | Background color of window. | [int8, int8, int8] | [0, 0, 0] |\n\n# Example Configs\n### [Hyprland](https://hyprland.org/)\nLaunch via Hyprland configuration file: hyprland.conf\n```\nbind = $mainMod CONTROL, S, exec, swps -c ~/.config/hypr/swps.conf\n```\nswps.conf\n```\nwallpaper_directory = /home/usr/.config/hypr/bg/\n\noutline_thickness = 2.5\noutline_color = [255, 255, 0]\ninner_gaps = 15\ncolumn_count = 4\nexec = [\n    hyprctl hyprpaper preload {wp}\n    hyprctl hyprpaper wallpaper ,{wp}\n]\nbackground_color = [60, 90, 0]\n```\n------\n### [Sway](https://swaywm.org/)\nLaunch via the sway configuration file: config\n```\nbindsym Shift+s exec swps -c ~/.config/sway/swps.conf\n```\nswps.conf\n```\nwallpaper_directory = /home/usr/.config/sway/bg/\n\nexec = swaybg -i {wp} -m fill\n\nwindow_size = 700, 350\noutline_thickness = 4\noutline_color = [0, 255, 255]\nouter_gaps = 15, 50\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelonencoder%2Fsimple-wallpaper-switcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmelonencoder%2Fsimple-wallpaper-switcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmelonencoder%2Fsimple-wallpaper-switcher/lists"}