https://github.com/ghomashudson/super-simple-wishlist
A plaintext self-hosted wishlist app
https://github.com/ghomashudson/super-simple-wishlist
flask plaintext self-hosted wishlist
Last synced: 3 months ago
JSON representation
A plaintext self-hosted wishlist app
- Host: GitHub
- URL: https://github.com/ghomashudson/super-simple-wishlist
- Owner: ghomasHudson
- License: apache-2.0
- Created: 2022-06-11T00:28:55.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-06-15T17:03:26.000Z (over 1 year ago)
- Last Synced: 2025-06-19T02:48:16.322Z (4 months ago)
- Topics: flask, plaintext, self-hosted, wishlist
- Language: HTML
- Homepage:
- Size: 51.8 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Super Simple Wishlist
A really basic self-hosted wishlist app which renders a simple plaintext file of urls as a wishlist. Additionally, keeps track of when someone buys something for you.
Turns:
```
https://www.amazon.co.uk/Innovative-Designs-Mandalorian-Sticker-Stickers/dp/B087H4HZQ7
https://www.ikea.com/gb/en/p/markus-office-chair-vissle-dark-grey-30261152/
https://www.dell.com/en-uk/shop/laptops-2-in-1-pcs/xps-13-laptop/spd/xps-13-9340-laptop
```
into
# Setup
## Docker-compose
Here's a basic docker-compose snippet:
```yaml
version: "2.1"
services:
supersimplewishlist:
image: ghomashudson/supersimplewishlist
container_name: supersimplewishlist
volumes:
- /path/to/wishlists:/usr/src/app/wishlists
- /path/to/db.json:/usr/src/app/db.json
ports:
- 5000:5000
restart: unless-stopped
```
## Manually
1. Install the python depenancies with `pip install -r requirements.txt`
2. Run the flask app with `flask run`
# How it Works
Fill the `/wishlists` directory with `wishlist_name.txt` files with one product url per line, e.g.
```
https://www.amazon.co.uk/Innovative-Designs-Mandalorian-Sticker-Stickers/dp/B087H4HZQ7
https://www.ikea.com/gb/en/p/markus-office-chair-vissle-dark-grey-30261152/
https://www.dell.com/en-uk/shop/laptop-computers-2-in-1-pcs/xps-13-9305/spd/xps-13-9305-laptop/cn93509sc11
```
An example `example_list.txt` has been provided. The products will appear in your wishlist in the same order as the txt file.
The wishlist can be viewed by going to `SERVER_URL/wishlists/wishlist_name.txt`.
It may take a few seconds to load the first time while the product details are grabbed. The product details along with the "Bought" status are saved in the `db.json` file. Item details are refreshed once a day in case of price changes.
Navigating to `SERVER_URL/wishlists/wishlist_name.txt?exclude_purchased=1` will remove products that people have bought for you. Without this a prompt `Someone may have purchased this item` will appear, when clicking to prevent spoilers.