Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rfdzan/contours
extract bright objects (like receipts) from a dark background
https://github.com/rfdzan/contours
computer-vision opencv-python
Last synced: about 2 months ago
JSON representation
extract bright objects (like receipts) from a dark background
- Host: GitHub
- URL: https://github.com/rfdzan/contours
- Owner: rfdzan
- Created: 2023-08-23T11:49:18.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-05-14T09:18:47.000Z (8 months ago)
- Last Synced: 2024-05-14T10:35:39.786Z (8 months ago)
- Topics: computer-vision, opencv-python
- Language: Python
- Homepage:
- Size: 1.01 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Contours
A simple CLI tool to extract things like receipts from an image containing multiple receipts.
# Why
My phone of 5 years was broken and wouldn't turn on. I handle a lot of financial transactions in my family and I lost the ability to have an automated environment to store these receipts along with my phone.
I relied on this tool for a month and it served me well until I got my new phone.
# Usage:
*Requires Python 3.11 or above*
1. Clone this repo
`HTTP`
```
git clone https://github.com/rfdzan/contours.git
```
`SSH`
```
git clone [email protected]:rfdzan/contours.git
```
2. Create a virtual environment (Recommended)
```
cd contours/
python -m venv .
```
3. Install dependencies (there's only OpenCV)
```
pip install -r requirements.txt
```
# How to Use:
## First time user:
Run `python app/main.py` once, and close it.
This is to make sure you have all the directories in the project folder:
1. `collage/`
2. `extracted_images/`
Or you can just create it manually, up to you.
## Moving on
1. Put your collage image in the `collage/` folder.
2. Run `python app/main.py`, and type in the collage image filename. It doesn't have to be exact, just a string of words that the filename contains is fine.
3. Press `enter` and your chopped-up image is in `extracted_images/`