Tag Folders User Guide

  • View

  • Download

Embed Size (px)


Using tags is a brillant idea to manage data in a very individual way.They integrates perfectly with the GTD (getting things done)-method.i suggest you to gooogle also for:-Punakea-Xmind


Tag Folders User!s GuideVersion 2.0

2 of 21

2008 Jon Christian Stovell This work is licensed under the Creative Commons Attribution-Noncommercial-Share Alike 2.5 Canada Licence. To view a copy of this licence, send a letter to Creative Commons, 171 2nd Street, Suite 300, San Francisco, California, 94105, USA, or visit http://creativecommons.org/licenses/by-nc-sa/2.5/ca/

3 of 21

Quick Start Guide" Introduction" Installation and Setup"List of All Files Installed by Tag Folders!

5 5 67

Making Tag Folders "Multi-word tags! Spotlight comments! Dropping les onto New Tag!

88 8 9

Ways to Access and Use Tag Folders" Customizing a Tag Folder"Basics of Tag Folder criteria! Changing or adding tags and comments to an existing Tag Folder! Keyword criteria! Using other search criteria! Automatically removing unwanted tags! Including Spotlight Items!

9 910 11 11 12 12 12

Hierarchical Tag Folders " Applying Extra Tags " Optional settings "Update modication times when tagging les!

13 14 1515

Growl Notications " Tag Prompter"Use! Setup!

16 1616 17

4 of 21

What you will be prompted to tag, and what you will not! How it works! What not to do!

17 17 18

Comment to Tag Importer" Troubleshooting" Getting Support, Sharing Ideas, Etc." Non-English users" Source code, Licencing, and Modications"

18 19 20 20 20

5 of 21

Quick Start GuideRun the Tag Folders installer. Answer the setup questions, and then use New Tag to create new Tag Folders. Drag-and-drop les onto the icons of your Tag Folders in order to tag them. Open a Tag Folder to see all the les that have that tag. Save a le into a folder that is being watched by Tag Prompter in order to be prompted to tag it.

IntroductionTag Folders are Applescript droplets that automatically apply OpenMeta tags (and, optionally, Spotlight comments) to les based on the search criteria of a Smart Folder contained inside each Tag Folder droplet. Opening a Tag Folder displays its Smart Folder, providing quick access to all les that have the associated tags. Thus, Tag Folders provide a simple, straightforward means of using Spotlight and Smart Folders to tag and organize les with minimal effort, using the familiar interface of the Finder. The advantage of Smart Folders over regular folders is clear: they bring together les that match certain conditions even though those les are actually scattered all over the hard drive. This means that one le can appear in any number of Smart Folders, allowing it to be grouped together with other les according to any set of criteria that the user nds meaningful. The same le might appear in a Smart Folder for your trip to Paris in 2004 (but not the return trip in 2007), in another Smart Folder for documents and images related to Gothic architecture, and in another that gathers materials from your previous successful grant proposals. However, Smart Folders take more effort to set up than regular folders, and a simple drag-and-drop does not allow a le to be moved from one group to another. An excellent solution to this limitation is the use of tagssmall comments attached to a leto quickly designate any arbitrary groups that the le should belong to. Tag Folders uses the OpenMeta tagging framework to create a simple, Finder-based, drag-and-drop method to apply tags quickly, easily, and automatically. Thus, Tag Folders are as easy to use as regular folders and as powerful as Smart Folders. They are what Smart Folders should have been.

6 of 21

