DEVONthink To Go VERSION 2.7.9 DOCUMENTATION

© 2001-2021 DEVONtechnologies TABLE OF CONTENTS

READ ME 4 SHARE OR CLIP DATA 22

What's new 4 Use the Files app 22 About DEVONtechnologies 11 Use drag-and-drop 23 Credits 11 Capture data 23 Scan paper documents 23 MANAGE YOUR DATABASES 12 Create notes and search with Siri 24 Create new items 12 Share data 24 Sync 12 Share documents 25 Get help 13 Use iTunes to batch-import documents 25 Customize the settings 13 SYNC YOUR DATABASES 27 MANAGE YOUR ITEMS 14 Quick start 27 Top-level groups 14 Scenarios 27 Customize the view 14 Synchronizing everything or just the Search 15 metadata 28 Get more information about an item 15 Setting up sync 29 Create new items 16 Setting up Bonjour 30 Organize your documents 16 Troubleshooting 31 Share items 17 CUSTOMIZE THE APP SETTINGS 33 Use the grid view 17 Premium features 33 VIEW AND EDIT YOUR DOCUMENTS 19 Security 33 Common options 19 Sync settings 33 Plain text and Markdown 19 Group settings 35 Rich text and formatted notes 20 Document settings 35 Images 20 Integration settings 35 PDFs 20 Backup settings 35 Bookmarks and HTML 21 Log 35 Sheets 21 FREQUENTLY ASKED QUESTIONS 37 Movies and audio files 21 Other 21 Security 37 Spotlight 38 Synchronization 38 Contacting us 38

DEVONthink To Go 2.7.9 Documentation, page 2 OTHER PRODUCTS 40

Overview 40 DEVONthink 40 DEVONagent 40 DEVONsphere 41 Needful Things 41

APPENDIX 42

Glossary 42 Iconology 44 Tagging 44 Search operators 45 Item links and paths 47 URL commands 48

DEVONthink To Go 2.7.9 Documentation, page 3 READ ME

IN THIS CHAPTER Take your documents with you Create and edit documents on the go What's new 4 Find using fast full-text search About DEVONtechnologies 11 Organize your knowledge wherever you are Credits 11 Sync your databases with DEVONthink for Put your notes, text documents, images, Mac or other devices running DEVONthink and bookmarks into your pocket with To Go DEVONthink To Go. Have them always at hand even when you are not connected to your office network or the Internet.

WHAT'S NEW

New Improved Fixed Removed

VERSION 2.7.9

This maintenance update fixes a crash related to adding PDF annotations on iOS 14, an issue where URLs could no longer be be added to documents via the Info popover, and more.

Adding annotations to PDFs crashed the app on iOS 14.x. Fixed. URLs couldn't be added to regular documents anymore. Fixed. The Info popover from the detail view could appear too narrow. Fixed. Calculating all tags of an item could crash the app in some rare cases. Fixed. If the app crashed on launch, web archives to be added were lost. Fixed.

Sync — The background fetch could, theoretically, freeze the app in the background. Fixed.

VERSION 2.7.8

This is (one of) the last maintenance update(s) for DEVONthink To Go 2. It prepares the data store for version 3.0, which has been in the works for a while and will become available as a separate app in the App Store in due course. A welcome screen will inform you about the arrival of DEVONthink To Go 3.0. The update to 2.7.8 also brings those bug fixes over from version 3 that don't depend on larger changes to the database or app structure, or would make the app

DEVONthink To Go 2.7.9 Documentation, page 4 incompatible to iOS 11 and 12. And finally, we've updated the PDF library and MultiMarkdown support as well as brought the sync submodule on part with DEVONthink 3.6 for Mac and the upcoming DEVONthink To Go 3.0.

Added welcome screen that will appear when DEVONthink To Go3.0 becomes available. The data store, settings, and sync data are moved to a shared location where they can be picked up by version 3.

Documents can be added to Favorites too. Search more reliably finds words containing a hyphen. Sheets no longer display DEVONthink for Mac column type identifiers in their header row. Very long PDFs are now scaled to width. Sync locations no longer show file name extensions. Added support for iOS 14 local network access security. Added support for newer App Store URL scheme. More reliable full-text reindexing. Improved timeout handling of clearing duplicates. PDF library to updated to latest version that is still compatible to iOS 11. Markdown support updated to MultiMarkdown 6. Further minor performance, responsiveness, and reliability enhancements.

Sync — Dropbox uploads are now limited to four concurrent connections and the minimal time between two upload connections is 0.5 seconds. This reduces up to 90% of temporary rate limiting errors and might also reduce the likelyhood of Drobopx stalls and timeouts. Also: improved automatic retry handling in case of rate limiting errors and improved multi-threading of Dropbox support. Sync — Reduced CPU, memory, and battery usage of Dropbox sync stores and iCloud upload monitor. Sync — Improved multi-threading and better support for asymmetric multi processing. Sync — More reliable synchronizing of tags, e.g., after replicating ordinary tags. Sync — Better and more consistent logging. Sync — Reduced load for push notification server. Sync — Improved overall reliability and performance.

Autosaving PDFs could cause interruptions or streaks while drawing. Fixed. PDFs without annotation permissions could be annotated. Fixed. RSS feeds didn't show shallow/full sync controls. Fixed. Searching for multiple tags separated by semicolons didn't work. Fixed. Setting only the tags via x-callback-url didn't work. Fixed. Importing files from the Files app didn't work due to permissions issues. Fixed. Documents added by drag-and-drop were not searchable. Fixed.

DEVONthink To Go 2.7.9 Documentation, page 5 Voice notes played with very low volume on iOS 13 and later. Fixed. Changing a group's tags was not reflected in the details string of its children. Fixed. New tags were not necessarily marked as such. Fixed. Records moved to another database could be purged under certain circumstances even though they were not synced yet. Fixed. Sorting by name could order some items differently in item lists and in the destination selector. Fixed. The toolbar for documents wasn't updated after downloading the document on demand. Fixed. The button for expanding the detail view sometimes vanished randomly. Fixed. The activity indicator wasn't always properly shown during a database migration. Fixed. Various glitches of the database list. Fixed. The "Saved" notification ducked the suggestion bar. Fixed by removing the unnecessary notification. After selecting PDF search results and scrolling, the found results were not highlighted. Fixed. Conversions were shown for items not yet downloaded. Fixed When switching the item list out of editing mode, the selected item showed a checkmark for a fraction of a second. Fixed. The full-screen progress indicator label was clipped on iPhone in portrait orientation. Fixed. Moving items with the Files app did not reliably work. Fixed. PDFs were reloaded unnecessarily after saving, causing side-effects such as changing unexpectedly from double spread view to single pages. Fixed. Background tasks were not correctly marked as ended and so caused unnecessary console messages. Fixed. Some examples for URL commands appeared as clickable links in the integrated help. Fixed. Documents without content could crash the app. Fixed. Extracting PDF metadata could crash the app. Fixed. Updating the app badge could crash the app. Fixed. Scrolling in lists with a large number of items could crash the app. Fixed. Starting maintenance tasks while the app was going into the background could crash the app. Fixed. Creating a formatted note with Clip to DEVONthink crashed the extension. Fixed Opening documents with invalid item link could potentially crash the app. Fixed. Collecting data in the file provider extension could crash the extension. Fixed. Importing files from, e.g., the Files app, could freeze the app. Fixed. Calculating sheet column widths could crash the app. Fixed. Deleting items could crash the app in rare situations caused by recursive group structures. Fixed. Converting web archives could crash the app. Fixed.

DEVONthink To Go 2.7.9 Documentation, page 6 Fixed other potential glitches and crashes.

Sync — iCloud locations could be added multiple times. Fixed.

Sync — %20 in URLs was converted to + which confused some WebDAV servers. Fixed. Sync — During a sync, the indexed status of items was changed even though it didn't need to. Fixed. Sync — Duplication was enabled for conflicts in case of Bonjour syncs. Fixed. Sync — Updating the sync status button could crash the app. Fixed. Sync — Rare issue of duplication in case of conflicts of indexed items. Fixed. Sync — In case of temporary server issues of Dropbox endless retries could be performed. Fixed. Sync — Obsolete files/folders might not have beem removed from the internal sync status folder after cleaning sync stores. Fixed. Sync — WebDAV session handling could throw harmless exceptions. Fixed. Sync — Skip state restoration when the background sync is active to prevent a (harmless) console warning. Sync — Requesting the sync status of databases synchronized through Bonjour could crash the app. Fixed. Sync — When the background app refresh was triggered before the app was even launched at least once, the app crashed. Fixed. Sync — Broken status files could crash the app. Fixed. Sync — Empty sync store uploads could crash the app. Fixed. Sync — Rare crashes related to multi-threading. Fixed.

VERSION 2.7.7

This maintenance release allows you to merge floating toolbars with the top toolbar to move them out of the way, and increases the size of preview images. Version 2.7.7 also improves the performance when handling PDFs, better avoids reindexing metadata unnecessarily, and fixes a number of bugs and glitches.

The floating toolbars of PDFs and sheets can be merged into the top toolbar; the chosen position is saved.

Larger preview images for shallowly synced items. Items can be moved to another database even when an item with the same internal ID already exists; the item will be replicated instead. Items that are changed externally are updated more reliably. Application state is restored more reliably when returning to DEVONthink To Go (iOS 13 or later). Opening URLs externally is more consistent.

DEVONthink To Go 2.7.9 Documentation, page 7 Reindexing metadata happens less often unnecessarily. Better performance when checking for item kinds. Better performance when retrieving item metadata. PDF library updated.

Sync — WebDAV URLs are encoded before saving if necessary. Sync — Duplicating items in case of conflicts is more reliable.

