Black Lives Matter. Support the Equal Justice Initiative and read our statement here.


Cross-platform app to change wallpaper automatically.


A cross-platform app for changing wallpaper


Erin has been created as an attempt to solve just one seemingly easy and, as I figured out later on, fairly common problem: getting used to your desktop wallpaper way too quickly while downloading them manually being too big of a hassle. If one's a software engineer, it's their moral duty to spend 100+ hours trying to automate a task that would take 10 minutes to complete manually in the worst of conditions, so that's exactly how Erin was born.


Dark Main Screen Light Main Screen
Dark Picker Screen Light Picker Screen
Dark Settings Screen Light Settings Screen
Dark Info Screen Light Info Screen


Download an installation file corresponding to your OS from GitHub releases

Get it from the Snap Store


Main technologies used in the project:

  • Typescript
  • React
  • Electron
  • Redux toolkit

Local setup


Copy the repository using the following command:

git clone

Include your own .env file (or use the existing one) in the electron directory which has to contain the following variables:

  • WEATHER_API_KEY (OpenWeatherMap API is supported by default, in case of using another API you have to:
  • GH_TOKEN (optional, but auto-updater won't work without it)

Steps to run locally

  • Install dependencies: yarn install
  • Run react app: yarn react-start
  • Transpile electron code: yarn electron-compile
  • Run electron app: yarn electron-start

Commands to build the app on each platform

  • Windows: yarn build-win
  • Linux: yarn build-linux
  • MacOS: yarn build-mac
  • All three: yarn build-mwl

Something missing? Edit this app.

Keyboard Shortcuts

Key Action
/ Focus the search bar
Esc Focus the search bar and cleans it
Select the next search result
Select the previous search result
Enter Open the selected search result
cmdEnter Ctrl+Enter Open the selected search result in a new tab