https://github.com/torchbox/wagtail-makeup
Wagtail plugin to replace all your broken local images with unsplash ones
https://github.com/torchbox/wagtail-makeup
images local wagtail wagtail-plugin webdevelopment
Last synced: 3 days ago
JSON representation
Wagtail plugin to replace all your broken local images with unsplash ones
- Host: GitHub
- URL: https://github.com/torchbox/wagtail-makeup
- Owner: torchbox
- License: mit
- Created: 2020-12-10T22:10:04.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-20T10:52:55.000Z (about 2 months ago)
- Last Synced: 2025-04-22T06:49:09.352Z (14 days ago)
- Topics: images, local, wagtail, wagtail-plugin, webdevelopment
- Language: Python
- Homepage:
- Size: 48.8 KB
- Stars: 6
- Watchers: 2
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-wagtail - Wagtail Makeup - A plugin that replaces all your images with [Unsplash](https://unsplash.com/) images. (Apps / Media)
README
# Wagtail Makeup
[](https://codecov.io/gh/kevinhowbrook/wagtail-makeup)
Tired of having no images locally when you need them? Don't want to fill your computer up with images?
Use Wagtail Makeup ;)
## Installation
Wagtail makeup depends on python unsplash:
```bash
pip install python-unsplash wagtailmakeup
```
## Configuration
Sign up for an Unsplash api key and add this to your settings:
```python
# settings.py
WAGTAIL_UNSPLASH = {
"CLIENT_ID": "",
"CLIENT_SECRET": ""
}
```
The API is rate limited to 50 request/hour... you can apply for a [higher rate limit](https://help.unsplash.com/en/articles/3887917-when-should-i-apply-for-a-higher-rate-limit).
## Using
You probably don't want this in your production settings, so add the following to you local.py settings:
```python
INSTALLED_APPS.append('wagtailmakeup')
```
Wagtail Makeup works by providing a new management command:
```bash
python manage.py make_up [search query] [amount of images]
```
So you want to replace all your broken images on your site with dogs (who wouldn't)
you can do it like this:
```python
python manage.py make_up dogs 10
```
Note: the amount value is the number of images to download, the higher this is, the more variance you will get 😎
## Contributing
Contributions are welcome, please see our [contributing guide](docs/CONTRIBUTING.md) for more details.