mcdonald is a frame-by-frame analysis toolkit for measuring the kinematics of an unknown object in a single-camera video.
"Science is in default for having failed to mount any truly adequate studies of this problem."
— James E. McDonald
Status: early test version (0.2.7), tried on Linux and macOS; Windows is next.
Install
-
Prerequisite: make sure ffmpeg is installed:
brew install ffmpeg(Mac),winget install Gyan.FFmpeg(Windows),sudo apt install ffmpegorsudo dnf install ffmpeg(Linux). -
Install mcdonald (needs Python 3.10 or newer):
python3 -m pip install mcdonald
-
Check your setup, which also provides instructions on what to do next:
mcdonald setup
When a newer version is out, mcdonald-gui offers to update itself when it starts, and the
command line prints the command to update with.
New to Python or the terminal? docs/install.md walks through each step in detail.
Use
mcdonald has a graphical interface and a command-line interface. The software is intended to be driven by human users and/or AI agents.
The graphical interface is designed to prompt human users through the steps of analysis. To start the graphical interface:
mcdonald-gui
The command-line interface is designed for developers, advanced users, and AI agents. To start the command-line interface and see a summary of options:
mcdonald
Prompting an agent
You can invoke an AI agent to assist at any point in the analysis, whether before or after a human has looked at the video. Here is a sample prompt that you can pass to your favorite command-line AI model:
Please use the mcdonald toolkit to analyze the PR144 video released under PURSUE. Run
mcdonald readmeto get started.
License
Copyright (c) 2026 Jacob Haqq Misra. Released under the BSD 3-Clause License.
1 maintainer
Release files for mcdonald 0.2.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcdonald-0.2.7.tar.gz | 603.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcdonald-0.2.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / mcdonald-0.2.7.tar.gz
| Download URL | mcdonald-0.2.7.tar.gz |
|---|---|
| Size | 603.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9ac950490c82313602622c040066844931880609634e3c6a87811e511ae6ab93
|
|
BLAKE2b-256 checksum How to use checksums |
0b1ae56acc13a6847f9fec419afa9ec84bc4d866d317a21523cf4c713c4434bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / mcdonald-0.2.7-py3-none-any.whl
| Download URL | mcdonald-0.2.7-py3-none-any.whl |
|---|---|
| Size | 528.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
252d33a99921466c815b872803ab350343be3b6e0e955fa4c23246d14ec97416
|
|
BLAKE2b-256 checksum How to use checksums |
9ae49643b2aa7212b275a9e8371693d00a3572793562e4aaa8f1f7516b071eed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log
