Run forensic analysis on a local image or video and return the per-file verdicts.

Reports the A–F grade, what the metadata reveals (GPS, device fingerprint, encoder signatures), manipulation evidence, and any hidden content detected.

A null verdict means no answer, not a negative one. Fields such as steganography_suspected come back null when that check produced no result — because it was skipped, or could not run on this file. Do not report a file as clean, unmodified or free of hidden content on the strength of a null; say the check did not return a verdict.

Args: file_path: Path to a file on this machine. ~ and relative paths are fine. face_detection: Locate faces and return a count. On by default, matching the API. text_detection: Run OCR and return detected text. On by default, matching the API.

Hide a file inside a cover image or video, and save the result to disk.

The output looks like an ordinary photo or video. Recovering the hidden file needs this exact password — it is not stored anywhere and cannot be reset, so make sure the user knows what it is before running this.

Args: secret_path: The file to conceal. cover_path: The image or video that will carry it. password: Passphrase required to reveal it later. output_dir: Where to write the result. Defaults to alongside the cover file.

Extract content hidden inside an image or video, and save it to disk.

Args: stego_path: The file believed to contain hidden content. password: The passphrase it was hidden with. output_dir: Where to write what is recovered. Defaults to alongside the input.

Convert a local image or video to another format, and save the output to disk.

Args: file_path: The file to convert. output_format: Target format. Images: jpeg, png, webp, avif, heic, jxl. Videos: mp4h264, mp4h265, webm, mkv, mov. output_dir: Where to write the converted file. Defaults to alongside the input.