video-organise 1.0.1

CLI tool to organize files into date-based folders

Video Organise

A CLI tool to organize Insta360 files into date-based folders.

See SPEC.md for full details.

Installation

Requires Python 3.12+ and uv.

Run latest stable version directly:

uvx video-organise <source> <dest>

Or clone the repo and install latest development version:

git clone https://github.com/pokle/video-organise
cd video-organise
uv sync

Usage

# Preview what will be copied (default - dry run)
uv run video-organise /Volumes/SDCARD /archive/videos

# Actually copy files
uv run video-organise --approve /Volumes/SDCARD /archive/videos

Development

uv run pytest

Publishing a new version to PyPI

uv version --bump patch  # or 'minor' or 'major'
git tag X.Y.Z         # replace X.Y.Z with the new version
git push

Then create a new release with the same version tag on GitHub to trigger the PyPI publish workflow.