Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions assets/contributors.csv
Original file line number Diff line number Diff line change
Expand Up @@ -134,6 +134,8 @@ Tirui Wu,Arm,,,,
William Watson,Arm,,,,
John O'Hara,Arm,JohnOhara-Arm,johnaohara,JohnnyDoItAll,
Usamah Zaheer,Arm,usamahz,,,
Kostiantyn Perehuda,Arm,,,,
Yogesh Deshpande,Arm,,,,
Roy Jamil,Ac6,RoyAc6,royjamil,,https://www.ac6.fr/en/
Elad Gross,Arm,eladgr,,,
Ash Naik,Arm,,,,
Expand Down
127 changes: 127 additions & 0 deletions content/install-guides/c2patool.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
---
title: C2PA Tool
description: Install C2PA Tool on Arm Linux, macOS, or Windows on Arm to work with Content Credentials from the command line.
minutes_to_complete: 20
official_docs: https://github.com/contentauth/c2patool
author: Kostiantyn Perehuda

draft: true

test_maintenance: false

### FIXED, DO NOT MODIFY
weight: 1
tool_install: true
multi_install: false
multitool_install_part: false
layout: installtoolsall
---

## Overview

[C2PA Tool](https://github.com/contentauth/c2patool), invoked as `c2patool`, reads, creates, and
validates Content Credentials in supported media files. Content Credentials use the
Coalition for Content Provenance and Authenticity (C2PA) standard to record media provenance.

You can install C2PA Tool on 64-bit Arm Linux, macOS on Apple silicon, or Windows on Arm.
The Linux instructions cover Ubuntu and Debian.

Homebrew and Cargo install the version available from their package source. For release
information, see [C2PA Tool releases](https://github.com/contentauth/c2patool/releases).

## Install on macOS

Install [Homebrew](https://brew.sh/) if it isn't already available, then install C2PA Tool:

```console
brew install c2patool
```

## Install on Arm Linux

Prebuilt Linux releases target `x86_64`. Use Cargo to build and install a native `aarch64`
executable.

Install the build dependencies on Ubuntu or Debian:

```console
sudo apt update
sudo apt install -y build-essential pkg-config libssl-dev
```

Install [Rust](/install-guides/rust/) to obtain Cargo, then install C2PA Tool:

```console
cargo install c2patool --locked
```

Cargo installs `c2patool` in `$HOME/.cargo/bin`.

## Install on Windows on Arm

Prebuilt Windows releases target `x86_64`. Use Cargo to build and install a native ARM64 executable.

Install the Microsoft C++ Build Tools and [Rust](https://www.rust-lang.org/tools/install) with the
MSVC toolchain for ARM64. Open a new PowerShell window and run:

```console
cargo install c2patool --locked
```

Cargo installs `c2patool.exe` in `%USERPROFILE%\.cargo\bin`.

## Verify the installation

Print the installed version:

```console
c2patool --version
```

The output reports `c2patool` followed by the installed version number.

Display the command summary:

```console
c2patool --help
```

The expected output starts with:

```output
Tool for displaying and creating C2PA manifests.
```

## Troubleshooting

If your shell can't find `c2patool`, open a new terminal. For a Cargo installation, confirm that
`$HOME/.cargo/bin` on Linux or `%USERPROFILE%\.cargo\bin` on Windows is in your `PATH`.

## Update C2PA Tool

On macOS, run:

```console
brew update
brew upgrade c2patool
```

For a Cargo installation, run:

```console
cargo install c2patool --locked --force
```

## Uninstall C2PA Tool

For a Homebrew installation, run:

```console
brew uninstall c2patool
```

For a Cargo installation, run:

```console
cargo uninstall c2patool
```
96 changes: 96 additions & 0 deletions content/install-guides/exiftool.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
---
title: ExifTool
description: Install ExifTool on macOS, Linux on Arm, or Windows on Arm to read and write media metadata from the command line.
minutes_to_complete: 10
official_docs: https://exiftool.org/install.html
author: Kostiantyn Perehuda

draft: true

test_maintenance: false

### FIXED, DO NOT MODIFY
weight: 1
tool_install: true
multi_install: false
multitool_install_part: false
layout: installtoolsall
---

## Overview

[ExifTool](https://exiftool.org/) reads and writes metadata in image, audio, and video files.
You can install it on macOS on Apple silicon, 64-bit Arm Linux, or Windows 11 on Arm.
On Windows on Arm, you use the Windows x64 executable under emulation.

Package-manager commands install the version available from your package source. See the
[ExifTool download page](https://exiftool.org/) for current releases.

## Install on macOS

Install [Homebrew](https://brew.sh/) if it isn't already available, then install ExifTool:

```console
brew install exiftool
```

## Install on Arm Linux

On Ubuntu and Debian, install the `libimage-exiftool-perl` package:

```console
sudo apt update
sudo apt install libimage-exiftool-perl
```

On Fedora, install the [perl-Image-ExifTool package](https://packages.fedoraproject.org/pkgs/perl-Image-ExifTool/perl-Image-ExifTool/):

```console
sudo dnf install perl-Image-ExifTool
```

Both packages provide the `exiftool` command and its Perl dependencies.

## Install on Windows 11 on Arm

The Windows x64 executable runs through
[x64 application emulation on Windows 11 on Arm](https://learn.microsoft.com/en-us/windows/arm/apps-on-arm-x86-emulation).

Follow the [official Windows installation instructions](https://exiftool.org/install.html#Windows):

1. Download the **64-bit Windows Executable** ZIP from the [ExifTool download page](https://exiftool.org/).
2. Extract the archive into a permanent folder in your user directory.
3. Rename `exiftool(-k).exe` to `exiftool.exe`. Keep its accompanying `exiftool_files` folder beside it.
4. Add the folder containing `exiftool.exe` to your user's `Path` environment variable.
5. Open a new PowerShell window so it picks up the change.

## Verify the installation

Print the installed version:

```console
exiftool -ver
```

The output is similar to:

```output
13.55
```

Your version can differ. List the available metadata tags to confirm ExifTool runs:

```console
exiftool -list
```

The output begins with `Available tags:` followed by tag names.

## Troubleshooting

If your shell can't find `exiftool`, open a new terminal and confirm that the directory containing
`exiftool` is in your `PATH`. On Windows, also check that the executable is named `exiftool.exe`
and that `exiftool_files` is still beside it.

If Ubuntu cannot locate the package, check that the `universe` repository is enabled for your Ubuntu
release, then run `sudo apt update` again.
95 changes: 95 additions & 0 deletions content/install-guides/libjpeg-turbo.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
---
title: libjpeg-turbo
description: Install libjpeg-turbo on macOS, Linux on Arm, or Windows on Arm to encode, decode, and transform JPEG images.
minutes_to_complete: 10
official_docs: https://libjpeg-turbo.org/Documentation/Documentation
author: Kostiantyn Perehuda

draft: true

test_maintenance: false

### FIXED, DO NOT MODIFY
weight: 1
tool_install: true
multi_install: false
multitool_install_part: false
layout: installtoolsall
---

## Overview

[libjpeg-turbo](https://www.libjpeg-turbo.org/) provides JPEG encoding and decoding libraries and
command-line tools. The tools include `cjpeg` for encoding, `djpeg` for decoding, and `jpegtran`
for transforming JPEG images.

You can install the tools on macOS on Apple silicon, 64-bit Arm Linux, or Windows on Arm.
Package-manager commands on macOS and Linux install the version available from your package source.

## Install on macOS

Install [Homebrew](https://brew.sh/) if it isn't already available, then install the
[jpeg-turbo package](https://formulae.brew.sh/formula/jpeg-turbo):

```console
brew install jpeg-turbo
```

## Install on Arm Linux

On Ubuntu and Debian, install the `libjpeg-turbo-progs` package:

```console
sudo apt update
sudo apt install libjpeg-turbo-progs
```

On Fedora, install the [libjpeg-turbo-utils package](https://packages.fedoraproject.org/pkgs/libjpeg-turbo/libjpeg-turbo-utils/):

```console
sudo dnf install libjpeg-turbo-utils
```

Both packages provide `jpegtran` and the other command-line tools. Installing only the JPEG
runtime library doesn't provide these tools.

## Install on Windows on Arm

{{% notice Note %}}
The following steps use libjpeg-turbo version 3.1.4.1. You can use another version that provides
a native ARM64 installer. Replace the installer with the file for your chosen version.
To find the latest version, see [libjpeg-turbo releases](https://github.com/libjpeg-turbo/libjpeg-turbo/releases).
{{% /notice %}}

1. Download `libjpeg-turbo-3.1.4.1-vc-arm64.exe` from the
[libjpeg-turbo 3.1.4.1 release](https://github.com/libjpeg-turbo/libjpeg-turbo/releases/tag/3.1.4.1).
2. Run the installer and note the installation directory.
3. Add the installation's `bin` directory, containing `jpegtran.exe`, to your user's `Path`
environment variable.
4. Open a new PowerShell window so it picks up the change.

## Verify the installation

Print the installed version:

```console
jpegtran -version
```

The output is similar to:

```output
libjpeg-turbo version 3.1.4.1 (build 20260327)
```

Your version and build can differ. A successful version check confirms that your terminal can
find and run `jpegtran`.

## Troubleshooting

If your shell can't find `jpegtran`, open a new terminal and confirm that the directory containing the
executable is in your `PATH`. On Windows, check for `jpegtran.exe` in the installation's `bin`
directory. On Linux, check that you installed the command-line tools package for your distribution.

If Ubuntu cannot locate the package, check that the `universe` repository is enabled for your
release, then run `sudo apt update` again.
Loading
Loading