{"id":22558979,"url":"https://github.com/m1cr0man/bgur","last_synced_at":"2025-10-30T12:44:31.688Z","repository":{"id":57504323,"uuid":"230771304","full_name":"m1cr0man/bgur","owner":"m1cr0man","description":"Desktop background wrapping Imgur favourites folders","archived":false,"fork":false,"pushed_at":"2023-11-05T22:53:37.000Z","size":59,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-02T12:18:26.845Z","etag":null,"topics":["desktop-background","desktop-background-setter","imgur","wallpaper-changer"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/m1cr0man.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":"2019-12-29T15:50:59.000Z","updated_at":"2023-11-05T22:53:39.000Z","dependencies_parsed_at":"2024-06-20T15:52:56.392Z","dependency_job_id":null,"html_url":"https://github.com/m1cr0man/bgur","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m1cr0man%2Fbgur","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m1cr0man%2Fbgur/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m1cr0man%2Fbgur/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/m1cr0man%2Fbgur/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/m1cr0man","download_url":"https://codeload.github.com/m1cr0man/bgur/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246025933,"owners_count":20711575,"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":["desktop-background","desktop-background-setter","imgur","wallpaper-changer"],"created_at":"2024-12-07T20:18:26.911Z","updated_at":"2025-10-30T12:44:26.633Z","avatar_url":"https://github.com/m1cr0man.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bgur - Desktop backgrounds without the effort\n\nHave you got a massive collection of desktop backgrounds favourited\non [imgur](https://imgur.com/)? Time to throw them into a folder and\nlet bgur do the magic to set them as your background.\n\n## Features\n\n- Set desktop background from imgur (you'd hope so at least. Macs untested)\n- Randomise backgrounds with anti-repeat logic\n- minratio + maxratio options to ignore mobile oriented photos on desktop\n- Syncing! Uses imgur, an album, and your own account - so no GDPR shenanigans\n- Caching so that it doesn't kill imgur (offline coming soon)\n\n## Usage\n\n- If you don't have one already, set up a favourites folder on imgur with all\nyour desktop backgrounds. Call it `Desktop Backgrounds` (optional). It can be\na mix of private images, public images and albums.\n- Alternatively, you can use a friend's folder. See the `-folder-owner` and\n`-folder-name` options\n- Install and run bgur\n```bash\ngo get github.com/m1cr0man/bgur\ngo build -o bgur github.com/m1cr0man/bgur/cmd/bgur\nchmod +x bgur # linux users\n```\n- Run bgur (basic usage)\n```bash\n./bgur -sync\n``` \n\n## Advanced usage\n\nYou can run `bgur -h` to get all the options correct to the version you installed.\nI have to update the below list manually, but if you are lazy you can reference this.\n\n```bash\nUsage of ./bgur:\n  -change-interval int\n        Minutes between background changes. Default is 12 hours (default 720)\n  -folder-name string\n        Name of the folder to pull desktop backgrounds from (default \"desktop backgrounds\")\n  -folder-owner string\n        Username who owns the backgrounds folder. Defaults to you\n  -force-change\n        Force a background change now. Overrides expiry\n  -max-ratio int\n        Maximum ratio of width:height, in percent. Use this for vertical screens, overrides minRatio\n  -min-ratio int\n        Minimum ratio of width:height, in percent. For example 160 which is 16:10\n  -refresh-cache\n        Refresh list of images from the folder on Imgur\n  -seed int\n        Seed to use for shuffling the folder. Set to 0 to skip shuffling (default 1577751173)\n  -sync\n        Sync state to Imgur so that the same backgrounds appear on other computers\n```\n\n## TODO\n\n- Auto building of the project\n- Logo\n- Work offline properly\n- A web UI, because not everyone is a CLI hero. This will not be an electron app.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm1cr0man%2Fbgur","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fm1cr0man%2Fbgur","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fm1cr0man%2Fbgur/lists"}