Getting Started

Manage your libraries
Before you can link your documents to Thoughts, you need access to your media libraries, document folders, bookmarks and contacts. All libraries found in the default places, e.g. the Pictures folder for iPhoto or Aperture libraries, are imported automatically.

But Thouggle lets you import additional libraries and document folders providing a direct access to all those library items without opening any specific application. After the library setup you can organize your documents in Thoughts, preview it, open it, share it with other people and more.

A special feature of the library import allows you to import your personal library organization (folder names, playlists, album names, address groups etc.) as Thoughts into Thouggle. All your thoughts you have already put into the organization of your documents can so be reused in Thouggle to find and access your documents. That easy.
Import a library to Thouggle
  • Import a library by dialog[+]
    • Click the +-button below the sidebar. A menu with entries for imports and Thought creation opens.
    • Choose one of the four import menus at the top. To import a folder in the finder, choose Folder…, to import a media library, choose Library…, and so on.
    • An Import sheet opens that lets you select the item to be imported (only folders allowed). Additionally you can define, if the imported library has to be added to the sidebar or not and if the existing library organization (like playlist names, album names, folder names etc.) has to be imported as Thoughts.
    • Click OK to start the import. Depending on the size of the library, the import can last some time.
    • If you have selected to import the existing library organization, the data store of Thouggle is now populated with Thoughts you can use to find your documents (see Find your documents).
  • Import documents by drag and drop[+]
    • Make sure that no Thought in the sidebar is selected (click on an empty area of the sidebar).
    • Select some item(s) in the Finder, and drag them to the 3D browser view of Thouggle.
    • A popover opens asking to rate the dropped documents and/or add them to one or more Thoughts.
    • Just click OK without entering anything. The dropped documents are imported to Thouggle. They can be re-displayed by selecting the "Last Import" item found below the Documents element at the top of the sidebar.
    • This import is not saved permanently, so you have to link the documents to a Thought, if you want to access these files later again.
Remove a library from Thouggle
  • Remove an imported library[+]
    • Select the library you want to remove in the sidebar.
    • Click the minus-button below the sidebar. The library is removed.
    • Alternatively you can also press Cmd+to remove the selected library.
Manage your documents
Thouggle adds another layer of organization to your Mac. It lets you organize your documents in Thoughts, like iTunes lets you organize your music in playlists. The handling of Thoughts in Thouggle is very similar to the handling of playlists in iTunes making it easy to get started with Thouggle.

Remark: Adding or removing documents to/from Thoughts doesn't affect your files on the file system at all. None of your files are deleted, moved or renamed on the hard disk. The documents are just unlinked from a Thought.

Hint: If you can’t remove a document, make sure you didn’t select a document in a Smart Thought or an imported library, which are not editable structures.
Add documents to a Thought
  • Add a document to a Thought by drag and drop[+]
    • Select some item(s) in the Finder, and drag them to the 3D browser of Thouggle.
    • If a Thought is selected in the sidebar, the documents are linked to this Thought directly. A message pops up summarizing the performed task.
    • If no Thought is selected in the sidebar, a popover opens asking to rate the documents and/or add them to one or more Thoughts.
    • Start typing in the Thoughts field. A list with all fitting Thoughts in the data store opens. Choose the Thought the documents should be linked to or type a new Thought.
    • Click OK to complete the task. All documents are now linked to the given Thought(s) and/or are rated. A message pops up summarizing the performed task.
    • Shortcut: Alternatively you can drag the selected documents directly to a Thought in the sidebar. All documents are linked to this Thought directly.
  • Add a document to a Thought by copy/paste[+]
    • Select some item(s) in the Finder, and copy them with Cmd+C.
    • Click into the 3D browser in Thouggle and paste the documents with Cmd+V.
    • See above for further steps when a Thought is selected in the sidebar or not.
  • Add a document to a Thought from an imported library[+]
    • Select an imported library in the library browser (top view in sidebar). All documents of this library are displayed in the 3D browser if any.
    • Select some document nodes in the 3D browser and drag them to a Thought in the sidebar.
    • The documents are linked to the Thought.
  • Add a document to a Thought in the info panel[+]
    • Select an imported library in the library browser (top view in sidebar) or any Thought in the sidebar. All documents of this library or Thought are displayed in the 3D browser view.
    • Open the info panel in the 3D browser (Cmd+I OR click with three fingers into the 3D browser = quick look gesture).
    • Select one or more document nodes in the 3D browser. The info panel is updated with the common values of the selected documents.
    • Open the "Tags" tab in the info panel and start typing the Thought name in the tags field. Autocompletion supports you in finding the right Thoughts. Press Enter twice to add the selected documents to the entered Thought(s).
