# Snip for MacOS - Quickstart guide

This is a brief guide for getting up and running with Snip on your Mac computer. It will cover all the main features of the app and how they work.

### I’ve started the app, where is it?

Snip is a system tray app, which means you will find it in your system tray at the top right of your screen, rather than your Dock.

### Logging in with your Mathpix Snip account

Before you can start using the app, you must Log in with your Mathpix Snip account. Don’t have an account yet? You can sign up in the app or at accounts.mathpix.com. A full guide for creating your account can be found here.
Once you have entered your email address and password and successfully logged in, you will see your Snip List. If this is your first time using the app, the List will be empty and instead you will see this message Click here to take a snip! Or enter CTRL+⌘+M on your keyboard.

## Shortcuts

CTRL+⌘+M: Take a Snip (launches the screenshot)
CTRL+⌘+O: Open the app window
CTRL+⌘+L: Open the Snip editor
Note that the above shortcuts can be changed at any time by going to Preferences > General
When editing or writing a Snip, use CTRL+ENTER to Save and ENTER to create a new line.

### Taking a Snip

There are 2 ways to take a Snip:
1. Click the Screenshot button in the top left corner of the app.
1. Enter the keyboard shortcut (CTRL+⌘+M) anytime the app is running on your computer.
After either clicking the Screenshot button or entering the keyboard shortcut, your screen will turn gray and you will need to click and drag your cursor to capture the desired area of your screen.
Didn’t mean to take a Snip? You can exit the screenshot mode by clicking once or hitting esc on your keyboard.

### Syncing a Snip

All Snips taken from your account will sync automatically with any Snip app that you are logged into with the same account. Waiting for a Snip to sync? You can force an update by clicking the Sync button on the top right:

### Using a Snip result

Snip gives many different formats of results:
• LaTeX (best for LaTeX editors)
• Mixed text/LaTeX (best for Markdown editors)
• PNGs (best for WYSIWYG editors)
• Image URLs (best for HTML pages like blogs)
Text and LaTeX formats can be easily copied to your clipboard by toggling between the formats with your keyboard arrow keys. Whichever format row is selected will be copied to your clipboard automatically, so all you need to do is paste. You can customize which text and LaTeX rows appear in the app or your desired LaTeX delimeters by going to Preferences > Formatting.
You can copy or open a PNG format of either the original image or of the rendered LaTeX by clicking the buttons beneath the displayed image. Clicking Copy PNG automatically copies the image to your clipboard, while Open PNG will open the file in Preview.
Image URL formats can be found by navigating to the URLs tab:
There are 3 image URL formats:
• URL (best for sharing images in messaging & documentation tools)
• Markdown link (best for Markdown editors)
• HTML <img> tag (best for websites)
Just like the LaTeX and text format rows, whichever row is selected will be copied automatically to your clipboard.

### Editing a Snip

Did your Snip result come back not quite right? You can edit the source to make it perfect!
First, click the Edit button (it looks like a pen) on your desired format row. (NOTE: if you edit the text mode (second) row, you will lose the math mode rows)
This will open the Snip editor:
Make your changes in text box, you will see the changes render instantly in the preview above. Once you have your desired result, click Save:
Your Snip will update instantly and the updated result will be copied to your clipboard!

### Writing a Snip

Only available in Snip for Mac, we have an additional way of creating a Snip–by writing the Markdown or LaTeX directly. This is a convenient feature for users who need an image outputs (PNG or image URL) from raw LaTeX.
Click on the pen icon to open the Snip Editor page. Here you can toggle between Markdown or LaTeX, and start writing your Snip. Once you click save, a new Snip will be created. Note that this Snip will have no “original image”, since it has been created from text.

### Deleting a Snip

You can delete an individual Snip from that Snip’s result page:
You can delete all of your Snips from your Snip List page:
When you click the delete all Snips button, you will be asked to confirm that you want to delete all of your Snips (since this is an irreversible action). Click the Delete All Snips button to confirm, or the X to cancel.

You can quit Snip at any time by clicking on the Settings wheel to open the menu, and then choosing Quit. You can also enter ⌘+Q on your keyboard whenever the app is active to quit.