Let iOS apps talk

A directory of iOS apps that can be launched via URLs including ones that support x-callback-url. Learn more or See the apps.
Is an app / URL missing? Did you find an error? Help me keep the documentation up-to-date. See how to contribute

Create

Create a new document.
onewriter://x-callback-url/create
?path=
The path to the folder in which you want to create the document.
&name=
The name for the document.
&text=
The content for the document. If not specified, the content of the clipboard will be used.

Replace

Replace content of a document.
onewriter://x-callback-url/replace
?path=
The path to the document.
&text=
The content for the document. If not specified, the content of the clipboard will be used.

Replace Selection

Replace selected text in the current editing document.
onewriter://x-callback-url/replace-selected
?text=
The replacement text.

Content

Return content of a document.
onewriter://x-callback-url/content
?path=
The path to the document.
&param=
The content will be passed to the x-success URL using this parameter name. Default value is ”text”.

Create Todo

Create a to-do list by separating lines of the text parameter. You can start a line with ”+” to indicate a completed todo.
onewriter://x-callback-url/create-todo
?path=
The path to the folder in which you want to create the document.
&name=
The name for the document.
&text=
The content for the document. If not specified, the content of the clipboard will be used.

Open document

Create a new document.
onewriter://x-callback-url/open
?path=
The path to the document.

Append

Append to an existing document.
onewriter://x-callback-url/append
?path=
The path to the document.
&text=
The content for the document. If not specified, the content of the clipboard will be used.

Prepend

Prepend content to an existing document.
onewriter://x-callback-url/prepend
?path=
The path to the document.
&text=
The content for the document. If not specified, the content of the clipboard will be used.

Show ”All” Focus List

twodo://x-callback-url/showAll

Show ”Today” Focus List

twodo://x-callback-url/showToday

Show ”Starred” Focus List

twodo://x-callback-url/showStarred

Show ”Scheduled” Focus List

twodo://x-callback-url/showScheduled

Show List

Show List with a given name.
twodo://x-callback-url/showList
?name=
The name of the list.

Add New Task

Launch the app with the New Task Screen.
twodo://x-callback-url/addNewTask
?ignoreDefaults=
Should the ”Ignore Due Date Defaults” be ignored
  • 0 - apply any default due date / time settings in app.
  • 1 - ignore default dates / times.

Search

Launch the app with Search pre filled.
twodo://x-callback-url/search
?text=
The text to search for. Can be just text or something like ”type:overdue”

Get Task Unique Identifier

Returns the internally used unique identifier for the task. x-success is filled with the a key named ”uid”
twodo://x-callback-url/getTaskID
?task=
Known task’s title.
&forList=
The list containing the task.
&saveInClipboard=
Should the UID be saved in the clipboard.
  • 0 - No.
  • 1 - Yes.

Paste Text

Turn text into tasks.
twodo://x-callback-url/paste
?text=
The text to paste
&inProject=
Title of a project to paste into.
&forList=
List that contains the project

Add Task

twodo://x-callback-url/add
?task=
Title of the taks
&type=
Type of taks to create.
  • 0 - Task (default)
  • 1 - Project
  • 2 - Checklist
&forList=
Name of an existing list in app, case-insensitive. Default list or the currently visible list on screen is selected if not used.
&forParentName=
The name of the project or checklist you wish to add this task to. When using this parameter, you must also provide the name of the List this project belongs to, by using the forList parameter.
&forParentTask=
:The internally used, unique identifier of a task. If supplied, this task will be added as a sub-task to the parent task. If the parent task was previously created as a normal task (vs. a project or a checklist), the parent task will automatically be converted into a project for you.
&note=
Notes for the task
&priority=
  • 0 (none)
  • 1 (low)
  • 2 (medium)
  • 3 (high)
&starred=
  • 0 (no)
  • 1 (yes)
&tags=
Comma separated list of tags to assign to the task.
&locations=
Comma separated list of locations to assign to the task.
&due=
Due Date. Supports the format below:
  • yyyy-MM-dd - Sets on the date on default due time (based on your settings, unless due time is specified separately or ignoreDefaults is set to 1)
  • Any number - Number of days from Today, starting from 0. e.g. 0 = Today, 1 = Tomorrow and so on
