c2patool

Crates.ioc2patool
lib.rsc2patool
version
sourcesrc
created_at2022-06-10 01:22:07.103083
updated_at2024-12-12 18:30:03.132549
descriptionTool for displaying and creating C2PA manifests.
homepagehttps://contentauthenticity.org
repositoryhttps://github.com/contentauth/c2pa-rs/tree/main/cli
max_upload_size
id603117
Cargo.toml error:TOML parse error at line 21, column 1 | 21 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
Andy S. Parsons (andyparsons)

documentation

https://opensource.contentauthenticity.org/docs/c2patool

README

c2patool - C2PA command line tool

c2patool is a command line tool for working with C2PA manifests and media assets (audio, image or video files).

Use the tool on a file in one of the supported formats to:

  • Read a summary JSON report of C2PA manifests.
  • Read a low-level report of C2PA manifest data.
  • Add a C2PA manifest to the file.

For a simple example of calling c2patool from a Node.js server application, see the c2pa-service-example repository.

Additional documentation:

Installation

There are two ways to install C2PA Tool:

  • Using a pre-built binary executable: This is the quickest way to install the tool. If you just want to try C2PA Tool quickly, use this method.
  • Using Cargo Binstall, a low-complexity way to install Rust binaries. This method is preferable for long-term use. If you know you want to use C2PA Tool for development, use this method.

NOTE: If you want to contribute to the C2PA Tool project itself, or if a pre-built binary is not available for your system, see Contributing to the project.

Installing a pre-built binary

The quickest way to install the tool is to use the binary executable builds. If you just want to try C2PA Tool quickly:

  1. Go to the c2patool repository releases page.
  2. Under the latest release, click Assets.
  3. Download the archive for your operating system (Linux, macOS, or Windows).
  4. Copy the executable file to a location on your PATH.

Confirm that you can run the tool by entering a command such as:

c2patool -h

NOTE: You also may want to get some of the example files provided in the repository sample directory. To do so, clone the repository with git clone https://github.com/contentauth/c2patool.git.

Using Cargo Binstall

Installing C2PA Tool using Cargo Binstall is recommended because it makes it easier to:

  • Automatically select the correct installation package for your platform/architecture.
  • Update the tool when a new version is released.
  • Maintain, since you don't have to manually keep track of random binaries on your system.
  • Integrate into CI or other scripting environments.

Additionally, using Binstall enables you to automate code signing to ensure package integrity.

Process

PREREQUISITE: Install Rust.

To install by using Binstall:

  1. Install cargo-binstall by following the quick install method for your OS, or by building from source by running cargo install cargo-binstall
  2. Run cargo binstall c2patool.

Upgrading

To ensure you have the latest version, enter this command:

c2patool -V

The tool will display the version installed. Compare the version number displayed with the latest release version shown in the repository releases page.

If you need to upgrade, simply run cargo binstall c2patool again, or use cargo-update.

Commit count: 783

cargo fmt