Fixed a crash related to recursive parent structures. Fixed an issue where documents were reloaded unnecessarily when switching away from DEVONthink To Go and returning. Fixed an issue where flagging items by swiping didn't mark the item as needing sync. Fixed an issue where internal record types for, e.g., email documents were wrong. Fixed an issue where larger PDFs would load slowly and freeze the UI for up to several seconds. Fixed an issue where some searches didn't work when using search scopes. Fixed an issue where the back button would vanish on iPad in portrait orientation. Fixed an issue where the page position of a PDF would continually change when rotating the device. Fixed an issue where user interface elements vanished after searching (iOS 12). Fixed an issue where webarchives and images created by URL schemes couldn't be tagged. Fixed a glitch where the toolbar items would flicker when switching to a new document.

Sync — Fixed a crash related to synchronizing on the local network.

VERSION 2.7.6

This maintenance release improves the reliability and performance when synchronizing via iCloud and updates the integrated Dropbox support. It also launches DEVONthink To Goexplicitly in light mode to avoid issues with text being hardly readable while we're preparing full dark mode support.

Special but not mandatory groups can be trashed or put back. Videos no longer play automatically. File sizes are calculated with 1000 bytes per kilobyte, similar to the Mac Finder. PDF library updated.

Sync — More flexible layout of sync store settings. Sync — Automatic iCloud sync synchronizes now at least once per minute. Sync — Improved iCloud reliability and performance. Sync — Improved localizations. Sync — Dropbox SDK updated.

DEVONthink To Go 2.7.9 Documentation, page 8 Fixed issues related to dark mode by temporarily running DEVONthink To Go explicitly in light mode until dark mode is fully implemented. Fixed an issue where the title and/or URL of shared news articles would not longer be used by Clip to DEVONthink (iOS 13 or later). Fixed an issue where video no longer played in fullscreen (iOS 13 or later). Fixed an issue where some text wasn't localized. Fixed a crash related to editing sheets.

Sync — Fixed an issue where databases available both locally and remotely were not labeled as such. Sync — Fixed an issue where the activity indicator wasn't shown while remote databases were collected for the database list. Sync — Fixed an issue where confusing "File not yet available" messages were shown. Sync — Fixed an issue where unnecessary "Path exists already" messages were shown, e.g., in case of an unreliable network. Sync — Fixed a crash related to activating databases with pending items for sync.

VERSION 2.7.5

This maintenance release improves Clip to DEVONthink on iOS 13 as well as the item selection handling. The update also fixes a number of issues and crashes, the most prominent ones being a crash on launch on older iOS devices and a crash related to the memory management of the PDF viewer.

Improved Clip to DEVONthink share sheet layout (iOS 13 or later). Clip to DEVONthink now handles PDFs too, e.g., full page screenshots of web pages (iOS 13 or later). Improved item list selection handling. PDF library updated.

Fixed a crash related to coordinating file access with third-party apps. Fixed a crash related to entering multiple tags. Fixed a crash related to memory management in the PDF library. Fixed a crash related to missing Swift libraries on some devices. Fixed a crash related to reading PDF metadata. Fixed an issue where importing the last photo taken didn't work. Fixed an issue where PDFs had no contextual menu on long press. Fixed an issue where scans imported from Scanner Pro were not indexed. Fixed an issue where scrolling to selected document showed an artifact (iOS 13 or later). Fixed an issue where the large list titles would not animate correctly (iPadOS 13 or later).

DEVONthink To Go 2.7.9 Documentation, page 9 Fixed an issue where the navigating back from a search result jumped back to the database list. Fixed an issue where the scope bar was no longer visible (iOS 13.1 or later). Fixed an issue where the tag suggestion menu did not dismiss if not used.

VERSION 2.7.4

This maintenance release improves iCloud upload monitoring. It also fixes issues with self-closing popovers on iPad, missing Edit buttons for sheets, and a crash when adding photo animations to PDFs. Finally, we've tweaked some some slightly off animations.

Fixed an issue where popovers on iPad would close spontanously on device movement. Fixed an issue where resize animations of modal views on iPhone looked wrong. Fixed an issue where sheets had no Edit button on iPad. Fixed an issue where sorting by kind with groups ordered to top caused a wrong sorting order. Fixed an issue where text selection in PDFs was no longer possible in version 2.7.3. Fixed an issue where the Authenticate Again slider could be changed without entering the PIN first. Fixed an issue where the item count buttons would animate when changing the sorting order. Fixed an issue where the PDF search popover was anchored to the wrong button. Fixed an issue where the search bar's cancel button wouldn't be hidden. Fixed an issue where the toolbar would flicker when navigating between documents. Fixed an issue where the toolbar buttons in Clip to DEVONthink used a wrong font while being tapped. Fixed a crash related to adding image annotations to PDFs with the camera on iPad. Fixed a crash related to error loading optimized data store model. Fixed a crash related to generating info strings for documents.

Sync — Fixed an issue where the sync location cells started in white and animated to clear. Sync — Fixed rare crash of Bonjour sync due to assertions. Sync — Fixed a harmless multithreading issue.

Sync — iCloud upload monitoring.

VERSION 2.7.3 … 1.0

...

DEVONthink To Go 2.7.9 Documentation, page 10 ABOUT DEVONTECHNOLOGIES CREDITS

In the 21st century people are drowning in AGWindowView: (c) Agens AS agens.no information. Email, instant messaging, news cCSVParse: (c) Michael Stapelberg and feeds, and of course the web. A small group contributors. michael.stapelberg.de of developers has taken up the fight: us. DTRichTextEditor: (c) Oliver Drobnik github.com/Cocoanetics/DTRichTextEditor FMDB: (c) Flying Meat Inc. github.com/ ccgus/fmdb freepik.com: Icons used under the Creative Commons BY 3.0 license from freepik.com. GHMarkdownParser: (c) Oliver Letterer github.com/OliverLetterer/ GHMarkdownParser icons8.com: Icons used under the Creative We are developing apps based on our unique Commons Attribution-NoDerivs 3.0 artificial intelligence technology that tame Unported license from icons8.com. the beast. We all are Mac users by heart and KissXML: (c) Robbie Hanson github.com/ are writing solely on the Mac and for macOS robbiehanson/KissXML and iOS. MDSpreadView: (c) Mochi Development, Inc. mochidevelopment.com Visit our website to learn more about us and PSPDFKit: (c) PSPDFKit GmbH our products. pspdfkit.com ZipZap: (c) Pixelglow Software github.com/ pixelglow/ZipZap

DEVONthink To Go 2.7.9 Documentation, page 11 MANAGE YOUR DATABASES

IN THIS CHAPTER Trash groups are counted. For smart groups other than Tags and Trash all items are Create new items 12 counted. Tap the item count or swipe to the Sync 12 right to open the database or smart group in Get help 13 grid view on iPad. Customize the settings 13 Background activity: If there's background The databases screen is the first screen you activity DEVONthink To Go shows a progress see when you open DEVONthink To Go or bar above the bottom toolbar of the when you travel the navigation hierarchy database and all item lists. Additional completely back to the top level. information is added at the end of the lists On the databases screen you'll find: switching through all background activities and showing their individual progress. The global inbox database Smart groups Search: Pull down to reveal a search field, All databases you have created or similar to the search field in item lists. synchronized to the device

Databases: The Global Inbox is a standard CREATE NEW ITEMS database that you cannot delete. When Tap the New toolbar icon to create a new you create a new item from the databases item. screen or a smart group it is placed by default into the global inbox. You can also swipe First choose what kind of item to create (new databases to delete them. The global inbox database, new tag, new document, etc.). The can never be deleted but you can clear it. New Document Assistant asks you for all necessary information. Smart groups: The smart groups are predefined. Show, hide, and rearrange them New databases appear on the databases in edit mode. To customize the smart groups screen, new groups, tags, or documents are or delete databases, tap Edit. To add groups created in the global inbox. to the Favorites smart group select the group in the item list in edit mode and mark it as SYNC favorite using the Organize tool. Tap the Sync toolbar icon to synchronize Item counts: The numbers behind databases all databases with all available sync locations indicate how many items are in the activated for the database. Alternatively pull database's inbox. For the global inbox all down the list until the gear starts spinning. items minus the contents of the Tags and When the sync is ongoing the sync progress

DEVONthink To Go 2.7.9 Documentation, page 12 is shown in the cloud toolbar icon as well GET HELP as in the global progress display at the end Tap the Help toolbar icon to show of the database and all item lists. Long- this build in documentation, read the press the icon to show a sheet with more release notes, or write an email to the detailed information about sync progress. DEVONtechnologies support team. The status sheet only appears during longer sync runs. In addition you can find information here about how much real disk space your If there are local, unsynced changes in any databases use on your device and when database the icon shows a dot . And if DEVONthink To Go was last launched. The the log contains sync-related messages, the screen also lists some information about the button changes to and opens the log on last synchronization. tap.

To learn how to set up sync, visit the Sync CUSTOMIZE THE SETTINGS chapter. Tap the Settings toolbar icon to customize DEVONthink To Go to your needs.

See also p. 33ff

DEVONthink To Go 2.7.9 Documentation, page 13 MANAGE YOUR ITEMS

IN THIS CHAPTER Tags: Contains all tags created in a database. Use it to e.g. see all documents that have a Top-level groups 14 tag assigned. Customize the view 14 Search 15 Trash: Keeps all trashed items. Use its Empty Get more information about an item 15 Trash button in the bottom toolbar to Create new items 16 physically delete trashed items. Organize your documents 16 Note: The Trash is only visible when the Share items 17 Trash smart group on the database screen Use the grid view 17 is not switched on. Inside databases you organize your documents using groups and tags. Groups CUSTOMIZE THE VIEW contain documents or other groups, just like folders do on a Mac or PC. Tap the View Options toolbar icon to change the way DEVONthink To Go shows Navigate groups and documents just like you this group's content. would in any iOS app. On devices featuring 3D Touch you can also use peek-and-pop. Sorting: Sort the items by name, type, Long-tap the Back navigation bar item to date created/modified/accessed, or size; immediately return to the home screen. Tap a ascending or descending. document again to deselect it. Only flagged items: Show only flagged items. Tap the Sync toolbar button to synchronize Only labeled items: Show only items with a the database with all available locations. label. Alternatively pull down the list until the gear Show details: Show or hide additional starts spinning. The Sync button acts similar details in the list. to its counterpart in the databases list. Show hidden items: Show or hide special groups like the trash or the legacy Mobile TOP-LEVEL GROUPS Sync group. The trash will not be hidden if the global smart group Trash is hidden too. Inbox: Use the Inbox to store items that you don't want to properly file right away. Or Tap the sorting date button again to rotate items that you need to deal with before filing through the available options: Created, them. Modified, and Accessed.