&dueTime=
Due Time. Supports format HH:mm or hh:mm am/pm.
&start=
Start Date and time. Supports the format below:
  • yyyy-MM-dd HH:mm - Sets on the start date on the date and time specified
  • Any number - Number of days from Today, starting from 0. e.g. 0 = Today, 1 = Tomorrow and so on
&repeat=
  • 1 (daily)
  • 2 (weekly)
  • 3 (bi-weekly)
  • 4 (monthly)
&action=
Supports the following formats:
  • call:<number> - Add a Call action to call the specified number.
  • message:<number> - Add a Message action to message the specified number.
  • mail:<email> - Add a Email action to email the specified email address.
  • url:<url> - Add a Browse action to visit the specified URL address.
  • visit:<address> - Add a Visit action to visit the specified address.
  • google:<search term> - Add a Google action to search the specified keyword.
&picture=
This can be one of two things:
  • lastphoto - 2Do will grab the most recent photo placed on your camera roll.
  • A base64 encoded string.
&audio=
Prvide a base64 encoded audio attachment
&ignoreDefaults=
  • 0 (apply any default due date / time setting in app)
  • 1 (ignore default dates / times)
&useQuickEntry=
  • 0 (add a task without allowing you to edit)
  • 1 (show pre-filled in a Quick Entry window)
&saveInClipboard=
The newly created task’s unique identifier (UID) will be saved in the clipboard for easier retrieval.
  • 0 (no)
  • 1 (yes)

Open Note

Open a note identified by its title or id and return its content.
bear://x-callback-url/open-note
?id=
note unique identifier.
&title=
note title.
&exclude_trashed=
if ”yes” exclude trashed notes.
&x-success=
Your x-success callback will be called with the following parameters
  • note - note text.
  • identifier - note unique identifier.
  • title - note title.
  • is_trashed - ”yes” if the note is trashed.
  • modificationDate - note modification date in ISO 8601 format.
  • creationDate - note creation date in ISO 8601 format.

Create Note

Create a new note and return its unique identifier. Empty notes are not allowed.
bear://x-callback-url/create
?title=
note title.
&text=
note body.
&tags=
a comma seperated list of tags.
&pin=
if ”yes” pin the note to the top of the list.
&file=
base64 representation of a file.
&filename=
file name with extension. Both ”file” and ”filename” are required to successfully add a file.
&open_note=
if ”no” do not display the new note in Bear’s main or external window.
&x-success=
Your x-success callback will be called with the following parameters.
  • identifier - note unique identifier.
  • title - note title.

Add Text

Append or prepent text to a note identified by its title or id.
bear://x-callback-url/add-text
?id=
note unique identifier.
&title=
title of the note.
&text=
text to add.
&mode=
the allowed values are ”prepend”, ”append”, ”replace_all” and ”replace”
&exclude_trashed=
if ”yes” ecxclude trashed notes.
&open_note=
If ”no” do not display the new note in Bear’s main or external window.

Add File

Append or prepend a file to a note identified by its title or id.
bear://x-callback-url/add-file
?id=
note unique identifier.
&title=
note title.
&file=
base64 representation of a file
&filename=
file name with extension. Both file and filename are required to successfully add a file.
&mode=
the allowed values are
  • prepend
  • append
  • replace
  • replace_all
&open_note=
If ”no” do not display the new note in Bear’s main or external window.
&x-success=
Your x-success callback will be called with the following parameters.
  • note - note text

Open Tag

Show all the notes which have a selected tag in bear.
bear://x-callback-url/open-tag
?name=
The tag name.

Rename Tag

Rename an existing tag.
bear://x-callback-url/rename-tag
?name=
The tage name.
&new_name=
The new tag name.

Delete Tag

Delete an existing tag.
bear://x-callback-url/delete-tag
?name=
The tage name.

Trash

Move a note to bear trash.
bear://x-callback-url/trash
?id=
note unique identifier.

Search

Show search results in Bear for all notes or for a specific tag.
bear://x-callback-url/search
?term=
String to search.
&tag=
Tag to search into.

Grab URL

Create a new note with the content of a web page.
bear://x-callback-url/grab-url
?url=
URL to grab.
&images=
If ”yes” grab the pages images
&tags=
a comma separated list of tags.
&pin=
if ”yes” pin the note to the top of the list.
&x-success=
Your x-success callback will be called with the following parameters.
  • identifier - note unique identifier
  • title - note title

