Skip to main content

A script that helps you organize your pictures.

Project description

picorg

Build Status Build Status codecov

A set of scripts to organize pictures. It is ideal if you save your images in different locations on your hard drives and manually backup your images from your phone.

Installation

pip install picorg

Usage

# Renames all images in the current working directory and its subdirectories. It tries to use the timestamp of when the image was taken from the EXIF data. If the script cannot find a suitable name for a file, it will be moved to a **NOK** folder and the filename will be printed to the console.
picorg -a rename

# Checks all files in current working dir for files with the same content. If two files has the same content,
# the one with the "biggest" name is moved to a *duplicates* folder. It then traverses all the files in
# all the directories listed in pic_paths (in the settings file). If a file matches by name and content,
# the file in current working dir will be moved to the *duplicates* folder.
picorg -a duplicates

# Finding new images in current working dir. Useful when syncing images from a mobile phone to a dir and
# then copying the images to another place.
picorg -a find-new

Configuration

A settings file is created in <USER_HOME>/.picorg that stores the users settings.

Developing

Install dependencies from the requirements.txt file

pip install -r requirements.txt

Create a package and install with

python -m build
pip install -e .

Before commit

Run the command pre-commit run --verbose --all-files --show-diff-on-failure before any commits on order to be consistent with formatting and having sorted imports.

Creating a new version.

  • Create a new tag and push. The publishing of the new version is done automagically.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

picorg-0.2.9.tar.gz (21.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

picorg-0.2.9-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

Details for the file picorg-0.2.9.tar.gz.

File metadata

  • Download URL: picorg-0.2.9.tar.gz
  • Upload date:
  • Size: 21.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.2

File hashes

Hashes for picorg-0.2.9.tar.gz
Algorithm Hash digest
SHA256 5995e048c7c856f9b59d6527231200f5cb33c06a42991ab540031708b582fd3f
MD5 f11749bf380c7d1137fa23f24d96b735
BLAKE2b-256 2193980794b0fde96775aec607743e61c15f38e030a27da7babe58ce643f12d5

See more details on using hashes here.

File details

Details for the file picorg-0.2.9-py3-none-any.whl.

File metadata

  • Download URL: picorg-0.2.9-py3-none-any.whl
  • Upload date:
  • Size: 7.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.2

File hashes

Hashes for picorg-0.2.9-py3-none-any.whl
Algorithm Hash digest
SHA256 a49ec39c490817e156c9aea102aaeeef9970a9e5148b32a09a65770e7dad8b24
MD5 39b20861cf059ec262f50fa50922ef76
BLAKE2b-256 253b419c8c9c62085842f8d5b3a4484389779417bab938606f62d7dfca1d736c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page