Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/veedata/memories

Library to convert clubbed images into separated images (with metadata), and beautify them using borders and other options.
https://github.com/veedata/memories

image-processing image-segmentation metadata-management opencv python

Last synced: about 2 months ago
JSON representation

Library to convert clubbed images into separated images (with metadata), and beautify them using borders and other options.

Host: GitHub
URL: https://github.com/veedata/memories
Owner: veedata
License: mit
Created: 2021-05-11T08:31:59.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2022-03-11T01:51:50.000Z (almost 3 years ago)
Last Synced: 2024-11-01T21:42:10.451Z (2 months ago)
Topics: image-processing, image-segmentation, metadata-management, opencv, python
Language: Python
Homepage: https://pypi.org/project/memories/
Size: 16.7 MB
Stars: 7
Watchers: 1
Forks: 0
Open Issues: 8
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Awesome Lists containing this project

README

        Memories

======

[![PyPi](https://img.shields.io/pypi/v/memories.svg)](https://pypi.org/project/memories/)

[![Documentation Status](https://readthedocs.org/projects/memories/badge/?version=latest)](https://memories.readthedocs.io/en/latest/?badge=latest)

[![License](https://img.shields.io/github/license/veedata/album-manager)](https://github.com/veedata/album-manager/blob/main/LICENSE.txt)

[![Language grade: Python](https://img.shields.io/lgtm/grade/python/github/veedata/album-manager)](https://lgtm.com/projects/g/veedata/album-manager/context:python)

[![Downloads](https://pepy.tech/badge/memories)](https://pepy.tech/project/memories)

Description

------

Memories is an easy to use package that helps to seperate clustered images from files and helps add metadata to files. The documentation is in progress and can be found [here](https://memories.readthedocs.io/en/latest).

Installation

------

    $ pip install memories

How to Use:

------

There are 8 functions for the time being:

* ``open_image``: Returns the Image object to you so that it can be passed around to other functions

* ``divided_crop``: Takes 3 inputs, the path to the image, the path where the outful folder should be and the number of images present in the input file. It performs the task of dividing a single image into multiple smaller ones. 

* ``add_date``: Takes input as the image path and the datetime to be added. it will add date when the image was originally taken.

* ``bulk_add_date``: Same as addDate, except it will add date to all images in a folder. The inputs are the folder path and datetime.

* ``save_image``: Converts a single image into another format

* ``make_page``: Creates a year book like page in HTML

* ``make_border``: Creates a border around the image

* ``rotate_image``: Returns a rotated image

Example

------

  

    import memories

    # Add meta data to images

    memories.add_date("./image-1.jpg", "27/04/2021 12:00:03")

    memories.bulk_add_date("./", "27/04/2021 12:00:03")

 

    memories.make_page(["./folder1/image1.png", "./folder2/image2.jpg"], ["CSS", "Larry"], ["SASS", "Another line"], "./save_folder")

    image = memories.open_image("./image.png")

    memories.divided_crop(image, image_quantity = 6, bgr_value = [255, 255, 255])

    # Normal squared borders

    memories.make_border(image, "normal", bgr_value = [255, 255, 255], border_dimensions = [100, 100, 100, 100])

    # Curved borders

    memories.make_border(image, "curved", bgr_value = [255, 255, 255], border_dimensions = [100, 100, 100, 100], radius_dimensions = [100, 100, 100, 100])

    memories.save_image("image.png", "path/to/save_folder/file.extention")

    # Save multiple images at once

    memories.save_image(["img-1.png", "img-1.jpg", "img-2.jpg"], "path/to/save_folder/file.extention")

    # Save multiple images as a pdf

    memories.save_image(["img-1.png", "img-1.jpg", "img-2.jpg"], "path/to/save_folder/file.pdf")

Features

------

Current features that are present are: 

1. Crop out basic implementation

2. Add Date and time metadata 

3. Save as PDF, PNG, JPG

4. Basic Scrapbook implmentation

5. Documentation

6. Border

Future features can also be found [here](https://github.com/veedata/album-manager/projects):

1. Collage

2. Image Age identifyer

License

------

This software is released under the MIT license, see [LICENSE.txt](https://github.com/veedata/album-manager/blob/main/LICENSE.txt).