Change Theme

Change the selected Bear theme. Some themes may require a Bear Pro subscription.
bear://x-callback-url/change-theme
?theme=
Available values
  • Red Graphite
  • Charcoal
  • Solarized Light
  • Solarized Dark
  • Panic Mode
  • Dracula
  • Gotham
  • Toothpaste
  • Cobalt
  • Duotone Light
  • Duotone Snow
  • Dieci
  • Ayu

Change Font

Change the selected Bear Font.
bear://x-callback-url/change-font
?font=
Available values
  • Avenir Next
  • System
  • Helvetica Neue
  • Menlo
  • Georgia
  • Courier
  • Open Dyslexic

Paste Clipboard

Paste clipboard into Gladys
gladys://x-callback-url/paste-clipboard
?title=
A title to use to override the name of the item being pasted.
&labels=
A comma-separated list of labels that will be added to the item that is being pasted.
&note=
Text to add as a note for the item being pasted.

Instapaper

Add URL

Add the URL to Instapaper.
x-callback-instapaper://x-callback-url/add
?url=
The URL to add.

Overcast

Add Url

Subscribe to a new show under the given URL
overcast://x-callback-url/add
?url=
It will parse the URL and find the associated podcast feed.

Textastic

New File

Create a new file in the local file system or in iCloud. If neither the text parameter nor the snippet parameter is specified, the text to append will come from the clipboard.
textastic://x-callback-url/new
?location=
  • local - default
  • iCloud
&path=
The directory path. If not specified, defaults to the root folder.
&name=
The name of the file to create. If a file with that name already exists, Textastic will append a number to the file name to make it unique. If not specified, a file name will be generated by Textastic.
&text=
The text to insert into the new file.
&snippet=
The snippet to insert. If both the ”snippet” and the ”text” parameter are present, only the ”snippet” parameter will be used.

Open File

Open an existing file in the local file system or in iCloud. If the file doesn’t exist, calls the url from the x-error parameter.
textastic://x-callback-url/open
?location=
  • local - default
  • iCloud
&path=
The directory path. If not specified, defaults to the root folder.
&name=
The name of the file to open.

Append

Open an existing file or create a new file and append text. If neither the text parameter nor the snippet parameter is specified, the text to append will come from the clipboard.
textastic://x-callback-url/append
?location=
  • local - default
  • iCloud
&path=
The directory path. If not specified, defaults to the root folder.
&name=
The name of the file to open. If the file doesn’t exist, it will be created.
&text=
The text to append to the file.
&snippet=
The snippet to append to the file. If both the ”snippet” and the ”text” parameter are present, only the ”snippet” parameter will be used.

Replace

Open an existing file or create a new file and replace its contents with the specified text. If neither the text parameter nor the snippet parameter is specified, the text to append will come from the clipboard.
textastic://x-callback-url/replace
?location=
  • local - default
  • iCloud
&path=
The directory path. If not specified, defaults to the root folder.
&name=
The name of the file to open. If the file doesn’t exist, it will be created.
&text=
The text to insert into the file after its contents are deleted.
&snippet=
The snippet to insert into the file after its contents are deleted. If both the ”snippet” and the ”text” parameter are present, only the ”snippet” parameter will be used.

Add Event

timepage://x-callback-url/add_event
?title=
The title of the event
&day=
The date of the event
  • Date in the format yyyy-mm-dd
  • Special strings ”today” or ”tomorrow”
  • Upcoming weekday name (long or short) such as ”monday”, ”tuesday”, ”wed”, etc. Is specific to the language set by the device. Always specifies the next upcoming day with this name.

Open Event

Open Timepage and show a specified event.
timpage://open_event
?event=
The event identifier
  • special identifiert ”next”
  • event_id

Open Event Map

Open Timepage and show a specified event on the map
timpage://open_event_map
?event=
The event identifier
  • special identifiert ”next”
  • event_id

Open Day

Open Timepage and show a specified day.
timepage://open_day
?day=
Day can be specified as either:
  • Date in the format yyyy-mm-dd
  • Special strings ”today” or ”tomorrow”
  • Upcoming weekday name (long or short) such as ”monday”, ”tuesday”, ”wed”, etc. Is specific to the language set by the device. Always specifies the next upcoming day with this name.

