Skip to main content

FlowDetect

FlowDetect is a program for your command line that looks at motion in video files. It tracks movement and finds moments with high action. This tool uses Python and provides a simple way to use it.

Description

This program offers two main ways to processs video.

Track Specific Points

This method finds and tracks specific strong points, such as corners, across video frames. It is very useful for making shaky videos smoother or keeping a moving subject in the center.

Detect High Action Moments

This method calculates the movement of every single pixel in the video frame. It requires more computer power but allows the system to find big energy changes, such as a crowd cheering or sudden fast movement.

Installation

You can install this software package using a Python installer like uv or pip.

Using uv:

uv tool install flowdetect

Using pip:

pip install flowdetect

Usage

After you install the software, you can run the program from your terminal using the flowdetect command.

To view the main help page and see available commands, run:

flowdetect --help

Track Specific Points

Use the track-sparse command to follow clear features in your video.

flowdetect track-sparse my_video.mp4

You can change the behavior of the tracking process by providing extra settings. If you do not provide these settings, the tool will use default values.

Checklist of available settings for tracking points:

  • --max-corners: Maximum number of corners to track (Default is 100).

  • --quality-level: Lowest accepted quality of image corners (Default is 0.3).

  • --min-distance: Minimum possible space between returned corners (Default is 7).

  • --block-size: Size of the block for calculating the values (Default is 7).

  • --win-size: Size of the search window (Default is 15).

  • --max-level: Maximum image scaling level (Default is 2).

Detect High Action Moments

Use the detect-dense command to scan the video for moments of high overall movement. The application will print a timestamp whenever the average motion goes above your set limit.

flowdetect detect-dense my_video.mp4

Checklist of available settings for overall motion detection:

  • --threshold or -t: The motion limit required to log a highlight. Lower numbers are more sensitive to movement (Default is 5.0).

Metadata

Release files for flowdetect 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for flowdetect 0.2.3
File Size Uploaded Provenance Actions
flowdetect-0.2.3.tar.gz 4.1 kB Without provenance Details for flowdetect-0.2.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for flowdetect 0.2.3
File Interpreter ABI Platform Actions
flowdetect-0.2.3-py3-none-any.whl Python 3 none any Details for flowdetect-0.2.3-py3-none-any.whl

Total release size: 9.5 kB

Release files / flowdetect-0.2.3.tar.gz

Download URL flowdetect-0.2.3.tar.gz
Size 4.1 kB
Tags Source
SHA-256 checksum
How to use checksums
af5ba4271e89f135d17cb0d605b3f628275cdbacb2a9afaf060cc67655215b86
BLAKE2b-256 checksum
How to use checksums
d5c33bd12ce1700b66a09696e66e769cbd8a103ced55687ff50428a739215e89
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / flowdetect-0.2.3-py3-none-any.whl

Download URL flowdetect-0.2.3-py3-none-any.whl
Size 5.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6d9031a95c909b5f5110ab5344d7d6ef6088fb61ece34c8f36906acc1a9dffd2
BLAKE2b-256 checksum
How to use checksums
ad2350543dde1e074776200e1ee46234f8cd9b5c3225f6a96e1c1e3f77210bc4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.7 {"installer":{"name":"uv","version":"0.10.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for flowdetect 0.2.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page