Dropbox Actions

Topics

Text File: New, Append, and Prepend

These actions allow you to create or make changes to plain text files on Dropbox. (New in 2.2)

launch://dropbox/new         # creates a new file
launch://dropbox/append      # appends to file (creates if not found)
launch://dropbox/prepend     # prepends to file (creates if not found)

Parameters

  • text
    • Required
    • The text that will be appended/prepended to the file.
    • Encode value if needed
    • Example:
      • ?text=[prompt-return:My Note]
  • path
    • It should point to a directory in your Dropbox. It will be created if it doesn’t exist.
    • Optional
      • If not supplied, defaults to: /Apps/Launch Center Pro/notes/
    • Example:
      • &path={{/Notes/My Notes/}}
      • Encode value if needed. Shown here with {{}} helpers, though manual encoding works as well.
  • name
    • Specifies the filename as saved to Dropbox.
    • Optional
      • If not supplied, defaults to a date/time based naming scheme.
    • Advanced Feature:
      • You may use the tag [firstline] in the name value. This will extract the text in the first line of your text value for use in the filename. Note that you may remove the first line’s text from the file by setting leavefirstline to NO. (described below)
    • Examples:
      • &name=MyFile.markdown
      • &name=note_[firstline].text
      • Encode value if needed
  • overwrite
    • Optional
      • Default is NO for new
      • Default is YES for append and prepend
    • If NO and an existing version is found, the new filename will be determined by Dropbox, usually by appending (1), etc.
    • Overwritten files are still versioned and old versions are available via the Dropbox web interface.
    • Example:
      • &overwrite=NO
  • getlink
    • Optional
      • Default is NO
    • If YES, a followup callback to Dropbox is performed to get a sharable link to the file just uploaded, and it is placed on the clipboard.
  • linebreak (Append and Prepend only)
    • Optional
      • Default is YES
    • If NO, text will be inserted without a linebreak between the old and new content.
  • leavefirstline
    • Optional
      • Default is YES
    • Advanced Feature:
      • If using the [firstline] tag in the name parameter value, you may optionally have it removed from the supplied text value by specifying NO.

Upload Photo

This action allows you to upload an image to any path in your Dropbox, and optionally get a sharable link when complete.

Base URL

launch://dropbox/addphoto

Parameters

  • attach
    • Required
    • You may use any of the photo attachment types:
      • ?attach=photo
      • ?attach=photo:last
      • ?attach=photo:camera
      • ?attach=photo:frontcamera
      • ?attach=photo:library
      • ?attach=photo:cameraroll
      • ?attach=photo:clipboard
  • path
    • It should point to a directory in your Dropbox. Will be created if doesn’t exist.
    • Optional
      • If not supplied, defaults to: /Apps/Launch Center Pro/photos/
  • name
    • Specifies the filename as saved to Dropbox.
    • Optional
      • If not supplied, defaults to a date/time based naming scheme.
    • Example:
      • &name=MyFile.png
      • Encode value if needed
  • getlink
    • yes/no
    • If yes, a followup callback to Dropbox is performed to get a sharable link to the file just uploaded, and it is placed on the clipboard.
    • Optional
      • Defaults to NO.
    • Example:
      • &getlink=YES

Examples

Take a photo with front camera and add to my /selfies/ folder. Install Action

launch://dropbox/addphoto?attach=photo:frontcamera&path={{/selfies/}}

Upload last photo to /snaps/, copy a link to clipboard, and start a Tweet. Install Action

launch://x-callback-url/dropbox/addphoto?attach=photo:last&path={{/snaps/}}&getlink=yes&x-success=launch%3A%2F%2Ftweet%3Ftext%3D%5Bclipboard%5D

Select a GIF from a folder in the root of Dropbox called “reactions” (can include subfolders) and attaches it to a message. A prompt is used for the body of the message. Here’s a “reactions” starter folder if you don’t already have one. Install Action

launch://messaging?to=555-555-5555&body=[prompt:Body]&attach=photo:dropbox&path=reactions

Grabs a text file from a “messages” folder in the root of Dropbox and uses that as the body for a text message. Here’s a “messages” folder to use for testing. Install Action

launch://messaging?to=555-555-5555&body=[dropbox-text:messages]

Copy File or Link

This action copies the contents of a file (image or plain text) or a sharable link to the clipboard.

Base URL

launch://dropbox/clipboard

Parameters

  • path
    • It should point to a folder or image/text file in your Dropbox.
    • Optional
      • If not supplied, a Dropbox browser will be presented from the root of Dropbox.
    • If the path points to a folder, a Dropbox browser will be presented starting from that folder.
  • linkonly
    • yes/no
    • If yes, a sharable link will always be returned rather than file contents.
    • If the file is not a photo or plain-text file, a link will be returned regardless.

Examples

Presents a Dropbox browser at the root of your Dropbox folder. Install Action

launch://dropbox/clipboard

Presents a Dropbox file browser starting in the /photos/ directory. Once selected, a link to the file is copied to your clipboard. Install Action

launch://dropbox/clipboard?path={{/photos/}}&linkonly=yes

Copies the contents of a specific image to the clipboard. Install Action

launch://dropbox/clipboard?path={{/photos/myfunnycat.gif}}

Miscellaneous

Other Dropbox-Related Features

In addition to the Dropbox actions, Launch Center Pro also supports:

Powered by Zendesk