{"id":20894028,"url":"https://github.com/urpagin/dynamicwallpaper","last_synced_at":"2026-07-09T06:31:11.694Z","repository":{"id":255851315,"uuid":"849268610","full_name":"Urpagin/DynamicWallpaper","owner":"Urpagin","description":"A webui/sync program to change your wallpapers.","archived":false,"fork":false,"pushed_at":"2025-08-23T08:26:55.000Z","size":1723,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-06-05T01:17:32.387Z","etag":null,"topics":["arch-linux","background","client-server","docker","docker-compose","dynamic-background","feh","friends","fun","html","python","random","rest-api","rust","shell","sync","systemd","wallpaper","wallpapers","webui"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/Urpagin.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,"zenodo":null}},"created_at":"2024-08-29T09:38:47.000Z","updated_at":"2025-12-21T11:54:16.000Z","dependencies_parsed_at":"2024-09-07T13:47:02.183Z","dependency_job_id":"52208df5-949b-4293-b048-fe2e6a72783d","html_url":"https://github.com/Urpagin/DynamicWallpaper","commit_stats":null,"previous_names":["urpagin/dynamicwallpaper"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Urpagin/DynamicWallpaper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Urpagin%2FDynamicWallpaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Urpagin%2FDynamicWallpaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Urpagin%2FDynamicWallpaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Urpagin%2FDynamicWallpaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Urpagin","download_url":"https://codeload.github.com/Urpagin/DynamicWallpaper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Urpagin%2FDynamicWallpaper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35290235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["arch-linux","background","client-server","docker","docker-compose","dynamic-background","feh","friends","fun","html","python","random","rest-api","rust","shell","sync","systemd","wallpaper","wallpapers","webui"],"created_at":"2024-11-18T10:17:58.463Z","updated_at":"2026-07-09T06:31:11.676Z","avatar_url":"https://github.com/Urpagin.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DynamicWallpaper\n\nA web UI and synchronization program to change your wallpapers.\n\n(Yes, `rsync` is simpler and better. Anyway, it was fun to program DynamicWallpaper.)\n\n## Explanation 🧩\n\nThe server and web UI let users **add** and **delete** images.\n\nThe client sync tool should be run at intervals to keep local images in sync with the server. Then use any wallpaper program (such as `feh`) to set your wallpaper from the local collection.\n\n## Simply Put ✨\n\n* Upload images through the web UI. You can delete them too.\n* Run the client. Images from the server are synced to a local directory.\n* Use your favorite wallpaper tool to pick a random image from that local directory.\n\n## Why ❓\n\n* Learning opportunity.\n* Lets multiple computers and friends share the same wallpaper collection.\n\n# Installation 🧰\n\n## Server (Docker) 🐳\n\n\u003e [!TIP]\n\u003e For a non-Docker installation, follow the standard Rust build workflow inside the `server` directory. \u003ca href=\"https://doc.rust-lang.org/book/ch01-03-hello-cargo.html\" target=\"_blank\" rel=\"noopener\"\u003eClick here for more information\u003c/a\u003e.\n\n### Requirements\n\n* Docker and Docker Compose\n\n### Steps\n\n1. Clone the repo\n\n   ```bash\n   git clone https://github.com/Urpagin/DynamicWallpaper.git\n   ```\n\n2. Create a `.env` file next to `docker-compose.yml` and add:\n\n   ```env\n   PORT=\u003cexposed port\u003e\n   NGINX_USER=\u003cuser for web UI auth\u003e\n   NGINX_PASSWORD=\u003cpassword for web UI auth\u003e\n   ```\n\n3. Start the containers\n\n   ```bash\n   sudo docker compose up -d --build\n   ```\n\n\u003e [!TIP]\n\u003e The `--build` flag rebuilds the image so code updates are reflected.\n\n4. Open `http://127.0.0.1:\u003cPORT\u003e` to access the app.\n\n\u003e [!NOTE]\n\u003e Once the stack is running, the `wallpapers_server` directory will contain the wallpapers.\n\n## Client 🖥️\n\nThis part is a little more hazardous. You can try running `scripts/install_arch_linux_systemctl.py`. This script requires **systemd** and has been tested only on **Arch Linux**.\n\n\u003e [!NOTE]\n\u003e **Recommended approach**\n\u003e\n\u003e Build the `client` component manually (see the tip in the [Server (Docker) section](#server-docker)). Then copy `scripts/update_wallpaper_feh.sh` somewhere convenient, make it executable, and have it autostart.\n\u003e\n\u003e ```bash\n\u003e cargo build --release -p client\n\u003e chmod +x /path/to/update_wallpaper_feh.sh\n\u003e ```\n\u003e\n\u003e On X11, invoke the script from a startup file like `~/.xinitrc` or `~/.xsession`. On Wayland with Hyprland, add a line like `exec-once = /path/to/update_wallpaper_feh.sh \u0026` to `~/.config/hypr/hyprland.conf`.\n\nYou can also manually invoke the client binary directly with these arguments:\n\n\u003e [!NOTE]\n\u003e The example assumes you are protecting the server behind NGINX basic auth.\n\n```bash\n./client \\\n  --endpoint \"https://wallpapers.yourdomain.com\" \\\n  --directory \"/path/to/downloaded/images\" \\\n  --user \"\u003coptional basic auth user\u003e\" \\\n  --password \"\u003coptional basic auth password\u003e\"\n```\n\n## Security 🔒\n\nI am a beginner, so I cannot guarantee there are no vulnerabilities.\n\nThe provided Docker Compose setup includes a simple password-protected proxy using NGINX.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furpagin%2Fdynamicwallpaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furpagin%2Fdynamicwallpaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furpagin%2Fdynamicwallpaper/lists"}