DEVONthink To Go 2.7.9 Documentation, page 14 View options are set per group. Children Alternatively or to show information about groups inherit their parent's view options multiple items, visit the containing group and unless you set them expicitly. in the list tap Edit to switch to edit mode. Select one or more documents, then tap the SEARCH button in the list's toolbar.

Pull down the item list to reveal the search Note: For multiple items not all options are field just like you'd do in other iOS apps. available.

Enter your search term and choose where RENAME THE ITEM you want to search: in all databases, only in the current database, or only in the current To change the item's name, simply tap it and group. Tap the Help icon to show the help edit it. page for the search language. EDIT OR OPEN THE ITEM'S URL While typing, the last entered word is internally treated like a partial word and Documents in DEVONthink To Go have extended with a wildcard. Press Return to URL metadata. A URL, "uniform resource finish entering the search term and find the locator", is usually a web link that starts with last entered word as-is. "http:" but can also point to something else, e.g. a task in OmniFocus or a document in While a search is in course a progress bar DEVONthink To Go. appears below the search field. The results are sorted by rank and show their ranking Bookmarks use the URL to store their score as "pie charts" as their icon. destination; for other documents you can use it freely. Save e.g. the address of a webpage with more information or reference just GET MORE INFORMATION about anything that has a URL. ABOUT AN ITEM To edit the item's URL tap inside the URL OPEN THE INFO PANEL field and edit it. To open the URL tap the button. To get information about a group, show its content and use the Info button in the CHANGE THE COMMENTS list's toolbar. To change the item's comments, simply tap it To get information about a document either and edit it. The Comments field is searchable. show the document and use the button in Use it any way you like. the document's toolbar.

CHANGE TAGS, LABEL, FLAG

Assign or remove tags from the documents in the Info panel or change other metadata.

DEVONthink To Go 2.7.9 Documentation, page 15 Tags: Tap to expand the tags field if First choose what kind of item to create (new necessary. Tap into the tags field to add or tag, new group, new document, etc.). The delete tags. Tags are shown as blue bubbles. New Document Assistant asks you for all While you're typing DEVONthink To Go necessary information. suggests already existing tags to you. For New tags are created in the database's multiple items you can only remove tags that Tags group. New groups and documents are were assigned to all items. created in the current location. Label: Tap the button to open the label chooser. Tap again to set the label. ORGANIZE YOUR DOCUMENTS

Flag and Unread: Tap to mark the MOVE, REPLICATE, GROUP, ... documents as flagged or unflagged. Tap to mark the documents as as read or unread. Tap Edit to switch to edit mode. And tap to lock or unlock items to keep Select the items you want to act on. them from being accidentally deleted. Tap the Organize toolbar icon. Choose the desired action. CHANGE DOWNLOAD FILES OPTION If required choose the destination. Tap Move, Replicate, etc. to confirm. If you are not downloading files for a whole sync location you can make sure that Move, ...: Moving places the items into selected groups and the items they contain another group or database. Replicating makes will be downloaded regardless of the sync the item available in both the current group location's setting. Choose Always to keep the and the destination group at the same time. group content's files downloaded at any time Duplicating physically copies the items to the or On demand to download them on demand. destination group. Tap the selected option again to unselect Group: Grouping creates a new group and it; the group will use the setting from its places all selected items into it; ungrouping enclosing group. (only available if you selected exactly one Note: This setting is either explicitly set group) resolves a group and places all for a group or, when not set, the encosing contained items into the current group. group's setting is used. In this case none of Convert: Converts documents to other file the two options is selected. formats.

CREATE NEW ITEMS Add to/Remove from Favorites: Adds the group to the local favorites or removes it Tap the New toolbar icon to create a new from them. You access your favorites through item. the Favorites smart group on the databases screen.

DEVONthink To Go 2.7.9 Documentation, page 16 Download/Purge: Downloads the files of Tap Edit to switch to edit mode. selected documents or all items contained Select one or more items you want to act in a group to your device. Documents are on. downloaded individually, downloading groups Tap the Share toolbar icon. downloads all documents contained in the Choose the desired action. group and all its sub-groups. Purge item Note: Not all actions are available for all contents to free space on your device. You document types and not all actions are can re-download the items again on demand. available for multiple items. Some options Not available if the containing group is set to might require another application being download contents automatically. See also p. installed, e.g. OmniFocus. 28ff

Trash: Trashing moves the items into the USE THE GRID VIEW database's Trash. In the item or database list, tap the number

SWIPE ACTIONS in the bubble next to its name to show its content in a grid view instead of simply You can swipe items to the left or right navigating into it. The grid is shown in the to reveal shortcut actions. Move items to detail view. You can also swipe right over the the trash or mark them as flagged, read, item to show its content in grid view. or unread. The More actions gives you all the organize options for the item without Items are shown with a large preview if switching to edit mode first. possible.

COPY A URL FOR AN ITEM TO THE DRAG AND DROP CLIPBOARD Tap and hold an item until it starts hovering.

Long-tap an item to show a contextual menu Then move it with your finger. with less often used options. Copy a URL for Onto another group: Drag the item onto the item (a.k.a. "Item Link") to the clipboard a group in the list view to move it to the to link to it from other documents or even group. apps; this also works for databases. For PDFs Into the list view: Drag the item into the you'll also see the option to copy a "page link" empty parts of the list view to move it to which includes a reference to the currently the group whose content is shown in the displayed page. list view. Onto another item: Drag the item onto SHARE ITEMS another item to group the two. If the other item is a group, the dragged item is moved You can share documents with other apps, into it; if the other item is a document, add a task for it to OmniFocus, etc. both are placed into a newly created group.

DEVONthink To Go 2.7.9 Documentation, page 17 Drag with two fingers to copy the item instead of moving it.

DEVONthink To Go 2.7.9 Documentation, page 18 VIEW AND EDIT YOUR DOCUMENTS

IN THIS CHAPTER Reload the document. Add as new document. Common options 19 Search text within the document. Plain text and Markdown 19 Show the info panel. Rich text and formatted notes 20 Share the document. Images 20

PDFs 20 For documents that are editable, tap the Edit Bookmarks and HTML 21 button in the toolbar (iPad) or navigation bar Sheets 21 (iPhone) to edit. Tap Done to end editing. Movies and audio files 21 Other 21 PLAIN TEXT AND MARKDOWN You can view many documents types from You can view and edit plain text and within DEVONthink To Go. And quite a few Markdown documents. you can also edit directly inside the app. In addition you can share documents via the Markdown: Markdown documents are standard iOS sharing mechanisms or create plain text documents. Using simple-to-use new OmniFocus tasks. formatting rules Markdown documents can be both easily read as they are or graphically Tap any document in the group list to view it. rendered like a web page. DEVONthink To iPad or iPhone 6 Plus or larger: In landscape Go shows Markdown documents properly mode, the document is shown in its own rendered when not in edit mode. pane on the right-hand side of the screen, You can reference images and link to items similar to many other apps. Tap the icon to from Markdown documents using either expand the detail view to full screen. Tap the item links, downward-relative, or absolute to show the item list again. paths (starting with a forward slash). See the

If the document's file is not yet downloaded appendix for more information about item from the sync store, you are presented with links and local paths. a thumbnail, if available, and the option to Markdown metadata: One of the features of download the document. MultiMarkdown is metadata headers. These allow you to add non-displaying information COMMON OPTIONS about the document, like authors, dates, and even linked stylesheets. To use the feature, Depending on the document type one or format the first line of the document with a more of the following toolbar options are colon, e.g., Author: DEVONtechnologies. This available for documents:

DEVONthink To Go 2.7.9 Documentation, page 19 must be the first line of the document. Other Change the current paragraph metadata fields you wish to add must follow alignment. immediately after this first line. Insert an image.

However, if you would like the first line of your You can also freely choose a font and size document to contain a colon, perhaps adding using the Font and Font size options in the notes like Developer: A. Edwards and Re: secondary toolbar. On the iPhone only a OCR, just add a single blank line at the top of limited feature set is available. the document and the subsequent lines will be treated as normal paragraphs. EDITING MENU

RICH TEXT AND FORMATTED NOTES Select text to make the editing menu appear. You can view and edit rich text documents Use it to: (RTF and RTFD) and formatted notes. Cut, copy, and paste text. RTF and RTFD: Rich text documents use Show a dictionary definition. the proprietary RTF format with good but Make the text bold, italic, … not 100% compatibility to e.g. DEVONthink Add a link. for Mac. DEVONthink To Go also supports rich text documents with attached images (RTFD) but as read-only. IMAGES

You can view and edit images. Formatted notes: Based on HTML, formatted notes are 100% compatible to DEVONthink Pinch to zoom in and out. for Mac and can also displayed using any web In edit mode rotate the image counter- browser on any platform. Images that you clockwise or apply a predefined filter. add are embedded. Formatted notes are fully self-contained. PDFS FORMATTING TOOLBAR You can view PDFs, search them, and add and In edit mode use the formatting toolbar to edit annotations. format your text: Scroll up and to down to navigate the Apply a predefined format, e.g. document. Pinch to zoom in and out. Tap "headline". the Thumbnails button to show page Make the selected text bold. thumbnails and the Outline button to show Make the selected text italic. the PDF's table of content if available. Tap Make the selected text underlined. the magnifying glass icon to search inside Strike the selected text through. the PDF document.

