The Document Browser
OmniOutliner’s document browser makes it easy for you to manage where and how your files are stored. Beyond the On My iPad or On My iPhone folder, which is the default storage location for OmniOutliner files on your iOS device, you can choose to sync folders with OmniPresence or your own WebDAV server, or use the Files app to open files stored in iCloud Drive or other cloud storage providers.
The Locations Screen
The Locations screen sits at the top level of the document browser, and is your home base for accessing OmniOutliner files on iOS.
The Locations screen includes all of the possible places your OmniOutliner files are stored. By default, this includes the On My [device] and Recent Documents folders, along with controls to open files through the Files app browser and add folders synced with OmniPresence.
Tap On My iPad or On My iPhone to view the files stored locally on your iOS device.
Tap Recent Documents to view files you’ve worked on recently. This includes documents stored anywhere (in your On My [device] folder, in another folder on your device, or in a synced cloud storage folder).
Tap Open... to open the iOS Files app browser, which appears in a sheet over the Locations screen and offers an interface identical to that of the Files app itself. Browse connected cloud storage accounts or other folders on your device here.
Tap Add OmniPresence Account to add a cloud synced folder to the Locations screen. Documents in this folder are automatically synced to the cloud whenever a change is made. You can sync with a free Omni Sync Server account, or an OmniPresence-capable WebDAV server of your choice.
On My iPad or On My iPhone
The On My [device] folder is where your OmniOutliner files (outlines, templates, and Omni Automation plug-ins) are saved on your device.
The square thumbnail images in this folder are document previews that represent individual OmniOutliner files or folders.
These document previews display the name of the file or folder, as well as the date and time it was created or last changed. Tap a document preview to open the associated file. To change the name of a file or folder, tap the name and then enter a new title.
Only files stored in your On My [device] folder or a connected OmniPresence folder can be renamed in this way. To rename other files (such as those stored in iCloud Drive that may appear in OmniOutliner's Recent Documents folder), tap the filename in the Files app instead.
To sort your files by Date or Title, or to view the available Outlines, Plug-Ins, or Templates in this folder, swipe down to access the Document Sorter:
The Recent Documents folder on the Locations screen provides a convenient location for viewing files that you have recently accessed, regardless of where they are stored.
Whenever you open a file (whether from the On My [device] folder, from the Files app, or from a connected OmniPresence account), OmniOutliner automatically adds it to the Recent Documents folder. From within the folder you can also tap the Open button to access the Files app UI and choose documents to open directly.
To remove files from the Recent Documents folder without deleting them from their original location, tap Select, then tap the thumbnail preview images for the files you want to remove, and tap Clear Document .
While selecting a single file, you can also tap Share to export the selected file via Mail, to the Files app, to another app on your device, or to a connected printer.
Managing the Trash
If you delete an OmniOutliner file, that file gets moved to the Trash folder on the Locations screen. Tap to view the contents of the Trash folder.
To delete all files from the Trash folder, tap Empty Trash, and then tap Delete Documents.
Move File from Trash
To move files out of the Trash, first tap Select in the toolbar, and then tap the thumbnail previews to select the files and use the folder menu to move them from the Trash to another folder.
Delete Selected Document
Tap to delete only the selected file(s). This allows you to pick and choose which files to permanently delete, rather than deleting everything.
Once a file is deleted from the Trash, it is permanently removed from OmniOutliner's local storage.
Open... and the Files App
The Open... entry on the Locations screen provides access to the iOS Files app right from within OmniOutliner. (This is the same UI that exists in the Files app itself.)
The Files app is analogous to the Finder on the Mac; it provides a means of accessing files stored in app-specific document folders on your device, as well as to files saved with cloud storage providers (such as iCloud Drive).
This includes the OmniOutliner outlines and templates you see in the On My [device] folder in OmniOutliner's own document browser. To see what’s stored in OmniOutliner’s documents folder in Files:
- In the Locations list, tap On My iPad (or On my iPhone, depending on which device you're using).
Tap the OmniOutliner folder to view what's inside.
Tap the file icon to open an OmniOutliner file from the Files app. When opening an OmniOutliner file from Files, the file is opened and saved in place when you close the file.
OmniOutliner File Types
Several file types are associated with OmniOutliner outlines, templates, and plugins. Files of these types can be opened, edited, and saved within OmniOutliner for iOS.
.ooutline, .otemplate—The newest standard file formats for OmniOutliner outlines and templates, as created by OmniOutliner 3 for iOS and OmniOutliner 5 for Mac. These formats support all of the new features of these versions of OmniOutliner.
.oo3, .oo3template—Older formats used by OmniOutliner 2 for iOS and earlier, as well as OmniOutliner 3 and 4 for Mac. These files can be read and edited by OmniOutliner 3 for iOS, but do not support the full feature set of the newer formats.
If warnings are turned on in OmniOutliner Settings, upon opening a file in an older format you are presented with the option to convert it.
- .opml—The Outline Processor Markup Language format, which is not unique to OmniOutliner but can be both read and written by it. Some features such as text and document styles are not supported by this format.
OmniOutliner can import and convert files of other non-native formats; in these cases, the files are copied into the app as outlines and the originals are left behind.
Add OmniPresence Account
Tap Add OmniPresence Account to connect an Omni Sync Server or WebDAV cloud storage account to OmniOutliner using the OmniPresence service.
You’ll be asked to choose between connecting to an Omni Sync Server account or an existing WebDAV server. If you don't have an Omni Sync Server account, you can create one for free here.
Once you have your account credentials, proceed to the next step to add them. OmniOutliner checks to make sure the server you’re connecting to is compatible with OmniPresence, and if it is, adds the connected sync folder to the list of locations on the Locations screen of the document browser.
Any OmniOutliner documents stored in this folder can be opened and edited in place within OmniOutliner for iOS, and changes made there are reflected anywhere else the folder and its files are synced (with OmniPresence and OmniOutliner for Mac, for example).
When browsing a connected OmniPresence folder, a Sync button appears next to the folder name in the toolbar. Tap this button to prompt a refresh of the folder's contents, or determine if something is preventing the folder from actively syncing. Refer to the section on syncing files from the document toolbar for details on the various sync icon states.
The App Menu
On the Locations screen, and when viewing the contents of a folder in the document browser, tap at the top of the screen to access the App Menu:
The App Menu has the following options:
Tap to see which version of OmniOutliner is installed on your device, and to find Omni’s contact information.
Tap to view the in-app reference manual.
Tap to send us an email.
Omni Newsletter Signup
Tap to subscribe to Omni’s quarterly newsletter via email. When tapped, you are taken to the Omni website where you can enter your email address to subscribe.
Tap to revisit the introductory experience and tutorial presented the first time you opened OmniOutliner.
Tap to see what’s new in the current release. The release notes are also available on Omni’s website.
The following menu items are only available when browsing the contents of a folder:
Copy from WebDAV
Imports a copy of a file stored on a WebDAV server. A copy of the file you choose to import is placed in your current folder location.
Imports a copy of a file from among your Recents (recently accessed files), or by Browsing for it in an in-app view of your iOS Files app. Switch between these two views with the buttons at the bottom of the sheet.
Trial Mode is only available prior to purchasing the upgrade to OmniOutliner Essentials or Pro. Tap to switch between Essentials and Pro to see which version is right for you.
Tap to purchase the upgrade from Trial Mode to either OmniOutliner Essentials or Pro. This is also where you can restore purchases, if you ever need to reinstall OmniOutliner on a device.
Set preferences for working in OmniOutliner. See OmniOutliner Settings for more details.
When viewing the contents of a folder in the document browser, the toolbar along the top of the screen includes the following buttons:
At the center of the folder toolbar, you will see the name of the current folder (such as On My iPad), followed by a label that shows the type of OmniOutliner files currently being viewed (Outlines, Plug-Ins, or Templates).
On the far left of the toolbar is the Back button, followed by the name of the folder that contains the files being viewed. Tap to go backward in the folder hierarchy to return to the Locations screen.
Tap the Add New button to create a new OmniOutliner document. The type of document created (outline or template) is based on the document type viewed in the Document Sorter.
After tapping Add New, the Template Chooser opens and displays a list of available templates for your document (starting with the custom templates you've created, if any).
If you would prefer to create a document based on a template in a language other than the system default, tap the language name in the upper right for a list of available alternatives.
Choosing a template creates a new document pre-populated with the contents of that template, including sample text (if any) and all of the template's default structural and named styles.
At the far right edge of a folder’s toolbar is the Select button. When tapped, Select makes it possible for you to tap to select documents within a folder. Once a document is selected, use the buttons on the left side of the toolbar to share or export the file, move it to another folder, duplicate the file, or move it to the Trash.
Sharing and Exporting
With a file selected, tap and then choose one of the following actions to perform on the file. When sharing an OmniOutliner file, you can choose the format to share or send as either an OmniOutliner file, an OPML file, Dynamic HTML, Simple HTML, PDF, Plain Text, CSV, XLSX, DOCX (plain or indented), or PowerPoint PPTX.
Learn more about OmniOutliner import and export in Opening and Exporting Files.
Send via Mail
Exports the selected file, in the format you have chosen, as an attachment to an email message.
Send to Files
Exports the selected file, in the format you have chosen, to the Files app. You can choose to send the file to a location in the cloud (such as iCloud Drive) or to an app’s local documents folder.
Send to App
Sends a copy of the file, in the format you have chosen, to another app on your iOS device.
Prints the selected file to an AirPrint printer of your choosing.
To save the file as a PDF rather than printing to paper, choose PDF document when exporting with one of the Send commands listed above.
Create Template from Outline
Creates an OmniOutliner template file from the selected outline document.
Use this menu to move the selected files to another folder, or create a new folder to contain them.
Move the selected file to another folder, including the On My [device] and any connected OmniPresence folders:
On My [device] — Choose to move the selected file to the On My [device] folder.
OmniPresence — Choose an OmniPresence folder to move the selected file to.
Other... — Open the Files app browser and choose another location for the file on your device or in a cloud-connected folder.
Create and name a new folder that contains the selected file.
Creates a duplicate copy of the selected file, and places that duplicate within the same folder. OmniOutliner adds the number 2 to the filename to help you isolate the duplicated file so you can change the filename to something else.
Move to Trash
Moves the selected file (or files) to the Trash. To view the contents of Trash, tap on the Locations screen.