Open Week

Open Timepage and show a specified week
timepage://open_week
?week=
The week to open to. Can be one of
  • ”this” - This week
  • ”next” - Next week
  • index - specifies an offset to the current week. For example, when opening a specific week, index 0=this week, 1=next week, -1=last week, etc.

Open Month

Open Timepage and show a specified month
timepage://open_month
?month=
The month to open to. Can be one of
  • ”this” - This week
  • ”next” - Next week
  • index - specifies an offset to the current month. For example, when opening a specific month, index 0=this month, 1=next month, -1=last month, etc.

Open Weather For A Day

Open Timepage and show weather for a specified day.
timepage://open_weather
?day=
Day can be specified as either:
  • Date in the format yyyy-mm-dd
  • Special strings ”today” or ”tomorrow”
  • Upcoming weekday name (long or short) such as ”monday”, ”tuesday”, ”wed”, etc. Is specific to the language set by the device. Always specifies the next upcoming day with this name.

Open Weather For A Week

Open Timepage and show weather for a specified week.
timepage://open_weather
?week=
The week to open to. Can be one of
  • ”this” - This week
  • ”next” - Next week
  • index - specifies an offset to the current week. For example, when opening a specific week, index 0=this week, 1=next week, -1=last week, etc.

Search

Open Timepage and show search results for the specified search terms.
timepage://search
?query=
Search term to search for.

Get Event

Get a specified event and return its details via a specified callback URL.
timepage://x-callback-url/get_event
?event=
The event identifier
  • special identifiert ”next”
  • event_id
&x-success=
Your x-success callback will be called with the following parameters
  • start - start of the event as <yyyy-mm-dd hh:mm>
  • end - end of the event as <yyyy-mm-dd hh:mm>
  • title - event title
  • location - event location

Show Board

