{"id":23069744,"url":"https://github.com/jaumesegarra/ranwall2-app","last_synced_at":"2026-04-09T11:37:52.429Z","repository":{"id":56139006,"uuid":"163215030","full_name":"jaumesegarra/ranwall2-app","owner":"jaumesegarra","description":"Discover new wallpapers and set them to your desktop with a click.","archived":false,"fork":false,"pushed_at":"2020-11-28T14:03:58.000Z","size":18070,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-08T23:26:50.392Z","etag":null,"topics":["app","desktop","discover","electron","hooks","macos","react","wallpaper","windows"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jaumesegarra.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}},"created_at":"2018-12-26T20:24:51.000Z","updated_at":"2019-03-15T00:21:41.000Z","dependencies_parsed_at":"2022-08-15T13:21:13.384Z","dependency_job_id":null,"html_url":"https://github.com/jaumesegarra/ranwall2-app","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaumesegarra%2Franwall2-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaumesegarra%2Franwall2-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaumesegarra%2Franwall2-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jaumesegarra%2Franwall2-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jaumesegarra","download_url":"https://codeload.github.com/jaumesegarra/ranwall2-app/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246981136,"owners_count":20863825,"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":["app","desktop","discover","electron","hooks","macos","react","wallpaper","windows"],"created_at":"2024-12-16T06:16:51.580Z","updated_at":"2025-12-30T23:09:52.370Z","avatar_url":"https://github.com/jaumesegarra.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"ranwall\r\n====================================\r\nAre you tired of your bored wallpaper :expressionless:? \u003cbr /\u003e \u003cbr /\u003e\r\nWith ranwall you can discover more than millions wallpapers just doing a click :open_mouth:, if you liked any you can set it to your desktop with an other click. **EASY** :sunrise_over_mountains:! \r\n\r\n![Screenshoot](screenshoot.png)\r\n\r\n## Usage\r\nLaunch the app and see the random wallpaper, if you liked it click on 'set' button; if you liked it so much click on download :arrow_down: icon to save as image.\r\nOops you don't like it, well click on refresh button to try with another wallpaper.\r\n\r\n###### Command\r\nYou can also change the wallpaper with a single command: (`Cmd+Shift+W` on MacOS, `Win+Shift+W` on Windows) but beware of the background you had before. \r\n\r\n###### Custom Providers\r\n**WARNING**: This feature is experimental and insecure because the file described below executes javascript code within the app itself. Anyone could access the file and modify it with malicious code.\r\n\r\nFor this reason the use of methods within the file has been limited, for example: window, require, document, alert, etc ...\r\n\r\n---\r\n\r\nNow you can define your own providers based in a json file. Steps:\r\n\r\n**1.** Enable this option (Configuration -\u003e Advanced options -\u003e Custom providers) marking this checkbox. \r\n\r\n**2.** Open the config. file (click in the button \"OPEN FILE\").\r\n\r\n**3.** Write the provider configuration inside the `[]`, for example:\r\n```javascript\r\n{\r\n\t\"code\": \"UNSNATU\",\r\n\t\"name\": \"unsplash.com: Nature\",\r\n\t\"url\": res =\u003e `https://source.unsplash.com/random/${res[0]}x${res[1]}?nature,water`,\r\n\t\"get\": {\r\n\t\t\"type\": \"image\"\r\n\t}\r\n}\r\n```\r\n**Note**: Code must be unique.\r\n\r\nIf the response will be return as json, set `\"type\": \"json\"` and create new property on \"get\" similar to:\r\n\r\n```javascript\r\n\"imgPath\": data =\u003e {\r\n\treturn data.wallpaper.url_image\r\n}\r\n```\r\nPaving the way to access to the download url of image.\r\n\r\nIf bearer token is required reate new property on \"get\" similar to:\r\n\r\n```javascript\r\n\"auth\": {\r\n   \"bearer\": \"BEARER_HERE\"\r\n}\r\n```\r\n\r\n## Download\r\nDownload latest version from [here](https://github.com/jaumesegarra/ranwall2-app/releases) (Only for Windows and macos at the moment)\r\n\r\n## Thanks to:\r\n* [picsum.photos](https://picsum.photos)\r\n* [unsplash.com](https://unsplash.com)\r\n* [desktoppr.co](https://www.desktoppr.co)\r\n* [loremFlickr.com](https://loremFlickr.com) \r\n* [splashbase.co](http://www.splashbase.co) \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaumesegarra%2Franwall2-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaumesegarra%2Franwall2-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaumesegarra%2Franwall2-app/lists"}