v-flow

Move footage and photos between camera cards, long-term storage, and editing drives without ever losing track of the safe copy.

Wait, what does it do?

v-flow is a CLI for people who shoot a lot of video and photos. It copies your camera card into a protected archive and proves the copy with checksums. It puts temporary copies on your editing SSD, saves finished videos and DaVinci Resolve backups, and deletes an editing copy only after verifying the archived original. Nothing is ever moved or deleted as a side effect of anything else.

You can drive it from the terminal, or just talk to Claude Code, Codex, or Cursor. The bundled skill teaches your agent the whole workflow.

Install

curl -fsSL https://raw.githubusercontent.com/kaungzinye/v-flow/main/install_vflow.sh | bash

That installs the v-flow command plus the agent skill. Claude Code and Cowork users can grab the plugin instead, and the skill installs the CLI from PyPI on first use:

/plugin marketplace add kaungzinye/v-flow
/plugin install vflow@v-flow

Then point it at your drives:

v-flow make-config

Use it

Ingest a card. Footage lands in a Shoot, photos in a Collection, one command:

v-flow ingest --source "/Volumes/SDCARD" --auto

Put a Shoot on your editing drive, and clean it up when you're done (cleanup verifies checksums and your Resolve project first):

v-flow checkout --shoot "2026-08-02_Ingest" --working-location work_ssd
v-flow cleanup  --shoot "2026-08-02_Ingest" --working-location work_ssd --project "Summer Film"

Or skip the flags entirely and ask your agent:

Ingest this card, then put the footage on my SSD.

Every state-changing command supports a dry run, names the safety gate that failed, and leaves your card and archive intact on any error.

Notes

This is a personal tool that grew documentation. It works on macOS, it's tested, and it guards your media obsessively. Still, expect sharp edges in places one person's workflow never reached.

Docs

  • The agent skill: the workflow reference, branch by branch
  • Domain language: what Shoot, Collection, Archive, and friends mean precisely
  • Every command: v-flow --help

Contributing

Issues and PRs welcome. Read CONTEXT.md first. The vocabulary is load-bearing.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.3.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kaungnaung from gravatar.com kaungnaung

Credits

Author: Kaung

Requires

Python >=3.8

Provides Extra

test

Report project as malware

Download files

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

Source Distribution

vflow_cli-0.2.0.tar.gz (69.3 kB view details)

Uploaded Source

Built Distribution

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

vflow_cli-0.2.0-py3-none-any.whl (55.2 kB view details)

Uploaded Python 3

File details

Details for the file vflow_cli-0.2.0.tar.gz.

File metadata

  • Download URL: vflow_cli-0.2.0.tar.gz
  • Upload date:
  • Size: 69.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vflow_cli-0.2.0.tar.gz
Algorithm Hash digest
SHA256 8a2ac88dd4a9b408ca22cd425561ff140e66fa2357073793e2219012dfe454db
MD5 8b2ff24334a6f4fc0640f73c66467dbe
BLAKE2b-256 4a04e2f737bf27a81a63d5a4c5f2946eba6a526b46a423fb6bdade01849c66bc

See more details on using hashes here.

Provenance

The following attestation bundles were made for vflow_cli-0.2.0.tar.gz:

Publisher: publish.yml on kaungzinye/v-flow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vflow_cli-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: vflow_cli-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 55.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vflow_cli-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ef9a940e5622146d22e192b3c31a27e19507327a954637513e5efa3dcba45f8d
MD5 47b766a8d8c49d4bdacebac2491bf149
BLAKE2b-256 e40d0c2e414b3fa5db79d07ba37b7833de4b166d14f1fb73828e897e65ec7300

See more details on using hashes here.

Provenance

The following attestation bundles were made for vflow_cli-0.2.0-py3-none-any.whl:

Publisher: publish.yml on kaungzinye/v-flow

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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