DEVONthink To Go 2.7.9 Documentation, page 20 ANNOTATING Tap the web page name in the tool bar to toggle between the page's name and its In edit mode use the annotation bar to add address. A star indicates that the shown or edit annotations. Place the bar left, right, web page does not represent a document but or over the toolbar by dragging it with the was loaded temporary from the internet. move bars. Hide the annotation bar by ending edit mode or tapping the close icon. You can reference images and link to items from HTML documents using either item You can also modify already existing links, downward-relative, or absolute paths annotations without switching to edit mode. (starting with a forward slash). See the The changes will be automatically saved. appendix for more information about item

Use the annotation tools to add, edit, or links and local paths. delete annotations. SHEETS

You can view and edit sheets (CSV/TSV Use and to undo or redo your changes. tables).

To edit cells switch to edit mode, then EDITING PAGES double-tap cells to modify their content. Use the PDF editor icon to switch to PDF Rearrange columns by dragging their heading page edit mode. and use the floating tools to add or remove rows or columns. Then use the PDF editor toolbar to add empty pages, delete, duplicate or rotate Note: Creating and editing sheets requires pages. Move pages by dragging them to their an in-app purchase. new position inside the document. MOVIES AND AUDIO FILES

You can play movies and listen to audio files.

Use and to undo or redo your changes. DEVONthink To Go offers the standard media player controls, audio will continue to play Note: Annotating and editing PDFs requires when you switch to another app. an in-app purchase.

OTHER BOOKMARKS AND HTML You can only view other documents such You can only view bookmarks and HTML as email messages or files unknown to documents. DEVONthink To Go.

Tap links to follow them. Tap the caret to navigate back. Long-tap page elements to show additional options.

DEVONthink To Go 2.7.9 Documentation, page 21 SHARE OR CLIP DATA

IN THIS CHAPTER

Use the Files app 22 Use drag-and-drop 23 Capture data 23 Scan paper documents 23 Create notes and search with Siri 24 Share data 24 Share documents 25 Use iTunes to batch-import documents 25 The Files app and its mechanisms replace the document provider extension on iOS 11. DEVONthink To Go is not an island. Open DEVONthink To Go adds itself as a 'remote documents in your database from other file system' to Files, just like Dropbox or apps or save data directly to DEVONthink iCloud. You can open documents, drag them To Go using the document provider feature. to other apps if your device supports it, copy Clip data from other applications using the them to other file services, or annotate PDFs Clip to DEVONthink share extension. Finally, using the built-in tools supplied by Files. the Share menu lets you send documents to other apps, print them to any AirPrint- Groups set as favorites in Files appear in enabled printer, or add them as task to the Favorites smart group in DEVONthink OmniFocus. To Go. Tags set for items in Files are added as tags in DEVONthink To Go. USE THE FILES APP Items not downloaded can't be On iOS 11 and later you can access your manipulated in Files. databases also from the Files app as well as Smart groups synchronized from the Mac from other apps that can open or import files work neither in DEVONthink To Go nor in from Files. Files.

Note: Files tries to be as nice as possible to the remote service and uses a lot of caching. Therefore you might notice some delays when navigating your databases. Also, databases and groups are shown as 'folders' because that is what Files understands. And finally, in DEVONthink To Go items can be present in multiple groups

DEVONthink To Go 2.7.9 Documentation, page 22 (replication); Files doesn't support this. DEVONthink To Go always presents items in their 'primary parent' in Files.

USE DRAG-AND-DROP

On iOS 11 and later you can drag items from the item list as well as from the grid view to other places inside DEVONthink To Go and to other apps that accept the dragged data. You can also drop files from e.g. the Files app or data like text or web addresses into DEVONthink To Go.

When you've finished editing, tap the icon and choose the target format. You can e.g. save web pages as web pages or Markdown. You can also choose to clean up the page using Instapaper or Readability. Note: Groups are spring-loaded, i.e. that when you drag items over a group it blinks SCAN PAPER DOCUMENTS a few times, then it opens. To drag items into a group first let DEVONthink To Go DEVONthink To Go doesn't offer paper open the group for you, then drop the item capture itself but is directly supported inside of it. by Readdle Scanner Pro. Send scans to DEVONthink To Go's global inbox from Scanner Pro's share sheet. If you want CAPTURE DATA to adjust the document's title, choose a In any application that supports the iOS different database, or add tags, tap Open In share sheet, tap the Share toolbar icon and in Scanner Pro's share sheet instead and use choose Clip to DEVONthink. The extension Clip to DEVONthink. uses whatever data the host app provides Note: Sending scans to DEVONthink To Go and fills in the title and content fields. is supported by Scanner Pro 7.1.3 or later. Choose the database where you want to file it, add tags, flag it, or mark it as unread.

DEVONthink To Go 2.7.9 Documentation, page 23 CREATE NOTES AND SEARCH WITH SIRI

On iOS 11 and later you can use Siri to:

Create new plain text notes Search for documents

To find out how to ask Siri to perform these tasks check out Siri's own help which lists sample phrases for DEVONthink To Go.

SHARE DATA

To share a document, tap the Share toolbar icon to show the standard iOS share sheet with many possible actions.

Note: Apple's way for sharing data (like AirDrop: The top part of the sheet lets you text or images) looks similar to sharing send data to other devices via AirDrop. E.g. documents (like PDFs files) but differs for bookmarks it sends the URL. a lot internally. When you use the Share

toolbar icon DEVONthink To Go first Share extensions: The first row of icons lets presents you with the share sheet for data. you send data to the share extensions of Choose Open In to show the share sheet other apps. DEVONthink To Go shares as for documents. much data as possible but it's completely up to the share extension how to proceed with it.

Activities: The second row of icons represent activities that act directly on the document. You can, e.g., print it or copy its item link. Choose Open In to share the document file itself.

Open in: Shows the iOS document share sheet offering available third-party apps for the document type. Attention: It looks almost the same as the share sheet for data (only the available options differ)! Print: Prints the document to AirPrint- enabled printers. Capture: Captures the displayed web page.

DEVONthink To Go 2.7.9 Documentation, page 24 Copy Item Link: Copies a URL for the document that you can use to link to the document from other apps. For PDF documents it links to the currently displayed page. Copy URL: Copies the URL from the document's info panel. Open URL: Opens the URL from the document's info panel in the default browser. Add to OmniFocus: Creates a new task linked to the document in OmniFocus. Fill using 1Password: Let's you fill in user names and passwords from 1Password.

Note: You can customize which share AirDrop: The top part of the sheet lets you extensions and activities are listed here. send files to other devices via AirDrop. So if you're missing Clip to DEVONthink

or another app or would like to hide a Share extensions: The first row of icons rarely used activity, tap More in the row in lets you send data to the share extensions question. Note that not all apps accept all of other apps. DEVONthink To Go adds a types of data. four-digit number to the file name that lets it identify it should you use the same SHARE DOCUMENTS mechanism to send it back from the third- party app. To share complete documents first open the share sheet for data by tapping the Share Activities: The second row of icons represent toolbar icon. Then choose Open In in the system-wide activities such as saving to second row. Use the document share sheet iCloud Drive or opening the Quick Look panel. for sending files to other apps or, e.g., save them to iCloud Drive or Dropbox. USE ITUNES TO BATCH-IMPORT DOCUMENTS

If you have a larger number of documents to import from a Mac, synchronizing is the way to go. However, if you don't use DEVONthink on the Mac (but you should, really) or your desktop computer is a Windows PC then there's another way to batch-import files:

DEVONthink To Go 2.7.9 Documentation, page 25 Connect your iOS device via USB to your DEVONthink To Go will import everything Mac or PC. that is not one of the default items Open iTunes. ("DB5.plist", "Console.log", and "Inbox") Navigate to your device's area, then to File into the global inbox database. The "Inbox" Sharing > DEVONthink. folder is used for communication with the Drag all files you want to import into extensions and can't be used by you. DEVONthink Documents. Bring DEVONthink To Go on your device to the foreground.

DEVONthink To Go 2.7.9 Documentation, page 26 SYNC YOUR DATABASES

IN THIS CHAPTER Direct connections:

Quick start 27 Switch on Bonjour on one side (leave port Scenarios 27 number blank to let DEVONthink To Go Synchronizing everything or just the choose for you). metadata 28 Create a direct connection to it from the Setting up sync 29 other side. Adjust your options. Setting up Bonjour 30 Switch on the databases you want to up- Troubleshooting 31 or download and let it sync.

DEVONthink To Go allows you to synchronize WebDAV or Dropbox: your databases over the internet or on the Create a sync location for the service of local network with Macs running DEVONthink choice on one side. Choose a sync store for Mac and iOS devices running DEVONthink name and a password, adjust your options. To Go. Let it upload your data to the location. Create the very same sync location on the QUICK START other side. Enter the same sync store name

While the whole sync setup can grow complex and password. if needed, the basic workflow is very simple. Switch on the databases you want to up- or download and let it sync. iCloud: Please find a short glossary about sync- Add the iCloud sync location. related terminology in the Appendix. Enter an encryption key; if you already synced to iCloud from another device enter SCENARIOS the same encryption key that you've used there. iCloud: If you want to keep your databases in Switch on the databases you want to up- sync but not share them with others this is a or download and let it sync. great choice. It's tied to your iCloud account so you don't have to set anything up except for the encryption key. But, that also means you'll only be able to use it from other devices set up for the same Apple ID. We strongly recommend an iCloud plan with enough storage.

