piximport

CLI tool to import photos from SD cards to ~/Pictures, automatically organised by EXIF date and camera make.

Destination structure

~/Pictures/
└── 2026/
    └── 01-15/
        └── SONY/
            ├── SOOC/    ← JPEG, HEIF, HIF
            ├── RAW/     ← ARW, RAF, NEF, CR2, CR3, DNG, ORF, RW2
            └── EDITED/  ← empty, ready for your editing workflow

Installation

With pipx (recommended — isolated, no changes to the global environment)

pipx install piximport

Directly from GitHub

pipx install git+https://github.com/suarez605/piximport.git
# or a specific version:
pipx install git+https://github.com/suarez605/piximport.git@v1.0.0

With pip

pip install piximport

Usage

piximport

The CLI automatically detects connected SD cards, shows an interactive day selector, and copies photos while preserving filesystem metadata.

Supported formats

Requirements

• macOS (uses /Volumes and diskutil)
• Python 3.11+

Development

git clone https://github.com/suarez605/piximport
cd piximport
python3.11 -m venv env
source env/bin/activate
pip install -e .
python -m unittest tests -v