minimalistic-wallpaper-coll.../README.md

41 lines
1.9 KiB
Markdown

# 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 100+ 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