Repository files navigation

This repository contains a collection of Truestamp utilities for the AppleShortcuts application foriOS,iPadOS, andmacOS.

Some Truestamp shortcuts require an active Truestamp account, and an API Key. You can sign up for a free trial account atwww.truestamp.com. An API key can be generated from your account dashboard as needed.

These shortcuts have been tested on the following Apple platforms:

• macOS Monterey >= 12.3
• iPadOS >= 15.4
• iOS >= 15.4

Shortcuts are not supported on any other platforms.

Per Apple security guidelines, youmust set a one time permission to allow any third-party scripts to be installed in the Shortcuts app.

Follow these simple steps for all of the platform(s) you plan to run Shortcuts on.

OpenShortcuts application.

Go toShortcuts >Preferences... menu

Turn onPrivate Sharing

We also recommend enablingiCloud Sync so that your Shortcuts are shared across devices.

Go toSettings >Shortcuts.

Turn onPrivate Sharing.

We also recommend enablingiCloud Sync so that your Shortcuts are shared across devices.

Go toSettings >Shortcuts.

Turn onPrivate Sharing.

We also recommend enablingiCloud Sync so that your Shortcuts are shared across devices.

Once you have completed the previous setup steps for your platform(s) you can install our Shortcuts using the Apple provided iCloud sharing links below. When you click a link you'll be prompted to review some information about the Shortcut (and optionally view its code with the... button). After reviewing you can click on theAdd Shortcut button to add it to your Shortcuts app.

Install 'Submit to Truestamp' Shortcut

Install 'Get Observable Entropy' Shortcut

This simple to use shortcut dramatically simplifies the process of submitting many forms of data to the Truestamp API. Additionally, it provides automatic archival storage of any submitted Items and the response Envelope provided by the API.

When you first install the Shortcut you will be prompted to set the following settings:

• Truestamp API URL : You should be able to select the default which ishttps://api.truestamp.com/v1/items.
• Truestamp API Key : This is your personal API key, which can be generated in your account dashboard athttps://www.truestamp.com/dashboard/keys. It is suggested that you generate an API key that expires far in the future, or never expires.

On all platforms, multiple files can be selected and submitted in batches.

There are multiple ways of getting data into the Shortcut and sending it to Truestamp. The available forms of usage depend on the platform you are running the Shortcut on. Here are some examples:

• By selecting file(s) in theFiles application, or within most apps whereShare Sheets are available. Choose theShare >Submit to Truestamp menu item and your item will automatically be submitted. This process should be familiar if you know how to share a photo using the messages app for example.
• By opening the Shortcuts application and tapping theSubmit to Truestamp icon and following the prompt to create some new content (e.g. take a photo), or choose some existing content to submit.

• By selecting file(s) in finder, or anywhere thatQuick Actions are available, and right clicking and choosing theQuick Actions >Submit to Truestamp menu item.
• By clicking theShortcuts menu bar icon (if shown), clickingSubmit to Truestamp and following the prompt to choose a file to share.
• By clicking theSubmit to Truestamp icon within the Shortcuts application and following the prompts to create or choose some content to submit.

More advanced users or developers can also:

• Send data from another Shortcut to theSubmit to Truestamp shortcut.
• Run a Shortcut from thecommand line.

Command line example:

shortcuts run"Submit to Truestamp" -i ./my-important-data.txt

On all platforms the API responseEnvelope and a copy of the original content you submitted to Truestamp, will be stored in theShortcuts >Truestamp folder iniCloud Drive. You can find this folder by navigating in theFiles app on iOS or iPadOS, or within theFinder on macOS. All original content will be hashed with the SHA-256 hash function and stored under its Truestamp ID as the base of the filename. For example, submitting a file calledhello.txt will result in the storage of files with names like:

truestamp_test_01FYW11EKKG48SQ0NEYY813K05_1648060578996000-hello.txttruestamp_test_01FYW11EKKG48SQ0NEYY813K05_1648060578996000.json

This shortcut makes an API call to theObservable Entropy project. This provides incontestable and verifiable public randomness. ASHA-256 hash representing the latest entropy value will be returned by the shortcut.

If prompted to allow permissions to connect toentropy.truestamp.com you should choose toAlways Allow.

This shortcut requires no additional configuration or API keys to operate.

Alternatively, the latest entropy value is also available for real-time display atobservable-entropy.truestamp.com.

Installed Shortcutsdo not update automatically when newer versions are released. You can manually update any Shortcut by deleting the old one and re-installing a new version. The installation links above should always point to the latest versions.

This repository also contains a copy of each shortcut as a file. The files are exported by first single-click selecting them in the Shortcuts application on macOS and then using theFile >Export menu to save the export to thesrc directory in this repository.

Shortcut installation links are created by opening the shortcut in the editor, followed by the share button andCopy iCloud Link. The link(s) should be updated in theInstallation section of this README.md file.

Any software and content provided or linked to here is for the sole use, or review, by Truestamp customers on their own devices. Reproduction or use, in whole, or in part, by others is forbidden.

Copyright © 2020-2022 Truestamp, Inc. All rights reserved.