Apptrope
  • Docs
  • Home
  • Download
  1. Sharing & trust
  2. Deep links
  • Getting started
    • Getting started
    • Loading an app
    • How dependencies are handled
    • Supported frameworks
  • Using the app
    • The workbench
    • Environment variables & secrets
  • Sharing & trust
    • Sharing apps as signed bundles
    • Trust: publishers, rotation & revocation
    • Deep links
  • Help
    • Troubleshooting

On this page

  • Deep links
    • How it works
    • What a link can point to
    • Trust and safety
    • After it opens
  1. Sharing & trust
  2. Deep links

Deep links

Apptrope registers the apptrope:// URL scheme, so a link can open Apptrope and run an app for you. Put an apptrope:// link on a web page or in a message, and clicking it hands the app source to Apptrope, which loads and runs it just like typing that source into the Run bar yourself.

How it works

  1. You click an apptrope:// link on a page or in a message.
  2. Your operating system opens Apptrope (starting it first if it isn’t already running).
  3. Apptrope reads the app source from the link and runs it, resolving dependencies into an isolated environment on the first run, then reusing that environment on later runs.
  4. The app opens in its own tab and is saved to your Library automatically.

What a link can point to

A deep link references one of Apptrope’s supported app sources, most usefully a remote one that anyone can reach:

  • A Git repo (GitHub, gist, GitLab, or Bitbucket)
  • A direct archive URL (a .zip or .tar)
  • A shareable .apptrope bundle file

This makes apptrope:// links a handy “run this app” button to drop into a README, a blog post, a docs site, or a chat.

Trust and safety

Deep links run code, so the same trust-on-first-use rules apply as when you run any source. The first time you open an app from a source you haven’t trusted, Apptrope shows a Confirm before running dialog before anything executes:

  • It states plainly that this will download and run code from the source.
  • It shows the signature status, for example “its integrity was verified” or “Signed by <fingerprint> (<name>)”.
  • You can choose Trust this publisher and Remember this source.

Once you’ve pinned a publisher’s key, their signed apps opened via a deep link launch without a confirmation prompt. You manage trusted publishers, your own identity, and revoked keys from the Publishers panel in the top bar.

After it opens

The app behaves exactly like one you started from the Run bar:

  • It runs in a native window and gets its own tab, so it can sit alongside other running apps.
  • Full per-run output is captured in the app’s logs.
  • It’s added to your Library, where you can search for it, pin or rename it, set per-app environment variables, or export it as a bundle from the ⋯ menu.

Apptrope · run any R or Python app in a real window

 

Built with Quarto