Installation and SetupTo install Tag Folders, run the Install Tag Folders application on the Tag Folders disk image. It will place a copy of Tag Folders.app in your Applications folder, and then it will ask you some setup questions. The rst question asks where to make the default folder in which new Tag Folders will be created. (The folder does not have to stay here permanently, and can be moved to a new location at any time you like.) A Tag Folder called New Tag will automatically be created inside this folder. The second question asks whether to run Tag Folders in legacy mode or in default mode. Legacy mode allows you to continue using older tagging applications that do not yet support OpenMeta tags. It is only necessary if you plan to keep using one of these older apps in the future. If you are no longer using a legacy tagging app, or if you have never used one, it is recommended that you choose default mode. Default mode provides extra functionality that is not available in Legacy mode. The third question asks what formatting to use with Spotlight Comments. There are several options available: Spotlight default will simply write each word separated by spaces. Natural Language separates each comment from the next using a comma and a space, as in normal English usage. Users who have previously used other tagging applications to tag their les can maintain compatibility by selecting the appropriate formatting style from the list. Some of these options may ask for further information. You may also choose to create a custom formatting style if the presets do not meet your needs. Custom formatting allows you to specify a custom comment delimiter (that is, the string of text used to separate one comment from the next) and/or a custom prex and sufx to attach to any comments. You will also be asked whether every word of a phrase should be formatted as a separate comment (e.g. a, new, comment), or if the phrase as a whole should be treated as one comment (e.g. a new comment). After you have answered these questions, the installer will update all your existing Tag Folders to the latest version, and install all necessary support les. After this, Tag Prompter will launch and ask you its setup questions. Tag Prompter watches folders for new or changed les, and prompts you to tag them automatically. Click the Add folders button to choose a folder to watch. You may repeat this process to add as many folders as you like. To watch all the subfolders of a folder, or to stop watching a folder, click the Edit folder list button. When you are nished, click Save and Quit. You may change these settings at any time by running the main Tag Folders application from the Applications folder, and choosing Congure Tag Prompter from the pop up dialog box.

7 of 21

Once you have answered these questions, you will be given the chance to create a new Tag Folder. Select New Tag from the list and click OK. Follow the directions under Making Tag Folders for help on how to make new Tag Folders. Finally, you will be asked to start the Comment to Tag Importer application. First it will ask if you want to import the comments of all les, or only the les in a specic folder. It will then tell you how many les it has found to work on, and ask you how often it should post progress notications. Once you click the button to start the import, it will ask you for the Spotlight comment format that you have used in the past, and then start importing comments using those settings. You will receive progress notications as the les are processed, and a notication when the import is complete. If any les encountered errors during the import, they will be listed in an error log le on your desktop. You can manually tag these les yourself at any time. Finally, the Comment to Tag Importer will run a check for illegal characters in the tags on your les, and offer to clean them up if found. List of All Files Installed by Tag Folders When Tag Folders are installed on your computer, the following les and folders are created: 1. /Applications/Tag Folders.app 2. /Library/Spotlight/OpenMeta.mdimporter 3. The default Tag Folders folder at a location you choose 4. A Tag Folder named New Tag inside the default folder 5. ~/Library/Application Support/Tag Folders 6. ~/Library/Application Support/Tag Folders/Settings.plist 7. ~/Library/Application Support/Tag Folders/Tag Folders (an alias to the default folder) 8. ~/Library/Application Support/Tag Folders/Tag Selected Files.app 9. ~/Library/Application Support/Tag Folders/Comment to Tag Importer.app 10. ~/Library/Application Support/Tag Folders/Tag Prompter.app 11. ~/Library/Application Support/Tag Folders/Tag Prompter Settings.plist 12. ~/Library/LaunchAgents/com.vndv.tagfolders.tagprompter.plist In addition, each Tag Folder that you make will create a corresponding Smart Folder inside ~/Library/Saved Searches. If you move a Tag Folder out of the default folder, when that Tag Folder is opened in its new location it will create an alias to itself inside the default folder. If you put the Tag Folder back into the default folder and open it again, the alias will be deleted. NOTE: If Tag Folders is installed by a user without administrator privileges, items 1 and 2 of this list will be installed to ~/Applications/Tag Folders.app and ~/Library/Spotlight/ OpenMeta.mdimporter.

8 of 21

Making Tag FoldersMaking new Tag Folders is very easy. Just double-click on the Tag Folder named New Tag and a small dialog box will pop up asking you to enter the text for the new tags to use for your new Tag Folder. If you want to use more than one tag for this Tag Folder, simply type more words. Once you have created a Tag Folder, you can modify it further. This is especially helpful if you only want it to tag certain kinds of les, or if you want to create a Tag Folder that removes unwanted tags or comments. See Customizing a Tag Folder. Multi-word tags Normally, each word becomes a tag. But sometimes two words really belong together as a single tag (New York rather than New, York). To create a multi-word tag in the New Tag dialog box, enclose the words inside double quotation marks ( " ), like so:

This example will create a Tag Folder with three tags: New York, italian, and restaurant. Spotlight comments If you are running Tag Folders in default mode,