minimalistic-wallpaper-collection/README.md

# Minimalistic Wallpaper Collection

This is my collection of minimalistic, flat art, and colorful, digital nature wallpapers.

**Disclaimer:** None of these wallpapers were designed by me. Most of these wallpapers were found on [Reddit](https://www.reddit.com/r/wallpaper/) or the artists' DeviantArt or portfolio site.

## Wallpapers

To view a gallery of all 90+ wallpapers, [click here](https://minimalistic-wallpaper.herokuapp.com/)!

[![image](https://user-images.githubusercontent.com/20955511/148669884-c9ea7743-565c-4dc6-bc7e-57592536116e.png)](https://minimalistic-wallpaper.herokuapp.com/)

## API

The website also includes a random wallpaper API, so you can request random wallpapers from the collection using a web request.

To use the API, simply make a request to:

```md
https://minimalistic-wallpaper.herokuapp.com/?random
```

To get multiple random images at once, it is recommended to change the URL slightly to avoid caching. For example,

```md
https://minimalistic-wallpaper.herokuapp.com/?random=1
https://minimalistic-wallpaper.herokuapp.com/?random=2
https://minimalistic-wallpaper.herokuapp.com/?random=3
```

This API can be used for setting daily wallpapers on a mobile device by combining it with an app such as IFTTT.

## Contributing

All images appearing in the images directory contain the author (sometimes this is the original artist, for others, this is a Reddit user who shared the image or a website the image was found on in cases where the original artist is unknown) and the title or description of the wallpaper.

* If the artist is not properly attributed, feel free to open an issue or pull request for renaming the files to give the author the correct attribution
* New wallpapers may be suggested by opening a pull request, but as this is a personal wallpaper collection, it is up to my discretion whether or not the wallpaper will be accepted
* Issues and pull requests regarding improvements to the site or API are welcome