Delete documents from a Thought
  • Delete a document from a Thought (unlinking)[+]
    • Select the Thought in the sidebar. The linked documents are displayed in the 3D browser.
    • If the requested Thought is not visible in the sidebar: Click on the +-button below the sidebar. Add a Thought to the sidebar. Type the requested Thought name into the edit field of the new entry (autocompletion supports you in finding the right Thought). Click Enter twice to complete task.
    • Click the item(s) to be deleted in the 3D browser, and press the Delete key (⌦).
    • OR choose Delete in the Edit menu.
  • Delete a document from a Thought by Cut[+]
    • Select the Thought in the sidebar. The linked documents are displayed in the 3D browser.
    • If the requested Thought is not visible in the sidebar: Click on the +-button below the sidebar. Add a Thought to the sidebar. Type the requested Thought name into the edit field of the new entry (autocompletion supports you in finding the right Thought). Click Enter twice to complete task.
    • Click the item(s) to be cut in the 3D browser, and press Cmd+X (or select Cut in Edit menu). The item(s) are deleted from the Thought and added to the pasteboard.
    • Paste the cut items to another Thought.
Display documents of a Thought
  • Display documents of a Thought[+]
    • Select the Thought in the sidebar. The linked documents are displayed in the 3D browser.
    • If the requested Thought is not visible in the sidebar: Click on the +-button below the sidebar. Add a Thought to the sidebar. Type the Thought name into the edit field of the new entry (autocompletion supports you in finding the right Thought). Click the Enter-key twice to display all linked documents.
Find your documents
  • Find your documents with a Thought[+]
    • Press Cmd+F. A popover opens in the 3D browser asking for a Thought.
    • Start typing in the field. A list with all fitting Thoughts in the data store appears. Select a Thought in the list and click OK. All documents of the Thought are displayed.
    • Advanced Search: Click the disclosure button to open advanced search capabilities. Define your document request with the rule editor and press OK to display all documents fulfilling the defined query.
Preview your documents
  • Preview your documents[+]
    • Display some documents in the 3D browser by selecting an imported library or a Thought in the sidebar.
    • Double-click a document. The preview mode is enabled displaying the document in an integrated quick look view. A subsequent double-click would disable the preview mode.
    • Scroll through all kind of documents like PDF, iWork documents and others
    • Zoom document size with the magnification gesture
    • Browse through all documents in preview mode by arrow keys, swipe gestures or the mouse wheel
    • Auto-start time-based media files like movies or sounds
    • Open a document in its assigned application.

    • Alternative: Select a document in the 3D browser. Press Space-bar to toggle the preview mode with the browser mode.
Key shortcuts

Sidebar navigation

Traverse your libraries or Thoughts in the sidebar with the following key commands for an even faster access:
Library section selection:
Shift+TAB key (Left click on section)

Expand child nodes:
(Key right) OR
double-click on closed node


Collapse child nodes:
(Key left) OR
Double-click on open node

Select next node:
(Key down)
Select previous node:
(Key up)
Expand all child nodes:
+ (Hold Alt key and press Key-Right)
Collapse all child nodes:
+
(Next
on parent node reveals only direct child nodes)

3D Browser Document Navigation

The 3D browser provides functionality to arrange or select documents in the scenery and perform actions on the selected documents.
Document selection
Select single document:
Left click on document

OR

select first visible document (sort order)
select last visible document
select first document
select last document
Select multiple documents:
+ Left click on subset of documents
Select all (visible) documents:
Shift + ⌘ + A ( + A)
Rubber band selection:
+ Left click on background.
Drag mouse around documents. All documents intersecting the marquee will be selected.
Open document in associated Application:
Ctrl+Double-click on document
Operation on selection
Drag and drop:
Select document(s) and drag selection outside of 3D browser.

Dropping a selection of documents on the browser view opens a popover allowing to add the dropped documents to any existing or new Thought and rate them.
Copy, paste:
+ C, + V (paste of documents opens the same popup like in a drop.
Cut:
+ X, removes a document from a Thought but keeps it in the pasteboard
Delete:
, removes a document from a Thought
Moving documents in scenery
Move single document:
Right click on document and drag document to new location
Move multiple documents:
Select multiple documents. Right click on one selected document and drag selected documents to new location
Document paging
Page up:
(Page up key)
Page down:
(Page down key)
End (jump to the last page):
(End key)
Home (jump to the first page):
(Home key)

3D Browser Scenery Navigation

The whole scenery (cloud of documents) can be moved or rotated in two modes, the camera mode and the world mode.

In the general preferences pane of the Preferences dialog the preferred scenery mode can be set. In the camera mode the camera pointing to the world is moved (pan, zoom) instead of the world itself. This results in an opposite move of the world for the commands below.

Scenery control
Move scenery:
Right click or CTRL + left click on background + drag mouse in direction of move
OR
CTRL +
←↓↑
Zoom scenery in and out:
+ left click on background + drag mouse up (zoom in) or down (zoom out)
OR
use mouse wheel
OR
CTRL +
+ ←↓↑
Rotate scenery around center:
left click on background + drag mouse like a trackball
Scenery animation
Left turn world animation:
+
Right turn world animation:
+
Pause world animation:
+
The world animation is paused but the rendering of the scenery is still performed with the given frame rate
Stop world animation:
+ .
Stops the animation and the rendering with a given frame rate. In this state Thouggle consumes a minimum of energy = energy saving mode for notebooks