aey/placeany
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
16 commits 1 branch 0 tags 52 KiB
HTML 64.6%
Python 31.7%
Dockerfile 3.7%
Find a file
Exact
Anders Englöf Ytterström 0e2f8a55ce
View to list all images in collection (#3) 
* Cache generation instead of views

This way, query params are kept cached.

* Add view to list all images
2024-09-15 21:41:06 +02:00
templates View to list all images in collection (#3) 2024-09-15 21:41:06 +02:00
.gitignore Create placeany flask project 2024-09-03 00:52:43 +02:00
Caddyfile Fix wrong port number in Caddyfile 2024-09-03 12:01:33 +02:00
Containerfile Restore waitress defaults 2024-09-03 09:12:04 +02:00
Containerfile.aio Restore waitress defaults 2024-09-03 09:12:04 +02:00
LICENSE Create placeany flask project 2024-09-03 00:52:43 +02:00
README.md Remove outdated line in README.md 2024-09-09 10:50:51 +02:00
requirements.txt Create placeany flask project 2024-09-03 00:52:43 +02:00
wsgi.py View to list all images in collection (#3) 2024-09-15 21:41:06 +02:00

README.md

Placeany

A quick and simple service for getting pictures of whatever-you-want for use as placeholders in your designs or code. Just put your image size (width & height) after the URL and you'll get a placeholder.

There is also a bookmarklet service which enhances sites with many images.

Inspirations:

Example calls

Generates an image, 200px wide and 300px tall:
http://localhost:8080/200/300

Generates an image in grayscale, 200px wide and 300px tall:
http://localhost:8080/g/200/300

Installation

First, create an image collection.

  1. Create the directory ./images.
  2. Get some images, from Unsplash or similar.
  3. Place images in image directory.

Run as local web server

  1. Go to the code: cd path/to/holder. Copy images folder to it.
  2. Create and activate a virtualenv.
  3. Get dependencies in place: pip install -r requirements.txt
  4. Start the app: waitress-serve wsgi:app
  5. Go to http://localhost:8080 in your web browser.
  6. Done!

Run as Container

The most easy and portable way to use this is to use Docker or Podman. In this build, waitress is used for production readyness.

podman build .
podman run -it -p 8080:8080 -v ./images:/app/images <container id>

If you wish to embed images in container as well, use alternate Containerfile.

podman build -f Containerfile.aio --build-arg images=./images .
podman run -it -p 8080:8080 <container id>

Run behind reverse proxy

A reverse proxy in front of placeany is recommended. An example Caddyfile is available to make https "just work", but Nginx+certbot will be equally fine.

Podman tip: generate systemd files

Make sure to enable lingering user processes.

loginctl enable-linger $USER

Then, create and change directory to systemd.

mkdir -p .config/systemd/user
cd .config/systemd/user

Now, generate the systemd user service.

podman generate systemd --new -f -n placeany

Your container can now be enabled and started.