Tot Guide

Make Tot your own.

At the top-right of Tot’s window there is a toggle for settings. Here are some things that you can do to make the app fit your workflow:

Use a menu bar icon with a detachable window: With this setting, the window is tucked away at the top of your screen, but you can drag it away when needed. With this setting, there is no Dock icon or application menu so this is where you can quit the app.

Appearance: Tot looks great whether you prefer a dark or light interface. And you’ll either love or hate the colored background, so make your choice!

Set a system-wide hotkey: This setting allows Tot to become a keyboard-only app: the key combination you specify will bring up the window and allow you to type or navigate with keyboard shortcuts.

In addition to the settings view, you can also configure Tot using the menu bar:

Style the text view: The font for both rich and plain text can be customized along with the size and tab spacing using Format in the menu bar or from the context menu while you’re editing text.

Configure the text view: Sometimes smart quotes are just what you need, sometimes they screw up your code. Use the Edit > Substitions and Spelling and Grammar menus to tweak the text view to your needs. Each dot has its own settings and they are synced to other devices. (They are currently unused on iOS because there's no standard way to modify the settings there.)

Floating window: When you're taking notes, it can be helpful to have Tot's window above all others. Use Window > Display as Floating Window and the window will always be visible and ready to go!

And speaking of menus, if you find an item with a keyboard combo that you don't like (switching tabs!), take a look at our handy guide for customizing shortcuts.

Tot loves links.

Whether you’re in plain text or rich text, Tot handles links intelligently. If you drag a link from a web browser, you’ll get the page title and URL formatted as rich text or as Markdown inline link. In plain text mode, it’s easy to edit the parts individually; rich text gives you a clickable link.

This conversion also happens if you copy and paste a block of text from a web page: text and links are converted on the fly. If you’re entering URLs manually, they’ll automatically be detected as you type.

Links aren’t limited to just web pages. Click here to see "tot" in the dictionary. Here are other useful examples:

dict://CHOCK x-bbedit://open?url=file:///etc/hosts <facetime:18005551212> <tel:1-800-555-1212> ssh://root@example.com

Try dragging a message from Mail into Tot’s window: you will get a link that’s a simple way to reference conversations and other information!

Finally, Tot has its own URL scheme that can automate tasks. It works like this:

tot:// + host + operation + ? + parameter

The host is "1" to "7" and will open the numbered dot (left to right). If you specify "empty", the first empty dot is selected. Use "settings" and "help" to open their views.

The operation can be specified for dots; use "/prepend" to insert text at the beginning, "/append" to add to the end, or "/replace" the entire contents of dot. The parameter is "text" and a URL encoded string. For example, tot://1/append?text=odds+%26+ends%0A will add some text to the end of the first dot. To open the first dot from the Terminal, use open and this URL:

$ open tot://1

If you’re using the scheme from an AppleScript, "/content" will return the text from the selected dot. Try this:

$ osascript -e 'tell application "Tot" to open location "tot://6/content"'

There is no support for rich text in the URL scheme: use Markdown in plain text to get formatting. If this functionality appeals to you, look at this shell script.