DEVONthink To Go 2.7.9 Documentation, page 27 Local network: If you only want to themselves. The documents show as 'pending' synchronize your databases while both this as long as their content has not been device and your Mac are on the same network downloaded to the device. consider using a direct connection. Download files: Always: Both metadata This is much faster than uploading all and content files are synchronized to the data to some server on the internet and device. downloading it again on another device. But, Download files: On demand: Only metadata when you leave your office and you haven't is synchronized to the device; content files synchronized your databases, you'll need to are downloaded on demand. wait until you come back another day. COMPARISON WebDAV: If you run your own WebDAV server, your ISP offers it as a service, or your Both modes have their own advantages and have subscribed to an online service such as disadvantages. When you choose Download CloudMe or box.com, this might be for you. Files: Always, you have everything with you offline, metadata and contents, even when Your data is stored in encrypted sync stores you are without an internet or intranet on the server. You can keep all your devices in connection. You are independent of network sync at any time as long as you have internet availability. access. When you choose Download Files: On Dropbox: If you have a Dropbox account demand, the data stored on your device is you can use it just like you'd use WebDAV. significantly less and you can carry larger DEVONthink To Go creates a private folder databases with you even on a device with for its sync stores and so keeps its data small memory. separate from your photos and other documents. Of course it does not get access You can work with your documents, browse, to anything except its own files. Dropbox and rearrange, or even trash them. Accessing DEVONtechnologies respect your privacy. documents is slower, however, as they need to be downloaded on demand. Also, when you SYNCHRONIZING EVERYTHING are without a network connection you cannot OR JUST THE METADATA view documents you have not downloaded before you reached the network-free zone. As disk space especially on iOS devices is limited, DEVONthink To Go offers two GRANULARITY synchronization modes to let you hand-tailor its sync behavior to your needs. DEVONthink DEVONthink To Go lets you fine-tune which To Go either downloads everything to your content files are synchronized to your device device or it just downloads the information on multiple levels: about your documents but not the files

DEVONthink To Go 2.7.9 Documentation, page 28 Sync location: Open the sync settings, tap Automatically: Alternatively you can let Edit, and choose the sync location that DEVONthink To Go choose the documents you'd like to edit. you haven't used recently, and purge them for Database: Navigate to the top level of the you. Choose how many files should have their database, then tap the button to open contents kept on the device in the Settings. the Info sheet. Automatic purging keeps track when Group: Navigate to the group, then tap the documents have been downloaded or button to open the Info sheet. accessed so that it only removes the On each of these levels you can decide with least used contents. It also does not the Download files option if you want to purge documents that have not yet been download the contents of files for offline use. synchronized to some other location, that You can easily choose to not download files are protected by their enclosing group, or for a sync location but set a group to always that have been downloaded in the past hour. download its contents. Setting the location Documents only synchronizing with a direct to download contents overrides decisions on connection are also never automatically the database or group level; in this case the purged. respective user interface controls in the Info for the group or database is inactive. SETTING UP SYNC

Note: By default sync locations do not To set up DEVONthink To Go for download files automatically but let you synchronization open the Settings by tapping choose this on the database and group the button on DEVONthink To Go's first level. This is the recommended setting screen. unless you explicitly want to download all files from a specific location. Technically, databases are synchronized either directly between devices (direct

PURGING connections, a.k.a. Bonjour) or via sync stores. Sync stores are folders residing on Purging removes only the data file of a servers such as iCloud, Dropbox, or your document. You still see a purged document own WebDAV server; Macs can also use file listed, it's searchable, and you can manipulate servers on the local network. DEVONthink it. Purging does not delete the document To Go keeps all information about which itself, it just turns it into a 'ghost'. databases to sync through what kind of connection and with which sync store in a so- Manually: You can at any time remove called sync location. contents to free disk space. Select items in the items list and choose Purge in the The basic workflow for preparing DEVONthink Organize menu. To Go for synchronization looks like this:

DEVONthink To Go 2.7.9 Documentation, page 29 In the Settings tap Edit locations. Direct connections: When you set up a direct Add a sync location for the connection you connection, DEVONthink To Go will ask you want to use. for the pairing password that you have set in Fill in the necessary credentials. If you have DEVONhtink for Mac in Preferences > Sync 1Password installed you can use it here. Not > Bonjour Options. You can also make your necessary for iCloud. iOS device the server for incoming direct Name the sync store. If you have already connections by setting up Bonjour. created a sync store from another device, Dropbox: DEVONthink To Go asks the e.g. your Mac, enter its name here. Not Dropbox app, if installed, for authorization or necessary for iCloud. shows you the Dropbox authorization page. Enter an encryption key (highly It can only use one Dropbox account at a recommended). When entered time and will re-connect to this account even DEVONthink To Go will encrypt all data when you remove the Dropbox location and using AES 256 bit. re-add it. To unlink DEVONthink To Go from a Tap Save to set up the location. Dropbox account, visit your Dropbox account Visit the location and switch on all settings and remove your device and/or the databases you want to keep in sync using "DEVONcloudy" app. Now you can add a new this location. Note: You must wait for one Dropbox location and authorize with the database to fully sync before selecting the account you want to use. next database. Box: Box does not support single sign-on To synchronize databases on two devices set when using WebDAV. Create an external up similar sync locations using the same sync password to use DEVONthink To Go with Box. store name and encryption key. To edit a location later, tap Edit to switch the Note: If you enter a different sync store locations list into edit mode, then tap the name on each of your devices every device already set up location to open the location will create it's own sync store. You need editor. to enter the EXACT SAME NAME for the sync store on all devices that you want to keep synchronized. Using multiple sync SETTING UP BONJOUR stores is especially useful if you use also You can not only build a direct connection multiple encryption keys, e.g. for business from your iOS device to a Mac but also set and private, for friends and colleagues, etc. up your device as a server. Then you connect iCloud: Synchronization via iCloud is tied to from another iOS device or a Mac on the local the iCloud account set up for the device so network to pull databases or get changes. there's nothing to be set up except for the To adjust the settings tap the Set options sync store encryption key. button in the Settings and switch the server on. Leave the Port field empty to let DEVONthink To Go choose a port for you,

DEVONthink To Go 2.7.9 Documentation, page 30 unless you have a known open port you'd WEBDAV OR DROPBOX like to assign. Set a password to prevent For WebDAV or Dropbox locations, check the unauthorized access to your device. following: Note: Important: DON'T enter the SAME Check if the service you're trying to port number on multiple devices, e.g. connect to is reachable. Mac and iOS device; if you need to run Check that your service uses HTTPS. the Bonjour server on both devices use Unencrypted HTTP is not longer supported different port numbers. You don't have by iOS. to enter the same IP port on all devices; Check that you have entered your user the best practice is to leave it up to the credentials correctly. app to choose a port. Other instances of Check that you are connected to the right DEVONthink To Go or DEVONthink for WebDAV or Dropbox account. Mac can only access your device as long as Check that you use the same sync store DEVONthink To Go is the active application name and encryption key. and the device is unlocked. In some circumstances, our support people TROUBLESHOOTING may tell you to verify or clean the sync location or database. The synchronization was designed to run in self-maintenance mode so there should Locations: Visit Settings > Locations: Edit be little for you to do to make it work. If, locations, then left swipe on the sync however, it does not work as expected, please location. try the following steps before contacting our Databases: Visit Settings > Locations: Edit user support: locations, select the sync location then, left swipe on the database. Check your network connections. Restart this device. The swipe actions let you verify locations and databases either quickly or thoroughly, or

ICLOUD clean them. Cleaning removes the content of the sync location or database in the sync For iCloud sync check the following: store. It does not, of course, delete the

Check if iCloud is correctly set up for your database from this or other devices. device in the device's Settings. Check that you have entered the DIRECT CONNECTIONS encryption key correctly. For direct connections also check the Check that your device has a working following: internet connection. Restart the other Mac or iOS device. Restart your router.

DEVONthink To Go 2.7.9 Documentation, page 31 Check if this device is connected to the Check that you have entered the same same WiFi network as the other side. password that you have set in the other Check if both devices are on the same side's Bonjour options. subnet. Check if the firewall or Little Snitch Check if there are any routers or switches enables incoming connections to involved. The more switches and routers DEVONthink. the less reliable the connection due to Check if DEVONthink is running on the port filtering, conflicts, or other unknown other Mac or iOS device. factors. Check if the databases you want to Check the port number on the server side. synchronize are open on your Mac. To open Best practise is to leave the field empty them automatically, visit Preferences > and let DEVONthink To Go choose the port Sync in DEVONthink on the Mac, click number for you. If you activated serving Bonjour Options and activate the option Bonjour on more than one device every Open databases automatically. device MUST use a different port number. Note: If your router offers multiple See also p. 30ff networks, e.g. a slower and a faster one, Check that the port number used on the make sure both devices use the same server side isn't blocked by your firewall or network. Restarting any device could make your router's security. them connect to a different network.

DEVONthink To Go 2.7.9 Documentation, page 32 CUSTOMIZE THE APP SETTINGS

IN THIS CHAPTER already authenticated with your device in the last 30 seconds DEVONthink To Go will not Premium features 33 ask you to reauthenticate. Security 33 Sync settings 33 Again after: Set a time period in which Group settings 35 DEVONthink To Go will stay unlocked when Document settings 35 you put it into the background, e.g., for Integration settings 35 working with another app. Backup settings 35 Note: When DEVONthink To Go is locked Log 35 no documents will be available through Adjust all of DEVONthink To Go's settings the Files app or the document provider directly inside the app without visiting the extension too. To access your documents Settings app. Tap on DEVONthink To Go's externally set a unlock time or disable the first screen to show the settings. passcode protection.

PREMIUM FEATURES SYNC SETTINGS

Tap Manage to see and purchase premium Locations: Tap Edit locations to manage your options to extend DEVONthink To Go's sync locations. An activity indicator next feature set. to the button shows that DEVONthink To Go is currently synchronizing. Activate or SECURITY deactivate any location to keep it from being used for synchronization, e.g., when you're in Protect your data from prying eyes with a an environment where synchronizing is not passcode and, if your device supports it, advisable. Touch ID or Face ID. Tap Edit to set up synchronization with Use passcode: Switch this on to enable iCloud, a WebDAV server, Dropbox, or directly passcode protection. This is the main switch with a Mac running DEVONthink. for all security. Bonjour: Tap Set options to switch on Use Touch/Face ID: When switched and configure the built-in Bonjour server on DEVONthink To Go will first try to that allows you to connect to your device authenticate with Touch ID or Face ID. Should from other iOS devices or Macs running this fail it will ask for the passcode. When DEVONthink To Go or DEVONthink for Mac. this option is switched on and you have

