Essentials

Folders

SnippetsLab keeps your snippets organized by storing them in folders. When you choose a folder from the sidebar, all snippets under that folder are listed in the middle column. If a snippet does not belong to any folders, it will appear under “Uncategorized.”

  • Show or hide the sidebar: Choose View > Show Sidebar from the menubar, or press Shift-Command-L.
  • Create a folder: Do any of the following:
    • Choose File > New Folder from the menubar.
    • Click the btn-add button in the bottom left of the sidebar, then choose New Folder.
    • Press Shift-Command-N.
  • Place a folder inside another folder: Drag the folder on top of the other folder.
  • Rename or delete a folder: Right-click a folder from the sidebar, then choose Rename or Delete.
  • Move snippets to a folder: Drag one or more snippets to the folder you want to move to. To select multiple snippets, Command-click them. To select a range of snippets, Shift-click them.
  • Automatically sort folders and Smart Groups: By default, you can manually reorder the folders with drag and drop. To keep them sorted alphabetically, choose SnippetsLab > Preferences…, click General, then select Automatically sort folders and Smart Groups.
  • Set default language: You can set the default language for a folder. For details, please see Default Language.

Tags

You can add tags to the snippets to make them easier to find. Unlike folders, a snippet can have multiple tags at the same time.

  • Show tags field: By default, the tags field is hidden when the current snippet doesn not have any tags assigned to it. Click btn-add-circle button and choose Add Tags to show the tags field.

    _images/tags.png

    If you use tags frequently, you may want to set the tags field to be always visible. To to that, choose SnippetsLab > Preference, click General, then select Always show tags field.

    Note

    The tag names are case-insensitive but will always be displayed exactly as they are created. For example, after creating a tag named Cocoa, you can equivalently add cocoa and it will be automatically changed to Cocoa.

  • Find items you tagged: To view all tags, click btn-toggle button at the bottom of the sidebar to switch to tags mode. To see all snippets with a certain tag, click the tag in the sidebar.

  • Rename or delete a tag: Right-click on a tag from the sidebar and select Rename or Delete. Deleting a tag will make it removed from all snippets.

Smart Groups

SnippetsLab can create “Smart Groups” based on rules you speficy, and then update these groups automatically as your library changes. Smart Groups are listed in the a special section of the sidebar, with icon btn-gear next to it.

Smart Groups can be useful because it allows you to dynamically search your snippets based on a wide range of criteria. For example, you could create a Smart Group that:

  • Display all snippets without any tags
  • Display all snippets with either iOS tag or Mac tag
  • Display all snippets with Swift language

If you want to create more complex rules — for example, with some criteria matching all rules and others maching any — you can create sets of rules, or “nested” rules.

_images/SmartGroup.png

To create a Smart Group, follow the steps below:

  1. Choose File > New Smart Group from the menubar, or press Control-Command-N.
  2. Enter a name for your Smart Group.
  3. Specify the rules you want to apply.
  4. To add another set of rules within a rule, hold down the Option key and click the Nest button. (When you hold down the Option key, the Add button changes to the Nest button.)

To rename, modify, duplicate or delete a Smart Group, right click on it and choose the corresponding item in the contextual menu.

Shortcuts

You can add your most frequently used folders and Smart Groups to the “Favorites” section of the sidebar as a shortcut.

_images/Shortcut.png
  • Add a shortcut: Shortcuts can be added by:
    • Right-click on a folder or Smart Group and choose Add to Favorites.
    • or drag a folder or Smart Group to the Favorites section.
  • Remove a shortcut: Right-click on a shortcut and choose Remove from Favorites. This operation only removes the shortcut and won’t affect the underlying snippets, folder or Smart Group.

Languages

Active Languages

SnippetsLab offers more than 350 different languages and language varients. To prevent the language selector menu from becoming too long, SnippetsLab only displays the “active” languages. By default, the list of active languages only contains C, C++, Objective-C, Python, PHP and JavaScript. You should customize this list to include the languages you use before start using SnippetsLab.

To set the active languages, choose SnippetsLab > Preferences… from the menubar and click Languages. Select the checkbox next to a language to mark it as active. To find needed languages quickly, you can use the search field above the list. You can also click the Active button to see only active languages (click All button to see all available languages.)

_images/ActiveLanguages.png

Note

Mark a language as inactive will only hide it from the language selector menu, and won’t affect the snippets using this language.

Default Language

You can select a default language for each folder, and snippets created in the folder will automatically use that language. The default value is “Plain Text.”

To change the default language, right-click on a folder and select one language in the Default Language submenu. Only Active Languages are displayed in that menu.

Snippets and Fragments

You can include multiple different “part” to a single snippet, which is known as a Fragment. Different Fragments under the same snippet can have different notes and languages.

Fragments can be useful when a snippet logically consists of multiple parts, especially when they have different languages. For example:

  • A class header and its implementation
  • Some HTML code and its JavaScript/CSS counterparts
  • Different solutions to one problem
_images/ff.png
  • Add a new fragment: Either click the btn-add-circle button and choose New Fragment, or press Command-T.
  • Rename a fragment: Right-click the fragment and choose Rename.
  • Delete a fragment: Right-click the fragment and choose Delete, or swipe left and choose Delete (OS X 10.11+).
  • Reorder fragments: Right-click the fragment and choose Move to Right or Move to Left.
  • Open in new window: Right-click the fragment and choose Open In New Window.

Custom Notes

You can add notes for a fragment to a dedicated “Notes” area. Links in the notes will automatically be recognized and made clickable.

By default, the notes field is hidden if there are no notes for the current fragment. To add notes, click btn-add-circle button and choose Add Notes.

_images/notes.png

If you use notes frequently, you may want to set the notes field to always be displayed. To do that, choose SnippetsLab > Preference from the menubar, click General, then select Always show notes field.