With version 1.7, Daedalus Touch adds support to x-callback-urls, allowing other apps to trigger certain actions in Daedalus Touch such as creating new sheets or searching for a string in a stack.
The used scheme is
Every action can be called through the x-callback-url API using the following format:
daedalus://x-callback-url/[action]?[x-callback parameters]&[action parameters]
For more information regarding the URL format, see the official specification.
In the following, all available actions are detailed. Please note that for reasons of clarity, the examples are not yet URL escaped. For instance, all whitespace must be replaced with
Creates a new sheet.
stackTitle: The title of the stack in which the sheet should be created. The name does not need to match exactly the stack title, since the search process is case-insensitive, diacritics-insensitive and also matches prefixes of stack titles.
title: The title of the new sheet.
content: The content to be added to the new sheet.
Example: To create a new sheet with the title “Star Trek” inside the stack “Movie Quotes”:
daedalus://x-callback-url/new-sheet?stackTitle=Movie Quotes&title=Star Trek
To add content while creating the sheet:
daedalus://x-callback-url/new-sheet?stackTitle=Movie Quotes&title=Star Trek&content=Nooooooo
Creates a new stack.
title: The title of the new stack.
Example: Create a new stack with the name “Summer Holidays”:
Opens the stack with the given title. If no stack can be found with the name, an error is returned to the calling application.
title: The title of the stack to open. The name does not need to match exactly the stack title, since the search process is case-insensitive, diacritics-insensitive and also matches prefixes of stack titles.
Example: Open the new stack with the name “Lecture Notes”:
Searches either all stacks or just a specific one for a string.
query: The search string.
title: The title of the stack in which the search should be run. If left empty or no matching stack can be found, all stacks are searched. The matching is case-insensitive, diacritics-insensitive and also matches prefixes of stack titles.
Example: Search for “Clara” in the stack “Summer Holidays”:
In addition to Daedalus’ action parameters, the generic x-callback parameters can also be included. All of these are optional.
x-source: The name of the source app calling the action.
x-success: URL to open to return to the source app. If not provided, the user stays in Daedalus.
x-error: URL to open if the requested action generates an error in Daedalus. Currently, this is only the case for
open-stack. If a stack cannot be found, an error description and error code “1” is returned.
x-cancel: URL to open if the requested action is cancelled by the user. Currently not used by Daedalus.
Example: If a new stack should be created and the user wants to return to the calling app (say, “SourceApp”) afterwards, use the following URL (line breaks are for legibility):
daedalus://x-callback-url/new-stack? x-source=SourceApp& x-success=sourceapp://x-callback-url/success& title=Lecture Notes