DEVONthink To Go 2.7.9 Documentation, page 33 Conflicts: Choose whether, in the case of Manage locations: Tap Edit to add a new a sync conflict, the newest change wins or location or edit or delete an existing location: DEVONthink To Go keeps both versions. Tap to add a new location. Schedule: Choose if DEVONthink To Go Tap to remove an already added should synchronize automatically or just on location. demand. Pull down in any database or item Tap an existing location in edit mode to list to start the synchronization at any time. modify its settings. DEVONthink To Go will also sync when you Manage databases: Tap an existing location switch away from it to another app if you to get a list of all local and remote databases. choose to synchronize automatically. Switch on all databases that you want to get If you choose to synchronize automatically synchronized with the location. iOS will also wake up DEVONthink To Go Remote databases that you switch on are from time to time and let it sync. As the downloaded from the location to your device. time for the background refresh is limited If you delete a database from your device but to 30 seconds only one database will be it still exists in the location it will appear as synchronized at a time. You can check when "remote" and "switched off" again. the last background refresh happened in the

Help screen. Locations that are unavailable for some reason appear disabled. Busy locations, e.g. Keep ...: If you don't download files ones that are currently synchronizing, show automatically, choose whether you want an activity indicator. DEVONthink To Go to automatically purge contents and keep only the most recently SETTING UP A SYNC LOCATION downloaded or used ones. This does not delete the document but only the underlying When setting up a new location enter the content file. Unsynced documents or required details, e.g. WebDAV address, user documents in databases synchronizing not name, and password. For server locations to web-service based locations like iCloud, you also need to enter a sync store name as Dropbox, or WebDAV will never be purged. multiple sync stores can exist in a location. To connect to a known sync store, enter its SYNC LOCATIONS name. Enter the encryption key if the sync store is encrypted. Sync locations are used to keep your databases on all your devices in sync. Sync All locations also offer the following options: locations can be a physical location such as iCloud, Dropbox, or a WebDAV server, or a Label names and colors: Syncs label direct connection to a Mac or mobile device, names and colors from this location. Label running DEVONthink or DEVONthink To Go respectively, on the local network.

DEVONthink To Go 2.7.9 Documentation, page 34 names and colors can only be set using Automatically capitalize words where DEVONthink for Mac. approproate. Download files: If this is switched on, Correct spelling automatically. synchronizing with the location downloads Make e.g. detected dates or addresses not only the metadata but also the actual actionable. files. Switch this off to keep your database lean and load documents from e.g. iCloud INTEGRATION SETTINGS or a WebDAV or Dropbox location on demand. See also p. 28ff TextExpander Snippets: Tap Update to Reading positions: If this is switched on, update the TextExpander snippets if reading positions are synchronized through necessary. this sync location. Switch this off to not propagate or retrieve reading positions BACKUP SETTINGS from this location. Backup data to iCloud: Enable or disable the Verify uploaded items: Additionally verify iOS backup of your databases. Databases all uploaded items. Takes longer but is more are stored outside of the regular application safe. container to make them accessible to the Files app. Unfortunately iOS doesn't count GROUP SETTINGS them as part of the app's data size and

Keep on top when sorting: Enable this option doesn't allow you to disable backing them up to keep groups always on top in item lists. from the system-wide settings. Visit the Help menu to check the real size your databases use on your device. DOCUMENT SETTINGS If there are any warnings or errors, Documents: Tell DEVONthink To Go how you DEVONthink To Go shows a icon instead of would like to view your documents: . Choose your preferred text size for plain text documents. LOG Scroll through PDFs horizontally or vertically. DEVONthink To Go presents warnings and View PDFs page-by-page or scroll errors, depending on their urgency, as alert continuously. dialogs or silently adds them to the Log. Let DEVONthink To Go show two pages If there is anything in the log that you need next to each other when there's enough to be aware of, DEVONthink To Go shows an room, or tell it to only show only page at a exclamation mark in the Settings screen's time. title bar and on the first screen.

Editing: Choose how DEVONthink To Go Tap the icon to show the log. Tap Clear to behaves when editing text: clear all entries.

DEVONthink To Go 2.7.9 Documentation, page 35 Note: In case of problems with this the first screen of this Help. The log software do not clear the log and contact is automatically attached for you and the DEVONtechnologies support staff helps the developers find out what has instead. Use the Contact button on happened.

DEVONthink To Go 2.7.9 Documentation, page 36 FREQUENTLY ASKED QUESTIONS

IN THIS CHAPTER Get answers to frequently asked questions about DEVONthink To Go. Security 37 Spotlight 38 Synchronization 38 Contacting us 38

SECURITY

