Essential Manual 1

Essential Help

Text Expansion, Multi-Clip, Notes, Popup,
Reminders, Scripting, Etc. for Mac

Introduction

Essential is a multifaceted productivity tool that runs in the background to amplify productivity on the Mac. Essential is the successor to yType. yType was just a text expansion tool. Essential in a centralized utility that gives you multiple clipboards, text expansion, notes, reminders, popups like in iOS, scripting and more, all in one app.

Requirements 

Essential requires 10.7 or higher.

Terminology

Text Expansion

  • Shortcut – the abbreviation that expands into a block of text or an image.
  • Expansion – this is the block of text the shortcut expands into. An expansion can be plain text or formatted text and optional pictures.
  • Shortcut/Expansion Pair – this is the ‘shortcut’ and the ‘expansion’ items together. The shortcut is replaced by the expansion when typing. Sometimes we just call this pair a Shortcut.
  • Variable – a symbol you can place in the Expansion field that when called can expand into the current date, time, etc. There are many types of variables.
  • Shortcut Variable – a Shortcut can be made into a variable when surrounded by a few extra characters. They can be inserted into other expansions when selected from the Shortcut Variable drop down menu.

Clipboard

  • Clip – is an object copied to the clipboard using the copy or cut menu items or hotkeys.
  • Clipboard – is the container for one clip. Mac OS X provides one system Clipboard.
  • Clip History – is the shifting stack or chronology of clips copied/cut over time.

Overview

Essential combines 5 major tools in one menu item:

Essential Manual 2

  1. Multiple Clips
  2. Text Expansion
  3. Popup
  4. Reminders
  5. Notes
  6. Scripting

When the app is opened it’s lightbulb icon sits in the menubar like this:

Select ‘Essential On’ or ‘Essential Off’ to turn all of Essential on or off

Select Info to see the menu above which contains:

  • About – version number and other info.
  • Online Manual – this manual.
  • Suggestions and Bug-Reports… – send feedback.
  • Purchase… – find out more about buying the app.

Installation

Double click the Essential icon and it will launch the app and you will see Essential’s lightbulb small icon on the right in the top menubar.

If you are updating from yType there is info in the FAQ about importing old info.

IMPORTANT: The first time Essential starts up it needs your permission to access to certain services. Very important to do for Mac OS 10.13 and 10.14 (Mojave).

Essential Manual 3

Click ‘Open System Preferences’ and you will see this:

Essential Manual 4

At lower left click on the lock icon and sign in with your user name and password for that Mac.

Then click the little box next to the Essential icon above so you see a checkmark like this:

Essential Manual 5

Now click on the light bulb icon on the right site of the top menu and you will see this drop down menu.

Essential Manual 2

Essential is now ready to increase your productivity.

Shortcuts

A shortcut in Essential allows you to type an abbreviation or a larger block of text, image or image & text. Simply, enter an abbreviation (shortcut) and then a block of text and/or picture/formatted text (expansion). Now typing that abbreviation, what we call a shortcut and a space or return will insert that text which we call an expansion.

Type a few characters (shortcut) to paste a much larger block of text (expansion) like your name, a url, picture or even several pages of formatted text instantly anywhere on your Mac in any application.

Features

  • create a shortcut (a few letters) to enter large blocks of text or pictures and formatted text in any mac application.
  • copy and paste or drag in the blocks of text, pictures or formatted text.
  • use variables to insert the month, day, year, time, cursor, timezone.
  • embed one variable within another.
  • search thru all shortcut/expansion pairs.
  • available in English, French, Russian, Spanish, Italian, German, Swedish and Japanese. Please help us add your language.

Usage

Turn on or off Shortcuts via the preferences or thru the menubar.

  1. Example Text Shortcut

Double click on an empty space under the ‘Shortcut’ field or hit the + sign at bottom right. A new shortcut/expansion pair is created. Enter the ‘Shortcut’ at top right. The shortcut could be character or characters. Lets use:

mya

The expanded text could be your address:

John Smith
100 Main St.
Fairfield, IA 52556

Put that text in the ‘Expansion’ field at bottom right. Now when you type mya and a space or return then that address will instantly pop into the document.

Essential Manual 7

  1. Example Picture/Styled Text Shortcut

Create a new shortcut by hitting the + button. Type in a shortcut like ;whale  Now drag a picture into the expansion box. Now every time you type ;whale you will insert that picture.

Essential Manual 8