Links to a board.
trello://x-callback-url/showBoard
?id=
board id. Use this or the ”shortlink”
&shortlink=
board shortlink. (can be with or without the ”https://trello.com/b/” prefix). Use this or the ”id”

Show Cards

Links to a card.
trello://x-callback-url/showCard
?id=
card id. Use this or the ”shortlink”
&shortlink=
card shortlink. (can be with or without the ”https://trello.com/c/” prefix). Use this or the ”id”

Create Board

Creates a new board.
trello://x-callback-url/createBoard
?name=
Name for the board.
&organization=
Name of the organization in which to create the board.
&permission=
Permission level to set
  • ”private”
  • ”public - default”
  • ”organization”
&x-success=
The callback will be called with the following parameters:
  • id - the board id
  • shortlink - the board shortlink suffix

Create Card

Creates a new card in a specified board.
trello://x-callback-url/createCard
?id=
bord id. Use this or the ”shortlink”
&shortlink=
bord shortlink. (can be with or without the ”https://trello.com/b/” prefix). Use this or the ”id”
&name=
The name of the new card.
&description=
The description text to attach to the card.
&list-id=
id of the list within the specified board in which to insert the card (Default: First list)
&use-pasteboard=
Interpreted as a boolean (”0”, ”1”, ”true”, ”false”, etc.) that indicates whether the contents of the pasteboard should be included.
&x-success=
The callback will be called with the following parameters:
  • id - the card id
  • shortlink - the card shortlink suffix

New Sheet

Creates a new sheet.
ulysses://x-callback-url/new-sheet
?text=
The contents that should be inserted to the new sheet. Contents are imported as Markdown by default.
&group=
Specifies the group the new sheet should be inserted to. This argument can be set to one of the following values:
  • A group name (e.g. My Group) that will match the first group having the same name, regardless of its position in the group hierarchy.
  • A path to a particular target group (e.g. /My Group/My Subgroup). Any path must begin with a slash.
  • A unique identifier of the target group.
  • If no value is given, the sheet is created inside the Inbox.
&format=
Specifies the format of the imported text. One of:
  • markdown - the default
  • text
  • html
&index=
The position of the new sheet in its parent group. Use 0 to make it the first sheet.

New Group

Creates a new group.
ulysses://x-callback-url/new-group
?name=
The name of the group to be created
&parent=
Specifies the parent group the new group should be inserted to. This argument can be set to one of the following values:
  • A group name (e.g. My Group) that will match the first group having the same name, regardless of its position in the group hierarchy.
  • A path to a particular target group (e.g. /My Group/My Subgroup). Any path must begin with a slash.
  • A unique identifier of the target group.
  • If no value is given, the group is created inside the top level group.
&index=
The position of the new group in its parent group. Use 0 to make it the first group.

Insert

Inserts or appends text to a sheet.
ulysses://x-callback-url/insert
?id=
The identifier of the sheet the text should be inserted to.
&text=
The contents that should be inserted to the new sheet. Must be URL-encoded. Contents are imported as Markdown by default.
&format=
Specifies the format of the imported text. One of:
  • markdown - the default
  • text
  • html
&position=
Optional. Set ”begin” or ”end” in order to insert text at the beginning of a document. If not given, the text is appended.
&newline=
Specifies how newlines should be inserted to the text:
  • prepend - prepend the inserted text by a newline.
  • append - append the inserted text with a newline.
  • enclose - enclose the entire text with newlines.

Attach Note

Creates a new note attachment on a sheet.
ulysses://x-callback-url/attach-note
?id=
The identifier of the sheet the text should be inserted to.
&text=
The contents that should be inserted to the new sheet. Must be URL-encoded. Contents are imported as Markdown by default.
&format=
Specifies the format of the imported text. One of:
  • markdown - the default
  • text
  • html

Update Note

Changes an existing note attachment on a sheet. Requires authorization.
ulysses://x-callback-url/update-note
?id=
The identifier of the sheet the text should be inserted to.
&text=
The contents that should be inserted to the new sheet. Must be URL-encoded. Contents are imported as Markdown by default.
&format=
Specifies the format of the imported text. One of:
  • markdown - the default
  • text
  • html
&index=
The position of the note to change. Use 0 for the first note, 1 for the second note, and so on.

Remove Note

Removes a note attachment from a sheet. Requires authorization.
ulysses://x-callback-url/remove-note
?id=
The identifier of the sheet from which a note should be removed.
&index=
The position of the note to remove. Use 0 for the first note, 1 for the second note, and so on.

Attach Image

Creates a new image attachment on a sheet.
ulysses://x-callback-url/attach-image
?id=
The identifier of the sheet the image should be attached to.
&image=
The image data that should be used. The data must use base64 encoding. Make sure that the base64-encoded data is also URL encoded.
&format=
The format of the provided image (use an image path extension, like png, pdf, jpg, raw, gif).
&filename=
A filename the image format should be detected from. Either the argument format or filename must be provided.

Attach Keywords

Adds one or more keywords to a sheet.
ulysses://x-callback-url/attach-keywords
?id=
The identifier of the sheet the keywords should be attached to.
&keywords=
A comma separated list of keywords that should be attached to the sheet.

Remove Keywords

Removes one or more keywords from a sheet. Requires authorization.
ulysses://x-callback-url/remove-keywords
?id=
The identifier of the sheet the keywords should be removed from.
&keywords=
A comma separated list of keywords that should be removed from the sheet.

Set Group Title

Changes the title of a group. Requires authorization.
ulysses://x-callback-url/set-group-title
?group=
The group for which the title should be changed. This argument can be set to one of the following values:
  • A group name (e.g. My Group) that will match the first group having the same name, regardless of its position in the group hierarchy.
  • A path to a particular target group (e.g. /My Group/My Subgroup). Any path must begin with a slash.
  • A unique identifier of the target group.
&title=
The new title

Set Sheet Title

Changes the first paragraph of a sheet. Requires authorization. If the sheet has a first paragraph with the requested type, the paragraph contents will be changed (a heading replaces any existing heading). Otherwise, a new paragraph with the requested type and contents will be inserted at the beginning of the sheet.
ulysses://x-callback-url/set-sheet-title
?sheet=
The identifier of the sheet for which the title should be changed.
&type=
The type of paragraph to use for the title. This argument can be set to one of the following values:
  • ”heading1”, ..., ”heading6” - to use a heading paragraph.
  • ”comment” - to use a comment paragraph.
  • ”filename” - to use a filename paragraph such as ”@: My Filename”. Only applies to sheets in external folders.
&title=
The new title

Move

Moves an item (sheet or group) to a target group and/or to a new position. Requires authorization.
ulysses://x-callback-url/move
?id=
The identifier of the item (sheet or group) that should be moved.
&targetGroup=
Optional if ”index” is set. The group where the item should be moved. This argument can be set to one of the following values:
  • A group name (e.g. My Group) that will match the first group having the same name, regardless of its position in the group hierarchy.
  • A path to a particular group (e.g. /My Group/My Subgroup). Any path must begin with a slash.
  • A unique identifier of a sheet or group that should be opened. If the parameter is not set, the item will be moved inside of its current parent group.
&index=
Optional if ”targetGroup” is set. The position of the item in its target group. Use 0 to make it the first item.

Copy

Copies an item (sheet or group) to a target group and/or to a new position.
ulysses://x-callback-url/copy
?id=
The identifier of the item (sheet or group) that should be copied.
&targetGroup=
Optional if ”index” is set. The group where the item should be copied. This argument can be set to one of the following values:
  • A group name (e.g. My Group) that will match the first group having the same name, regardless of its position in the group hierarchy.
  • A path to a particular group (e.g. /My Group/My Subgroup). Any path must begin with a slash.
  • A unique identifier of a sheet or group that should be opened. If the parameter is not set, the item will be moved inside of its current parent group.
&index=
Optional if ”targetGroup” is set. The position of the item in its target group. Use 0 to make it the first item.

Trash

Moves an item (sheet or group) to the trash. Requires authorization.
ulysses://x-callback-url/trash
?id=
The identifier of the item (sheet or group) that should be moved to the trash.

Get Item (Group)

Retrieves information about a group. Requires authorization.
ulysses://x-callback-url/get-item
?id=
The identifier of the group for which to retrieve information.
&recursive=
Determines whether the result should include all sub-groups of the group. The allowed values are:
  • ”YES” - the default
  • ”NO”
&x-success=
The ”x-success” callback retrieves an argument ”item”. The value is a URL-encoded JSON object providing information on the requested group with the following structure.
  • title - The title of the group.
  • type - The type of the item. This can be ”group”, ”filter” or ”trash”.
  • identifier - The identifier of the group
  • hasLifetimeIdentifier - hether the identifier stays the same even if the group is moved or renamed. ”true” for items that are stored in the sections “iCloud” or “On My Mac” / “On My iPad”. ”false” for items in external folders or Dropbox.
  • containers - the item descriptions for all child groups of this group. Will be empty if the parameter ”recursive” was set to ”NO”.
  • sheets - The item descriptions for all sheets of this group. Will be empty for filters.

Get Item (Sheet)

Retrieves information about a sheet. Requires authorization.
ulysses://x-callback-url/get-item
?id=
The identifier of the item sheet for which to retrieve information.
&x-success=
The ”x-success” callback retrieves an argument ”item”. The value is a URL-encoded JSON object providing information on the requested sheet with the following structure.
  • title - The title of the sheet.
  • titleType - The markup type of the title. Will be set to ”heading1”…”heading6”, ”comment” if the title is a heading or comment. Will be set to ”filename” on external folders or Dropbox if the title is the sheet’s filename (e.g. ”@: My Filname”). If no title is given this vlaue is set to ”null”.
  • type - The type of the item (always ”sheet”)
  • identifier - The identifier of the sheet.
  • hasLifetimeIdentifier - hether the identifier stays the same even if the group is moved or renamed. ”true” for items that are stored in the sections “iCloud” or “On My Mac” / “On My iPad”. ”false” for items in external folders or Dropbox.
  • changeToken - A value that identifies the current verison of the sheet. The change token will have a different value whenever the sheet changes.
  • modificationDate - The timestamp when the sheet was last modified. The timestamp is given as the number of seconds relative to ”00:00:00 UTC on 1 January 2001.”
  • creationDate - The timestamp when the sheet was last created.

Get Root Items

Retrieves information about the root sections. Can be used to get a full listing of the entire Ulysses library. Requires authorization.
ulysses://x-callback-url/get-root-items
?recursive=
Determines whether the result should be a deep listing of the entire Ulysses library. The allowed values are ”YES” and ”NO”. Defaults to ”YES”.
&x-success=
The ”x-success” callback retrieves an argument ”items”. The value is a URL-encoded JSON array. It contains an info object for each section such as „iCloud”, „On My iPad”, and one for each external folder.

Read Sheet

Retrieves the contents (text, notes, keywords) of a sheet. Requires authorization.
ulysses://x-callback-url/read-sheet
?id=
The identifier of the sheet that should be read.
&text=
Determines whether the full text of the sheet should be included in the result. The allowed values are ”YES” and ”NO”. Defaults to ”NO”.
&x-success=
The ”x-success” callback retrieves an argument ”sheet”. The value is a URL-encoded JSON object. It has the following structure:
  • title - The title of the sheet.
  • titleType - The markup type of the title. Will be set to ”heading1”…”heading6”, ”comment” if the title is a heading or comment. Will be set to ”filename” on external folders or Dropbox if the title is the sheet’s filename (e.g. ”@: My Filname”). If no title is given this vlaue is set to ”null”.
  • type - The type of the item (always ”sheet”)
  • identifier - The identifier of the sheet.
  • hasLifetimeIdentifier - hether the identifier stays the same even if the group is moved or renamed. ”true” for items that are stored in the sections “iCloud” or “On My Mac” / “On My iPad”. ”false” for items in external folders or Dropbox.
  • changeToken - A value that identifies the current verison of the sheet. The change token will have a different value whenever the sheet changes.
  • modificationDate - The timestamp when the sheet was last modified. The timestamp is given as the number of seconds relative to ”00:00:00 UTC on 1 January 2001.”
  • creationDate - The timestamp when the sheet was last created.
  • text - The sheets content encoded as Markdown. This is only available if the ”text” parameter was set to ”YES”.
  • keywords - The keywords of the sheet as an array of strings.
  • notes - The notes of the sheet as an array of strings. All notes are encoded as Markdown.
&Open=
Opens an item (sheet or group) with a particular identifier in Ulysses.

Open All

Opens the special “All” group
ulysses://x-callback-url/open-all

Open Recent

Opens the special “Last 7 days” group
ulysses://x-callback-url/open-recent

Open Favorites

Opens the special “Favorites” group
ulysses://x-callback-url/open-favorites

Stream

Plays the stream provided by the ”url” parameter
vlc-x-callback://x-callback-url/stream
?url=
The URL to stream

Download

Download the file provided by the ”url” parameter
vlc-x-callback://x-callback-url/download
?url=
The URL to stream
&filename=
VLC will store the file under the given filename.

Open Workflow

Launch the app to the state when it was last used.
workflow://

Create A New Workflow

Jump to My Workflows and create an empty new workflow.
workflow://create-workflow

Open A Workflow

Launch the app to a particular workflow in your collection.
workflow://open-workflow
?name=
The name of the workflow

Run A Workflow

This functionality may be useful in automation systems that extend beyond Workflow itself, so other apps can run a workflow in your collection. Or, you could utilize this URL in a task manager like OmniFocus or Todoist for running a workflow as one step in a project.
workflow://x-callback-url/run-workflow
?name=
The name of the workflow
&input=
This value determines what will be provided as input to the beginning of the workflow.
  • ”text” - the input given by the parameter ”text” will be used as input.
  • ”clipboard” - the contents of the clipboard will be used as input.
&text=
When the ”input” parameter is set to ”text” this text is used as input to the workflow.
&x-success=
When the run was successful the callback will be called with
  • result - the textual output of the workflow.
&x-error=
When there was an error the callback will be called with
  • errorMessage - a description of the error.

Import A Workflow

Workflow also has the ability to accept .wflow files and import them into My Workflows. This is useful, for example, if you would like to share a workflow online and provide a link for others to instantly add it to their library.
workflow://x-callback-url/import-workflow
?url=
A URL pointing to the .wflow file you want to import.
&name=
What to name the new workflow. If not provided, the workflow filename is used.
&silent=
By default, the imported workflow will be opened and displayed to the user. Set this parameter to ”true” to import without opening the workflow.
&x-success=
When the run was successful the callback will be called with
  • result - the textual output of the workflow.
&x-error=
When there was an error the callback will be called with
  • errorMessage - a description of the error.

Open Gallery

Open workflow on the main page of the gallery.
workflow://gallery

Search Gallery

Search the gallery
workflow://gallery/search
?query=
The query to search for