Does DEVONthink To Go encrypt my data? Yes. All data stored on your device is encrypted using iOS' own encryption. Transmitted data is encrypted using DEVONthink To Go's own AES 256 bit encryption (unless you don't enter a password for direct connections or encryption key for sync stores).

How safe is my data on my device? DEVONthink To Go relies on iOS' built-in encryption so all data is always stored encrypted and can only be read when your device is unlocked, e.g. using Touch ID or your passcode.

When you lock your device (switch off the screen) DEVONthink To Go gets about three minutes to complete background tasks, then iOS withdraws access to all its files. Even with physical access to the device it is now impossible to decrypt the data without using the correct fingerprint or passcode (as of July 2016).

Therefore DEVONthink To Go does not implement any additional encryption for storing the data.

How safe is my data during a sync? If you set an encryption key for a sync store all data is AES 256 bit encrypted before leaving the device and is stored encrypted on the server. It can only be retrieved using the correct key. The same is true for direct connections where all data is encrypted using the key set in the Bonjour options.

In addition the username and password you set for newly created databases is used as soon as you sync the database to another device. The database cannot be retrieved from a sync store or via direct connection without entering the right credentials.

DEVONthink To Go 2.7.9 Documentation, page 37 SPOTLIGHT

What data is available in Spotlight? Spotlight receives the name, the first 16 KB of text content, the comment, and the tags for each item as well as metadata like the item's type, its icon, and the creation and modification dates.

Why only 16 KB of text? This seems to be the internal limit of Spotlight (iOS 11).

What if Spotlight shows no results from DEVONthink To Go? Check DEVONthink To Go's settings in the Settings app and make sure that Search & Siri Suggestions is switched on. Then try to search for terms that you know that occur in the document, e.g. in its title. If still no results show up rebuild the Spotlight index.

SYNCHRONIZATION

Do I have do sync whole databases? No. DEVONthink To Go always syncs the metadata for whole databases but you can select for the location, the database, or individual groups if you want to sync their content files too. If you sync only the metadata you can download the actual content later on demand. See also p. 28ff

I have lost my encryption key. Can you recover it? Unfortunately no. The encryption key is is never shared with DEVONtechnologies. And if we could recover your encryption key anyone else could do this too. We're also using strong encryption to ensure your privacy that (at the time of this writing) it can't be cracked without substantial computing power, if at all. You're sure you don't have noted it down on some piece of paper somewhere?

Are multiple Dropbox accounts supported? No. The official Dropbox API only pairs with one account at a time.

Does the sync work with OneDrive, Google Drive, etc.? Not yet. If you would like to use DEVONthink To Go with a service that is not yet supported, let us know. We might add support for it in a future release.

What do I do if I cannot get it to work? First check out our troubleshooting section. If you still cannot get it to sync, contact us.

CONTACTING US

To get in touch with us visit our user forum, check out our support area, or send us traditional email.

How can I provide data for debugging? If our customer support ever asks you for device logs there are two ways to provide them to us:

DEVONthink To Go 2.7.9 Documentation, page 38 Use the Contact us option on the Help dialog sheet. It'll compose an email that you can send to us with all the logs attached that we need. Alternatively you can connect your device via USB to a Mac or PC. Open iTunes, navigate to your iOS device's area, and choose File Sharing > DEVONthink. In the DEVONthink Documents area you'll find the "Console.log" file that you can download to your computer and send to us.

DEVONthink To Go 2.7.9 Documentation, page 39 OTHER PRODUCTS

IN THIS CHAPTER If you have a moment feel free to visit our lively user community. Here users of all skill Overview 40 levels meet to discuss our applications, talk DEVONthink 40 about our technology, and exchange tips and DEVONagent 40 tricks for DEVONthink To Go & Co. DEVONsphere 41 Needful Things 41 DEVONTHINK Besides DEVONthink To Go, Organize and work with all your documents, DEVONtechnologies publishes a number of bookmarks, email messages, text files, other commercial, shareware, and freeware images, PDFs, in one place, regardless where applications and services that might be they originated. Quickly capture data without helpful for you. interrupting your workflow. DEVONthink's unique AI assists you in getting the most out OVERVIEW of your data collection. DEVONtechnologies is focused on developing Learn more about DEVONthink innovative applications for finding, storing, Check your upgrade options if you want to and organizing information. Our main upgrade to a higher edition objective is to make complex yet flexible technology that is both easy to use and lightning fast. All applications are based on DEVONAGENT the DEVONtechnology, a powerful and solid DEVONagent Pro helps you search more core unique to DEVONtechnologies. efficiently on the web. It searches multiple sources, frees you from hunting for the really DEVONthink relevant results, and gives you power tools DEVONagent for your research. DEVONagent Express and DEVONsphere DEVONagent Lite (free) make searching We also publish some freeware apps and the web as easy as using Spotlight. Search services for your everyday work with your Google, Bing, YouTube, Facebook, Twitter, Mac. even the Mac App Store, right from the menu bar. NEWSLETTER & COMMUNITY Learn more about DEVONagent Pro. Would you like us to keep you informed about updates and new product releases? Visit our blog and subscribe to our free newsletter.

DEVONthink To Go 2.7.9 Documentation, page 40 DEVONSPHERE NEEDFUL THINGS

Make your Mac smarter: Let DEVONsphere Search files on your hard disk, watch web Express keep track of related emails, articles cams, create thumbnails, or access all your on the same subject, and similar web pages. files and apps from the menu bar. Reformat Discover the hidden connection between paragraphs in your favorite word processor or seemingly unrelated files. do little calculations anywhere you can type in text. All for free. Learn more about DEVONsphere Express. Learn more about our freeware apps and services.

DEVONthink To Go 2.7.9 Documentation, page 41 APPENDIX

IN THIS CHAPTER Item list: A list of items stored in the database. Items can be documents or Glossary 42 groups. Iconology 44 List view: The left-hand part of the screen Tagging 44 where databases or items are listed. Search operators 45 Organize menu: A menu that lets you move, Item links and paths 47 replicate, trash, etc. documents or groups. URL commands 48 Settings: DEVONthink To Go's preferences. The appendixes give additional information Contrary to other apps, DEVONthink To to help you getting familiar with DEVONthink Go's settings are accessible directly from To Go, e.g. a glossary of commonly used terms its home screen. and a search operator cheat sheet. View options: Settings that define e.g. the sort order per group. GLOSSARY DOCUMENTS & GROUPS Become familiar with these terms to get the Database: The collection of all documents. most out of working with DEVONthink To Go. Document: A file in the database, e.g. a PDF. INTERFACE ELEMENTS Group: A collection of documents or other Share menu: System-provided menu with groups. commands for sharing documents or Global Inbox: The one inbox that collects it opening them in other apps. all. Detail view: The right-hand side part of Inbox: A special group for data coming in to the screen where document contents are a database. shown. Only on iPad or iPhone 6 plus and Replicant: An item that appears in more larger. than one place in the database. Like two Editing menu: The menu that appears phone book entries for the same person. when you select some text when you long- Content: A document's data file, e.g. the tap an group or document. Similar to the actual image. A document synchronized contextual menu on a Mac or PC. from a sync store can be present but have Home screen: The first screen in no content; you can download the file on DEVONthink To Go's hierarchy that lists demand when you need it. databases and smart groups. Sheet: A table of data, like a simple spread sheet.

DEVONthink To Go 2.7.9 Documentation, page 42 Smart group: A "saved search" that appears You can quickly find flagged or unread items like a group. DEVONthink To Go comes by using the Flagged or Unread smart groups with predefined smart groups that you can on the home screen. switch on and off on the home screen. Trash: Stores all trashed items until you SYNCHRONIZATION empty it. Sync location: Sync locations are used to keep your databases on all your devices in TAGS sync. They summarize all information about A tag is a different visual representation which databases to sync through what kind of a group. Technically groups (folders) and of connection (e.g. direct connections to tags are exactly the same; groups are just DEVONthink on a Mac, iCloud, WebDAV, shown as "containing" the item while tags are CloudMe, Dropbox etc.) and with which "attached" to it. DEVONthink To Go treats sync store. both the same. Add a tag to an item and it'll Sync store: Server-based locations, e.g. be added to the Tags group of the database. WebDAV or Dropbox, can contain multiple Open the Info panel and both the groups "sync stores". Technically a sync store is a containing the item and the attached tags folder on the server volume. Use multiple are listed in the Tags field. See also p. 44ff sync stores to e.g. sync both your personal and your business databases at the same Group tag: Tags represented by a regular location but keeping them separate group. nevertheless. Sync stores can be encrypted Ordinary tag: Tags created by adding a tag and each sync store at a location can have to a document. a different encryption key. iCloud sync uses a single, predefined sync store. ITEM PROPERTIES Direct connection: A sync location that Flagged/Unflagged: Items can be checked doesn't store its data on a server but or unchecked for your personal use, e.g., directly connects to a Mac running for creating a to-do list, maintaining a DEVONthink or DEVONthink To Go shopping list, or writing a list of project respectively. When this device is not on tasks. the same WiFi network or DEVONthink/ Locked/Unlocked: Items can be locked DEVONthink To Go is not running the direct to keep them from being unintentionally connection is disabled and listed as offline. deleted (groups, documents) or modified Local database: A database that exists on (documents). this device. Read/Unread: Items can be marked read or Remote database: A database that exists unread, which is useful for documents that at the sync location, e.g. on Dropbox, but is you want to read later. not yet downloaded to this device.

DEVONthink To Go 2.7.9 Documentation, page 43 ICONOLOGY TAGGING

Additional icons below item names show e.g. DEVONthink To Go supports tagging in a way that items are flagged or unread. Icons are that makes groups and tags interchangeable. only shown if Show details is switched on in While this concept may sound a bit strange the group's view options. at first, you will soon discover why it is a smart way to approach tags and group and to Item is labeled; the icon is colored in the bring both together. label's color. Item is flagged. INTRODUCTION Item is unread. Item is locked. Technically, tags and groups are identical: both are simply entries in a table that are The following icons show if items are somehow "attached" to an item, usually a replicated or have been recognized as a group or document. The difference is that duplicate. Replicants are items that are tags are visualized as "labels attached TO the located simultaneously in more than one item" while groups are visualized as "groups group but physically only present once; CONTAINING the item." They are presented duplicates are items that are physically differently, but internally they are the same. present multiple times and have the exact DEVONthink To Go treats groups as tags and same content. tags as groups.

Item is replicated. Example: A document is located in the Item is a duplicate. group "Science > Paleontology > Dinosaurs". Item is both replicated and duplicated. Consequently, its tags are "Science," "Paleontology," and "Dinosaurs." Now you The Sync toolbar button also serves as a create a sub-group of "Dinosaurs" named status indicator. This is what the icon shapes "Land-living" and move the document into indicate: the new folder. Automatically it is now The current or all databases have been tagged with "Science," "Paleontology," synced and no local changes have been "Dinosaurs," and "Land-living." made. When you assign a tag using DEVONthink The current or all databases have To Go's user interface, move a document, changes that need syncing. or replicate it to another group, this is what The current or all databases might have happens: changes that need syncing but the sync

location is still processing incoming data Assign a tag: The item is replicated to the and so doesn't know yet. Tags group. An error occured during the last sync Remove a tag: The item's replicate in the run. Tap to see the error log. Tags group is deleted.

DEVONthink To Go 2.7.9 Documentation, page 44 Adding an item to a group: The group's WORDS, TOKENS, AND QUERIES name and the names of all groups Word: A sequence of letters delimited by containing the group appear as tags white space or a punctuation character. attached to the item. Token: DEVONthink To Go stores its full- Moving an item: The new group's name text index as tables of tokens. Usually a and the names of all groups containing it token equals a word. appear as tags attached to the item. Phrase: An ordered sequence of tokens Replicating an item: The new group's name either concatenated by + signs or enclosed and the names of all groups containing it in double quotes. appear as tags attached to the item, too. Query: One or more tokens connected by Tags represented by a regular group are called operators and grouped with parentheses. "group tags"; tags created without an existing Words containing non-alphanumeric group are called "ordinary tags." See also p. characters are split internally into a phrase, 43ff e.g. 1234/5678 will technically be searched as "1234 5678". THE TAGS GROUP

Every DEVONthink To Go database contains a CASE top-level group named Tags. Tokens are case-insensitive; operators have When you add a tag to an item, e.g., through to be entered in all caps. You can capitalize the Info panel, DEVONthink To Go creates tokens in your query but DEVONthink To Go a group for the tag in the Tags group and will ignore case when interpreting it. replicates the item to it. WILDCARD When you rename a group inside the Tags group, all items tagged with it will show the By default only items are found that contain change, too. tokens that match the entered query exactly. Use the * wildcard character at the end of a Use the Tags group to find all documents token to match a partial word. The wildcard tagged with a specific tag or use the Tags does not work at the beginning or in the smart group on the home screen to list all middle of words. tags in all databases. Example: devon*

SEARCH OPERATORS This query matches all documents which

DEVONthink To Go allows you to use prefixes, name, content, or comment contains at least Boolean operators, and parentheses to fine- one word that begins with "devon". tune your search.

DEVONthink To Go 2.7.9 Documentation, page 45 SCOPE PREFIXES query1 AND query2: Contains query1 AND query2 The scope buttons below the search field query1 OR query2: Contains query1 OR let you narrow results to only the current query2 database or even just the current group. To NOT query: Does not contain query further narrow down your search by searching "query1 query2 ...": Matches the queries e.g. only by name or in the comments use the query1 and query2 etc. in exactly this order following scope prefixes: and with no other tokens between them. name: Searches only in item names query1 + query2 + ...: Matches the queries comment: Searches only in comments query1 and query2 etc. in exactly this order content: Searches only in contents and with no other tokens between them. tags: Searches only in tags Besides the classic Boolean operators, Scope prefixes consist of the scope name DEVONthink To Go allows you to use NEAR followed by a colon. They only apply to the to find documents containing phrases (not next token, not phrases or queries. Add a whole queries) in a specified proximity of scope prefix before every token within a each other. Currently the syntax differs from query. DEVONthink for Mac. An alternative syntax will likely be added to DEVONthink To Go in a Example: name:devon* content:eric future version. tags:blue NEAR (phrase1 phrase2): phrase1 appears Finds all documents with names containing 10 words or less before or after phrase2 words starting with "devon", content NEAR (phrase1 phrase2, n): phrase1 containing the word "eric", and being tagged appears n or less words before or after with "blue". phrase2

BOOLEAN OPERATORS When evaluating the query, DEVONthink To Go processes the queries using the following The operators (often called Boolean rule of precedence (high to low): operators) are words or symbols that establish logical rules for the queries in the AND search query. OR NOT Operators have to be entered in capitals. If no operator is given between phrases or NEAR You can override the default behavior by groups, DEVONthink To Go assumes AND. using parentheses.

The available Boolean operators are: Example: NEAR (Steve, Jobs, 2) AND (iMac OR (iPad NOT MacBook))

DEVONthink To Go 2.7.9 Documentation, page 46 This query looks for documents that contain use URLs, e.g. Calendar, OmniFocus, etc. Tap the words "Steve" and "Jobs" more than two an item link to open DEVONthink To Go and words away from each other, as well as either show the linked item. In addition, you can use the word "iMac" (no specific position relative item links for images or links in Markdown and to Steve and Jobs) OR the word "iPad" but HTML documents. not MacBook Item links look like this: Example: steve and jobs x-devonthink-item://[?page=]

Because "and" appears in lowercase this The UUID is a string of letters and numbers query looks for documents containing all separated by hyphens that represents the three words in any order: "steve", "and", and universally unique identifier for the item. "jobs". You can use the UUID of a group also as destination in a bookmarklet URL (see SYNTAX DESCRIPTION below).

Note: The 'page' parameter is optional. Use it to The following describes the syntax in directly refer to a specific page of a PDF. Backus-Naur form. Note: Text in means := string [*] := that its variable; text in [square brackets] + := means that the part is optional. [ :] := [ :] := USING PATHS ( ) := AND := OR := In Markdown and HTML documents you can NOT := colname use absolute and downward-relative paths to := { colname1 colname2 ... } := NEAR ( link to images and other documents saved in ... [, N] ) your DEVONthink To Go database.

To add an image named 'Illustration' and ITEM LINKS AND PATHS located in the group 'Images' at the same Using a custom URL scheme you can link level as the Markdown document, you'd use to items in your databases from other e.g. the following code: applications. Place an 'item link' into the  notes field in OmniFocus or or any other In an HTML document linking to the image software that allows you to add URLs. would look like this:

LINKING TO ITEMS

Long-tap and item or use the Share menu to obtain a universal link for the item. You can use this link in any application that lets you

DEVONthink To Go 2.7.9 Documentation, page 47 An absolute path would look like this when By default x-callback commands that the Markdown document is located in the return data send it in the 'text' parameter group 'CoolStuff' in the top level of the with the'input' parameter set to the string database: 'text' (required e.g. by the Workflow app). If needed for your workflow you can provide  'retParam' parameter. Note: Relative paths only work down the

group tree. It's not possible to use '..' to ADDING DATA travel up. So for relative paths to work the item needs to be located in the same group clip: Opens the New Document Assistant, as the Markdown document or a subgroup pre-filled with the provided data. of it. createbookmark: Creates a new bookmark. createdocument: Creates a new document from UTI and file data. URL COMMANDS creategroup: Creates a new group. DEVONthink To Go allows you to execute createhtml: Creates a new HTML certain actions by opening links, URLs, document. that begin with 'x-devonthink:' or 'x- createimage: Creates a new image. devonthinktogo:' instead of, e.g., the well- createmarkdown: Creates a new Markdown known 'http:'. You can add these links to document. other apps, e.g., OmniFocus, or even paste createtext: Creates a new plain text or type them into the address bar of Safari. document. Instead of opening a web page they activate createwebarchive: Creates a new DEVONthink To Go and make it do something. webarchive. import-clipboard: Imports data from the For Workflow.app and other automation pasteboard to the global inbox. tools, DEVONthink To Go supports the x- callback-url protocol. Many commands listed Depending on the command you have to below can be used either directly or as x- provide additional data via parameters: callback-url command. destination: The UUID of a group or The URL commands for DEVONthink To Go database where the item shall be created. look like follows: title: The title of the item to be created. comment: A comment to be added to the x-devonthink://[? [&...]] x- item. devonthink://x-callback-url/[? location: The URL linking to the content, [&...]] e.g., the URL of the website for the All parameter values have to be percent- bookmark or the image. encoded. If you are manually building URL commands, you can use online tools like urlencode.org to encode the values.

DEVONthink To Go 2.7.9 Documentation, page 48 source: Base64-encoded file data for You need to provide the following parameter createimage and createdocument, raw to reference the document that you want to HTML data for createhtml. modify: tags: Comma-separated list of tags to be uuid: The UUID of the item, e.g., derived attached to the created item. from an item link (see above). text: The text content for text documents. uti: The UTI for the document (only used In addition, the commands optionally take for and required by createdocument). one or more of the following parameters flagged: Marks (1) or unmarks (0) the item (append only uses and requires text): as flagged. destination: The UUID of a group or unread: Marks (1) or unmarks (0) the item database where the item shall be moved as unread. to. You can only provide one destination; if label: Sets the item's label (0-based index the item was previously replicated to more or name of the label). than one group it will be unlinked from all of Note: If the 'destination' parameter is not them and placed into the new group. specified the item is created in the global title: A new title for the item. inbox. You can find the UUID of a group by comment: A comment to be set in the getting its item link and cutting the UUID item's metadata. out of the URL (the long alphanumeric location: A URL to be set in the item's string after 'x-devonthink-item://'). metadata. source: Base64-encoded file data to be set Examples: as the item's new content. x-devonthink://createbookmark? tags: Comma-separated list of tags to be location=http%3A%2F %2Fwww.nytimes.com&title=New%20York added to the item. If the item was already %20Times x-devonthink://x-callback- tagged the previous tags are removed and url/createtext?title=Robotic+manta the new set of tags is added. +ray&text=Building+a+robot+is+easy.+But... text: Text content to be set for or appended to the document (required by MODIFYING DATA append). You can modify content and metadata of flagged: Marks (1) or unmarks (0) the item existing items using URL commands. as flagged. unread: Marks (1) or unmarks (0) the item update: Updates an existing item. as unread. append: Appends text to an existing plain label: Sets the item's label (0-based index text or Markdown document. or name of the label).

DEVONthink To Go 2.7.9 Documentation, page 49 At least one of these parameters has to be text: The base64-encoded document data given as otherwise there's nothing to modify. or the metadata as JSON object. The source and text parameters are mutually input: 'text' (for Workflow.app). exclusive with source taking precedence if uti: The UTI of the document ('content' both are present. command only).

Examples: Example:

x-devonthink://x-callback-url/ x-devonthink://x-callback-url/ update?uuid=50EA48F6-D528-4512- item?uuid=50EA48F6-D528-4512-B528- B528-B9F24F46185F&title=New%20York B9F24F46185F&x-success=workflow%3A%2F %20Times&location=http%3A%2F %2Frun-workflow%3Fname%3DItemMetadata %2Fwww.nytimes.com x-devonthink:// x-callback-url/append?uuid=50EA48F6- SEARCHING D528-4512-B528-B9F24F46185F&text=Building +a+robot+is+easy.+But... Search your databases.

search: Search DEVONthink To Go and RETRIEVING DATA show or retrieve the results. You can retrieve metadata about a document The command takes the following or even the document content (up to 10 MB parameters: in size) using the following two commands.

As they deliver raw data they only work when query: The query to use for the search. called with the x-callback-url protocol variant. scope: The UUID of the database or group to search. Optional; if not set DEVONthink item: Returns selected metadata of a To Go searches all databases. document as JSON object.

content: Returns the content of a When called in the regular form the command document as base64-encoded data. navigates to either the database or group list: Returns a JSON array describing the given as scope or to the global inbox. It contents of a group. then shows the search field, sets the scope get-itemlink: Returns the item link for the button, and enters your query. currently selected document. When called in the x-callback-url form The commands item and content take the DEVONthink To Go executes the search and following parameters: sends the results back:

uuid: The UUID of the document, e.g., text: The results as JSON array of objects. derived from an item link (see above). input: 'text' (for Workflow.app).

The data is sent back in the following Examples: parameters of the x-success URL: x-devonthink://search?query=devonthink +AND+%28mac+OR+ios%29 x-devonthink://x- callback-url/search?query=devonthink+AND+

DEVONthink To Go 2.7.9 Documentation, page 50 %28mac+OR+ios%29&scope=50EA48F6-D528-4512- To run a hidden command tap [Execute] B528-B9F24F46185F&x-success=workflow%3A%2F above or type the complete command %2Frun-workflow%3Fname%3DSearchResults URL into Safari's address bar and press the ↩ Return key. Usually you'll be advised PERFORMING SERVICE TASKS by DEVONtechnologies' staff to use these fix: Fixes common problems. It fixes file commands in a support situation. protection issues, deletes the caches, and recalculates all item counts. [Execute] CHANGING SETTINGS reindex-metadata: Marks all items in all There are a few settings in DEVONthink To Go databases for metadata reindexing. Use that you cannot change in the Settings but this command, e.g., when searching does only with the preference URL command in the not find items by their name, comment, or following form (example): tags. [Execute] reindex-spotlight: Clears and rebuilds the x-devonthink://preference? key=DTTGDebugCoreData&value=yes Spotlight index in the background. Use this DTTGDebugCoreData: Enables additional command, e.g., when searching for known console logging related to the database item names or content via Spotlight does core (YES or NO). not produce any results. Please note that SyncDebugLog: Enables additional console Spotlight only indexes the first 16 KB of logging related to the database core (YES text per document. [Execute] or NO). reindex: Marks all items in all databases

for full reindexing. Use this command, e.g., Note: These hidden settings are not an when searching does not find items by official feature and could be changed or their content. Attention: Some documents removed with any update. that only DEVONthink for Mac can index might not be searchable after reindexing. [Execute] resync: Deletes the current sync status so that the next synchronization will fully sync everything again. Use this command when the synchronization seems incomplete, missed to apply some changes, etc. [Execute] delete-caches: Deletes all caches so that DEVONthink To Go rebuilds them over time. Use this command when item counts or detail information about documents seems to be out of sync. [Execute]

DEVONthink To Go 2.7.9 Documentation, page 51