meural-photo-prep 1.0.1

Module to assist in preparing photos for Netgear's Meural Canvas

Netgear Meural Photo Preparation

Python Package to prepare photos for use with Netgear Meural Picture Frames.
This package is not affiliated with Netgear in any way.
Netgear Meural Picture Frames require photos to be formatted in a specific way.
This package will prepare photos for use with Netgear Meural Picture Frames.
For more information on the Netgear Meural Picture Frames formatting need please visit Netgear

Table of Contents

• External Dependencies
• Installation
• Usage

External Dependencies

• Pillow

Installation

Requirements

• Python 3.9+

PIP

pip install meural-photo-prep

Poetry

[tool.poetry]
name = "example-package"
version = "0.1.0"
description = ""
authors = ["Example developer <[e-mail]>"]
readme = "README.md"

[tool.poetry.dependencies]
python = "^3.9"
meural-photo-prep = "^1.0.1"

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

Usage

Description

• Prepares photos for use with Netgear Meural Picture Frames.
• Copies photos from the input path to the output path.
  • Removes special characters from the file name.
• Creates a thumbnail for each photo using the Thumbnail() method from Pillow.
  • The thumbnail is created using the dimensions specified in the documentation above.
  • The thumbnail is saved with the same name as the original photo with the addition of the .thumb extension.
• Function uses threading to process photos in parallel.
  • NOTE: This may cause issues with memory usage as thread limits are not implemented in this version
    be careful how many photos you give it!

Example

import meural_photo_prep as mpp

mpp.prep_photos("<INPUT_PATH>", "<OUTPUT_PATH>")

Output

<OUTPUT_PATH>
|__ meural1
    |__ img1.jpg # All names have special characters removed
    |__ img1.jpg.thumb # Rendered by Pillow using Thumbnail() method
    |__ img2.jpg
    |__ img2.jpg.thumb
    |__ img3.jpg
    |__ img3.jpg.thumb