{"id":22620531,"url":"https://github.com/dbrennand/wallie-pwsh","last_synced_at":"2026-05-05T05:37:00.227Z","repository":{"id":43718712,"uuid":"237520660","full_name":"dbrennand/Wallie-Pwsh","owner":"dbrennand","description":"Wallie-Pwsh can update your desktop wallpaper on Windows 10","archived":false,"fork":false,"pushed_at":"2022-02-21T20:39:40.000Z","size":12,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-25T04:53:42.921Z","etag":null,"topics":["desktop-wallpaper","powershell","powershell-script","unsplash-api","wallie-pwsh","wallpaper-changer","windows","windows-10"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dbrennand.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":"2020-01-31T21:39:27.000Z","updated_at":"2022-02-21T20:38:15.000Z","dependencies_parsed_at":"2022-08-22T19:20:44.017Z","dependency_job_id":null,"html_url":"https://github.com/dbrennand/Wallie-Pwsh","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbrennand%2FWallie-Pwsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbrennand%2FWallie-Pwsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbrennand%2FWallie-Pwsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dbrennand%2FWallie-Pwsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dbrennand","download_url":"https://codeload.github.com/dbrennand/Wallie-Pwsh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246126720,"owners_count":20727594,"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-wallpaper","powershell","powershell-script","unsplash-api","wallie-pwsh","wallpaper-changer","windows","windows-10"],"created_at":"2024-12-08T22:14:13.210Z","updated_at":"2026-05-05T05:36:55.184Z","avatar_url":"https://github.com/dbrennand.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wallie-Pwsh\n\nWallie-Pwsh can update your desktop wallpaper on Windows 10 🖥️\n\n## Prerequisites\n\n1. Register an application with the [Unsplash API](https://unsplash.com/documentation#registering-your-application).\n\n2. Copy the **Access Key**.\n\n3. Launch a PowerShell terminal as administrator.\n\n4. Clone the repository:\n\n    ```powershell\n    git clone https://github.com/dbrennand/Wallie-Pwsh.git; cd Wallie-Pwsh\n    ```\n\n5. Create an `AccessKey.txt` file containing your Unsplash access key in encrypted format:\n\n    ```powershell\n    # Run the command below to stop the Unsplash access key being logged in PSReadline history\n    # Set-PSReadlineOption -HistorySaveStyle SaveNothing\n    $UnsplashAccessKeySecureString = ConvertTo-SecureString -String \"\u003cUnsplash access key\u003e\" -AsPlainText -Force\n    $Cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList \"Wallie-Pwsh\",$UnsplashAccessKeySecureString\n    $Cred.Password | ConvertFrom-SecureString | Out-File -FilePath \"$(pwd)\\AccessKey.txt\" -Force\n    ```\n\n## Usage\n\nWallie-Pwsh has an optional parameter to supply topics using `-Topics`.\nWhen supplied, a topic will be chosen at random and used in the query to the Unsplash API.\n\nExample usage of the `-Topics` parameter:\n\n```powershell\n.\\Wallie-Pwsh.ps1 -Topics \"Fish\",\"Space\",\"Trains\",\"Jets\" -AccessKeyFile \".\\AccessKey.txt\" -Verbose\n```\n\nIf the `-Topics` parameter is not provided, Wallie-Pwsh will query the `/photos/random` API endpoint for random images.\n\n### Updating the Desktop Wallpaper at Log In\n\nA use case for Wallie-Pwsh is to run it using Windows Task Scheduler at log in.\n\n\u003e [!NOTE]\n\u003e\n\u003e Make sure you enter the correct absolute paths to the [Wallie-Pwsh.ps1](Wallie-Pwsh.ps1) script and Unsplash access key file (using the `-AccessKeyFile` parameter).\n\u003e\n\u003e To get the absolute paths, run the following command in the Wallie-Pwsh directory:\n\u003e ```powershell\n\u003e (Get-ChildItem | Where-Object -FilterScript { $_.Name -match \"AccessKey|Wallie\" }).FullName\n\u003e ```\n\nConfigure Windows Task Scheduler to execute Wallie-Pwsh at log in:\n\n\u003e [!NOTE]\n\u003e\n\u003e Replace the values of the `-Topics` parameter in the command below or remove it.\n\n```powershell\n$Task = New-ScheduledTaskAction -Execute \"PowerShell.exe\" -Argument '-NoProfile -WindowStyle \"Hidden\" -ExecutionPolicy \"Bypass\" -Command absolute\\path\\to\\Wallie-Pwsh.ps1 -Topics \"Mountain\",\"Space\",\"Trains\" -AccessKeyFile \"absolute\\path\\to\\AccessKey.txt\" -Verbose'\n$Trigger = New-ScheduledTaskTrigger -AtLogOn\nRegister-ScheduledTask -RunLevel \"Highest\" -Action $Task -Trigger $Trigger -TaskName \"Wallie-Pwsh\" -Description \"Updates the desktop wallpaper at log in.\"\n```\n\n## Authors -- Contributors\n\n* **dbrennand** - *Author* - [dbrennand](https://github.com/dbrennand)\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbrennand%2Fwallie-pwsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdbrennand%2Fwallie-pwsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdbrennand%2Fwallie-pwsh/lists"}