TIP: You can type in a URL (https://plumamazing.com) in as either plain text or into formatted text. In the formatted text control click on the URL to edit it.

Essential Manual 9

Naming Shortcuts

If you make a shortcut a regular word in your language then you can’t type that word without getting the expansion. To avoid this we make shortcuts that are not words.

In some examples we start the shortcut with a semicolon because it is an easy way to type fast. It also lets us put a memorable name to it. But using any character is fine.

Tips to develop your own naming system for shortcuts.

Making shortcuts a combination of a rarely used character combined with a descriptive name helps in recalling them. Using a rarely used char in front of the descriptive name allows you to create easy to remember groups. Like ; could precede the first letter of a url like p so that ;p could expand to https://plumamazing.com and be easily remembered.

Naming Examples

Shortcut                     Expansion

e@p                                elvis@presley.com
e@g                                elvis@graceland.com

Using the @ may help you remember your different email addresses

I use the ones below and they save me enormous amounts of time and typing.

;p                                    https://plumamazing.com
;k                                    http://knowledgeminer.com

Experiment and be consistent, over time you will develop your own pattern.

Using the ; for all the url’s of your websites can be a handy mnemonic but you can use anything.

Shortcut

qbizletter                        Dear Sir, ….

Using the letter q and a recognizable name could be a good technique for often used long messages, they can even be pages long. Then you can type the few letters of shortcut and have that expand into quickly into a long email.

IMPORTANT: Finding a good ‘Trigger’ means as few letters as possible that you won’t use in regular wrinting. To find a trigger use a dictionary site that allows finding every word with those few letters. Let’s say you think ‘obf’ might make a good ‘Trigger’ test it here like this:

https://www.thefreedictionary.com/e/OBF

That site tells you what words end with those letters. In this case most are acronyms you will never use. So, it makes a good triggger. You don’t want to use a few letters that you’ll type every once in awhile and be surprised by an expansion.

Settings in Shortcut

Essential Manual 10

Here you can change these settings:

  • Start Essential at Login – saves time when you restart your computer.
  • Add Space After Expansion – does exactly that.
  • Show Icon in Dock – if checked shows the app in the doc.

Variables

Below is the variable drop down menu.

Essential Manual 11

Add any of these variables in the expansion area add your own trigger and you can now

type the time, date, etc instantly without having to look it up.

Use %Y %m %d for year month and date by choosing those variables. Put them in any order you want.

Click on cursor variable to put in this %| which after expanding all triggers and variables will set the cursor to be right there where you put the variable.

Essential Manual 12

Shortcuts are just different kinds of variables. To use Shortcuts as variables just choose Shortcuts from the variable drop down menu. Here to the right ->

Choosing them from that menu is the best way but its simple to create them yourself. Surrounding Shortcuts with a few certain characters makes them variables. They look like this %shortcut:yourshortcutname%. They all start with %shortcut: then your shortcuts name then a % at the end. We call these Shortcut Variables.

Example: Lets say you have 20 letters you want to have in Essential and at the end of each one you put the same thing your name, the date and the time. First you could create a shortcut variable for those 3 items (your name, the date and time) and call it nd. Then in Essential add that Shortcut Variable to the end of the first letter put

%shortcut:nd%

You can then use this shortcut variable in the expansion area of yet another shortcut/expansion pair. Placed within another shortcut/expansion

%shortcut:nd% will expand into  name, date and time.

FAQ for Shortcuts

Q: Can I import shortcuts from the old yType app?
A: That is no longer possible. Over the long evolution Essential totally changed yType’s format.

What you can do is open the pref file:
user/library/preferences/ com.plumamazing.ytype.Dictionary.plist in your favorite text editor.
Scroll down to your first shortcut it will look something like this:
;name
Plum Amazing
Have Essential app open in the shortcut manager. then create folders for your old shortcut and then create your new shortcut. Copy & paste the main content (in this case ‘Plum Amazing’ seen above) from that file to the new Essential shortcut. Then give each shortcut a trigger (that is the new name for shortcut in Essential) and a title/description (optional).

Q: How long can expansions be?
A: There is no limit.

Q: How short can shortcuts be?
A: 1 letter but we recommend longer otherwise you can’t use that letter by itself without suddenly getting surprised by text shooting out every time you type it and a space. 🙂

Q: Can I delete your shortcut examples?
A: Sure, just select them and hit the – minus button

Q: Do I have to buy Essential?
A: After 30 days we remind you to purchase the software. You don’t have to but we hope you find it useful enough that you want to. Your payment is small but it helps us pay for programming, website, sales, tech support, design and the continuing evolution of the app. We have lots of ideas to make Essential even more essential in the future and the price will go up over time.

Q: I use a % in an expansion but it disappears when triggered.
A: This is the symbol for a variable. To make % visible and work use two like this %%

Clips

One of the revolutionary features that came with the Mac in 1984 was the unique ability to select text or pictures, etc., then copy that data into a clipboard, in order to hold that content temporarily, and then paste it in the same application or in a different one. The clipboard was used to transfer all kinds of info between programs on the Mac. Later, this feature was adopted into other operating systems. Our app CopyPaste was the first app for the Mac to add multiple clipboards. Essential has this feature as one of it’s abilities called Clips.

Essential Manual 13

Clips in Essential uses the Mac Clipboard and operates the same way but it adds search, editing, usage and display of multiple (infinite depending on RAM memory) clipboards.

Clips Menu

In the above screenshot you can see that selecting Clips from the Essential menu allows you to see a hierarchical menu that starts with:

Disable Clips: enable or Disable clips by selecting this item.Essential Manual 14
Manager: open or close the Clips Manger window.
Delete all: deletes all clips in the history.
Search: search for a word or phrase in all clips.

Clips History: is the title of what comes below.

;0 – this is the Macs main clipboard. Hit cmd v or ;0 to paste the clips contents.
;1 – this is clip 1. Type ;1 to get the contents of this clipboard. Very handy.
;2 – this is clip 2. Type ;2 to get the contents of this clipboard, etc for ;3…

The Manager for Clips is where you can search and edit clipboards. It looks like this:

NotesEssential Manual 15

Notes is a simple note taking app and a place to keep important notes. The Manager for Notes looks like this screenshot to the left. There you can create, view, edit and archive notes.

Scripts

Info to come.

Reminders

Reminders is a Mac and iOS app by Apple. It can hold reminders and to do lists. It is synchronized between all your personal iPhones, iPads and Macs. Reminders in Essential puts the features of Reminders on the Mac into the menubar for quick access. If you know Reminders on the Mac or iOS then you know how Reminders in Essential works. Here is a screenshot:

Essential Manual 16

Open the ‘Reminders Manager’ to add, remove or edit reminders. The Manager looks like this:

Essential Manual 17

Preferences

Here are the settings for Essential:

Essential Manual 18

General – options for launch of the app.
Hot Keys – display and edit all the key commands for major parts of the app.

Open Essential – click the button to set the hotkey to open Essential.

Selection to Expansion – highlight any text hit this key combination and Essential will open with that text in the Expansion area. All you have to do is type a shortcut.

TIP: To set the hotkey button hold down any of these command (Essential Manual 19), option (Essential Manual 20 ), shift (Essential Manual 21), control ( Essential Manual 22 ) and any regular key (a, b, c…1, 2, ‘,…) to change/set that hotkey.

Sound – change the sound settings for the app.
Popup – like in iOS when on this allows selecting an item shows a popup with options like copy, paste, spelling, definition.
Shortcuts – these are the settings for the shortcut tool.
Clips – set the number of clips in history and other options for clips.
Notes – no settings yet.
Scripts – no settings yet.
Reminder – set reminder length and reminders displayed.
Advanced – where the preference files are located for Essential
Backup – backup locally or to the cloud from here.
Registration – when you are ready to buy the app and purchase you will receive a registration key to copy and paste to here.

Q: Where are Essential files located including the preferences?
A: Essential is an application and should be in the application folder.

Go to the Advanced preferences to see the locations of other file locations

The files contains all the data for Essential. Make sure to use the Back Up feature to back up data locally and to the cloud occasionally.

Support

If you have questions please make sure to read the manual and faq first then feel free to contact us. We especially enjoy hearing your suggestions.

Also if you would like to see the application or this manual in your language so more people in your country can use Essential then please contact us. There is a short list of english text that you translate which we then pop into the app to localize it for your language.

Puchase and Licensing

To support the continuing evolution of this app please purchase it. Go to:

https://plumamazing.com/store

Essential Manual 23

Once you purchase you will receive a registration code that you can enter into the app in the Registration preference area.

Remember to copy and paste your name and email address and hit the apply button.

We appreciate your Feedback

Thank you!

Plum Amazing, LLC