# Minimalistic Wallpaper Collection

[![images](https://custom-icon-badges.herokuapp.com/github/directory-file-count/DenverCoder1/Minimalistic-Wallpaper-Collection/images?label=images&logo=image)](https://github.com/DenverCoder1/Minimalistic-Wallpaper-Collection/tree/main/images)
[![license](https://custom-icon-badges.herokuapp.com/github/license/denvercoder1/custom-icon-badges?logo=file-badge&logoColor=white&label=code+license&color=success)](https://github.com/DenverCoder1/Minimalistic-Wallpaper-Collection/blob/main/LICENSE)
[![discord](https://custom-icon-badges.herokuapp.com/discord/819650821314052106?color=7289DA&logo=comments&label=discord&logoColor=white)](https://discord.gg/fPrdqh3Zfu)

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 200+ wallpapers, [click here](https://minimalistic-wallpaper.herokuapp.com/)!

[![screenshot](https://user-images.githubusercontent.com/20955511/186479660-475532e8-427d-4df1-a19d-7f94090805b1.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