Preferences (Direct)
Note: Preference options may differ based on edition.
General

Application
Apply cleaner to entire contents when no selection
Enable to automatically apply selected cleaner to the entire document (or text contents) when no selection is found. If option is disabled, cleaners will only be applied if there is a selection.
Quit application when last window is closed
Enable to automatically quit the application when the last text document is closed. This can be useful when the Clipboard Workspace (see below) is disabled.
Sort Items in Built-in Groups
Custom cleaners are automatically sorted alphabetically. Enable this option to also sort the built-in groups alphabetically.
Remember most recently used items
Specify the number of items to keep in recently used items menu. The default is 10.
Clipboard Workspace
Specifies whether to use Clipboard Workspace and what format the text should be:
- Disabled
- Plain Text Format
- Rich Text Format
Default group
Specify the default group to display when a new window is created, whether it is the clipboard workspace, a new document or an opened document. Once the window is created, you can change the group displayed.
MyScrub shortcut
Specify which cleaner to use when MyScrub is called. This may be Scrub (default) or any custom cleaner you create.
New Documents
Specify the type of document to create by default (cmd-N).
- Plain Text Document
- Rich Text Document
Note: You can also directly create either a rich text document (ctrl-cmd-N) or a plain text document (opt-cmd-N), bypassing this preference.
Don’t warn when switching from rich to plain text
Switching converting a document from rich text to plain text will throw away any style information with the text. Normally a warning is put up every time the conversion is selected. Enable this option to perform the conversion without a warning.
Append “.txt” extension to plain text files
Option that mimics TextEdit’s save option for plain text. Enable to automatically append the “.txt” extension when no extension is given. A plain text document saved as “MyDocument” becomes “MyDocument.txt”. If you specify an extension, TextSoap will use it instead. A plain text document named “MyDocument.html” stays unchanged.
Text Editor

These options apply to default values for text editor. This applies to both Clipboard Workspace and Text documents. Once the editor has been created, you can change many of these options via the Edit or View menu.
Options
Show ruler (rich text)
Enable to display the paragraph ruler when editing rich text. The rich text ruler allows you to change tab stops, as well as left, right and indent margins on a per-paragraph basis.
Show invisibles
Enable to display spaces, tabs, returns found in the text.
Show line numbers
Enable showing the line numbers. In this context, lines are equivalent to paragraphs.
Show word count
Enable to display count of paragraphs (lines), words and characters. Character count without spaces is displayed in parentheses.
Highlight current line
Whether to use the background highlight to show where the cursor is.
Spelling
Check spelling as you type
Enable the automatic spell checker to mark potentially misspelled words as they are entered into the document.
Check grammar with spelling
Enable to also use the system’s grammar checker when spell checking.
Correct spelling automatically
Enable to allow for automatic correction of words with the spell checker.
Substitutions
Text replacement
Enables automatic substitution of a variety of static text items based on user preferences. You can specify replacements in System Preferences > Keyboard > Text.
For more advanced text replacement options, take a look at TextExpander from Smile Software.
Smart copy/paste
Controls whether the receiver inserts or deletes space around selected words so as to preserve proper spacing and punctuation.
Smart quotes
Automatic quote substitution causes ASCII quotation marks and apostrophes to be automatically replaced, on a context-dependent basis, with more typographically accurate symbols.
Smart dashes
Turning on automatic dash substitution enables automatic conversion of a two ASCII hyphen (-) characters into an em-dash.
Smart links
Smart link detection causes text representing URLs typed in to be automatically made into hyperlinks.
Data detectors
Automatic data detection enables detection of dates, addresses, and phone numbers.
Default zoom
Specifies the default zoom to use when displaying new or opened documents.
Rich Text Font
Specify the default font when creating new Rich text editor. If the editor (for either Clipboard Workspace or Text documents) is a plain text editor, it will use Plain Text Font.
Plain Text Font
Specify the default font when creating or opening plain text documents.
Appearance

Invisibles
Set the color used to display invisible characters, such as spaces, tabs, returns, etc. Click “Default” button to reset.
Current Line Color
Specify the line color to use to highlight the current line. The color selected is blended together (to insure text remains readable), so the result of this is shown next to the color selection button. Click “Default” to reset to the original value.
Action Color Style
Specify whether to use the normal colors for actions within a custom cleaner or to use a lighter variation.
Toolbar
Specify the style of toolbar (icon only, text only, icon & text) and size (large or small). These are applied across all toolbars in the app.
Updates

(Direct Download)
Automatically check for updates
Recommended to remain on. When selected, this option will regularly check for any software updates.
Check Now
Immediately check for any updates available.
Show Beta Releases
When selected, this option will include beta updates as well as official updates. Recommended only for advanced users.
Advanced

These options are for some more advanced functionality and aren’t needed by most people. The following options will require a relaunching of the application to take full effect.
Disable Custom App Icons
Turns off special day icons and seasonal icons.
Flip Season Icons for Southern Hemisphere
Some of our customers live south of the equator where the seasons are reversed. So when we enjoy Spring, they are enjoying Fall. This flips the icons to match those seasonal dates better.
Show OS X Services Preference
With TextSoap Menu and other options available, we generally discourage heavy use of Services. Unfortunately, the non-deterministic means that OS X Services uses to decide which Service definition to use can call all sorts of issues if you have more than one volume connected to your Mac, or more than one copy of TextSoap.
We think TextSoap Menu gives you a much greater set of options (including changing groups, hot keys, etc) that we encourage more use of that. But, for now, we’re still offering basic support for Services and you can enable that here.
Additionally, there are some options to quit or re-launch internal components. For the most part, you won’t need to use these.
Launch/Quit textsoap8Agent : this launches automatically as needed.
Launch/Quit textsoap8Menu : normally you can rely on the preference checkbox. In some rare cases, you may have to manually tweak it.
OS X Services Inspector : launches the Services Inspector, a utility/debugging app which can help in debugging OS X Services issues.
TextSoap Menu

Install TextSoap Menu and launch at login
This will startup TextSoap Menu and place it in your menubar. It also tells the system to relaunch it if you restart your Mac.
Menu Icon
Specify the icon you wish to use. We like the default.
Menu Style
There are two styles of menu available:
Single Group : behaves much like cleaner lists within TextSoap. You specify a group, and the cleaners within the group are displayed.
All Groups : the contents of a group will be displayed as a submenu for each group name.
Toggle Global Palette
Provide a hot key to toggle display of global palette.
Action Shortcuts
Provide a list of shortcuts to apply a cleaner or display a group. The hot key to apply a cleaner acts the same as if you selected it within the TextSoap Menu.
OS X Services

If you have enabled the option to show OS X Services preference pane in the Advanced pane, you can setup customized Services.
Install Custom OS X Service items using custom group
Use the custom group to build a custom list of services to display in the OS X Services menu.
This will write a custom service definitions to ~/Library/Services/textsoap8.service, where ~ represents your home folder.
Launch Inspector
Launches the OS X Services Inspector, a tool designed to help you diagnose OS X Service issues related to TextSoap.
Open Keyboard Preferences
OS X Services can have hot keys associated with them via the system Keyboard Preferences.
Once again, we recommend using TextSoap Menu and AppleScript as integration options over OS X Services, which has many limitations and long standing issues.