Colour-Picker

Colour Picker is a simple Django web-app, designed to allow users to extract colour values per pixel, from any uploaded image using a Bootstrap based interface.

This project is a n MVP, there are various features to be added such as:

• Colour conversions
• Setting to change color format provided

Contents 📖

• Installation
• How it works
• Known Issues
• Contributions

Installation ⬇️

Clone git project:

git clone https://github.com/KianaR/Colour-Picker.git

Note: It's recomended to create and activate a virtual environment for the project at this stage.

Install project dependancies:

pip install -r requirements.txt

Setup .env:

Create '.env' file in /colour_picker/

Add your secret key: SECRET_KEY = 'YOUR KEY HERE'

Add following details for your database:

HOST = 'database_url_here'

PASS = 'database_pass_here'

PORT = 'database_port_here'

USER = 'database_user_here'

Switch 'DEBUG' to True and 'ALLOWED_HOSTS' to [] in settings.py, for local copies.

Make migrations

py manage.py makemigrations

py manage.py migrate

How it works 📋

Running the webapp:

You can run the webapp using the following command under the /colour_picker/ directory:

py manage.py runserver

Known Issues ⚠️

• Image stretching - could resolved with object-fit: contain but need to investigate how to accurately pick up pixels as per front-end display when using this styling, as image size will differ between actual and visual. Currently raised under: Issue #2

Contributions 📃

If you have any feedback or contributions to improve this project, feel free to share your thoughts!