https://github.com/spencerwooo/bannero
An image API for simpledesktops.com
https://github.com/spencerwooo/bannero
api blog image image-hosting
Last synced: about 1 year ago
JSON representation
An image API for simpledesktops.com
- Host: GitHub
- URL: https://github.com/spencerwooo/bannero
- Owner: spencerwooo
- License: mit
- Created: 2018-07-29T12:49:57.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2019-04-20T10:34:58.000Z (about 7 years ago)
- Last Synced: 2025-04-01T03:17:32.170Z (over 1 year ago)
- Topics: api, blog, image, image-hosting
- Language: Python
- Homepage: https://bannero.herokuapp.com/
- Size: 630 KB
- Stars: 34
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Bannero API
🚀🥇🗳
Simple random banner pictures for blogs, websites and more.
[](https://bannero.herokuapp.com/)
**I'm BACK!**
## What is Simple Desktops?
Simple Desktops is ...
> A collection of wallpapers designed to make your computer beautiful without distraction.
Personally, I really like the design and simplicity of the images Simple Desktops provide. So I really wanted to put those on my blog, or other web pages. So I whipped up this API to randomize an image that I can easily embed in my blog posts.
## Usage
Embed the following code into your desired places. Don't worry about `https` support, API's `GET` method is served over `https`, and all redirected image links are served over `https` too. 🐱👤
**1. Plain URL**
```html
https://bannero.herokuapp.com
```
**2. Markdown**
```html
```
**3. HTML**
```html
```
Images are reloaded and randomized with every refresh.
## Does it look nice?
Of course.
Contributions are welcome.
## Building
- Install Python 3
- Install `pipenv`, then run:
```bash
pipenv install
```
- Go into Python virtual environment:
```bash
pipenv shell
```
- Run server at `localhost:9000`
```bash
python src/api.py
```
## Acknowledgements
- Images at Simple Desktops are for personal use and for personal use only. They shouldn't be sold or reposted without the expressed written consent of the desktop creator. See [Simple Desktops](http://simpledesktops.com/about/) for more details.
- A huge thank you to SM.MS for providing such a stable and awesome image hosting service.
- **App is proudly served at Heroku.**
---
**🚀 Bannero API** ©Spencer Woo. Released under the MIT License.
Created, authored and maintained by Spencer Woo.
[@Blog](https://spencerwoo.com/) · [ⒿJike](https://web.okjike.com/user/4DDA0425-FB41-4188-89E4-952CA15E3C5E/post) · [@GitHub](https://github.com/spencerwooo)