# Python Scripts

Utility scripts live in `src/.local/bin/` and are deployed to `~/.local/bin` via
GNU Stow.

## mm_organize

Organize photos and videos based on EXIF creation dates into a structured
directory hierarchy:

```text
destination/Photos/YYYY-MM/YYYY-MM-DD_HHMMSS.ext
destination/Videos/YYYY-MM/YYYY-MM-DD_HHMMSS.ext
```

Uses `exiftool` for metadata extraction with parallel processing support.

## md2mb

Convert Maildir mail archives to mbox format, including subfolders. Handles
UTF-8 encoding for message content.

```bash
python md2mb.py [maildir_path] [mbox_filename]
```

## mu_tags2notmuch

Synchronize mu4e tags to notmuch tags. Reads mu4e's database and applies
matching tags in the notmuch index.

## update_changelog

Parse and condense dependency bump entries from release notes generated by
[git-cliff](https://git-cliff.org/). Used by `make ch` and `make bump`.

## peso / plot

Personal data visualization scripts using matplotlib and pandas.