Quick Start Guide

Before You Start

IMPORTANT !

The application and its installer are currently not signed.

Klipboard is a free-to-use open-source utility, and certificates signed by trusted Certificate Authorities are costly.

When you install Klipboard or run it for the first time, you will see a notification urging caution. You can dismiss the warning and proceed to install or run the app.

If you have concerns about the security of the application, feel free to review the source code and then compile and run Klipboard by yourself.

Get Kusto

Free Kusto

• Try Kusto for Free
• Run a local copy of Kusto

Paid Kusto

• Azure Data Explorer (requires Azure subscription)
• Fabric Realtime Analytics (requires Fabric account)

Install Klipboard on Your Windows PC

Download the application from Klipboard's GitHub Release Page You can choose to install Klipboard in two ways:

• As a ready-to-run executable
• As an installation

Ready-To-Run Executable

1. Download Klipboard.zip
2. Unzip the directory and place it in your preferred location
3. Open the directory and launch Klipboard.exe

Installation

1. Download and unpack KlipboardSetup.zip
2. You will find 2 installers there, setup.exe and KlipboardSetup.msi
3. Click on setup.exe
4. If prompted to install .net runtime, confirm and wait for the .net setup to complete
5. When prompted to install Klipboard confirm and wait for the setup to complete
6. Click the desktop or start-menu shortcut to run the application

Updating Klipboard

• If there's a new version, a notice will show up in Klipboard's tray icon menu
• Click the menu item to go to the download page, and download the new version
• Close Klipboard if it is running
• Follow the same instructions above matching your existing install mode

When Using Klipboard for the First Time

Set a Kusto Cluster to Use

1. Lunch the application
2. Right click the application tray icon and choose the Settings menu
3. Insert your Kusto Cluster Url in Connection Str
4. Insert the name of the database to work with in Database
5. Click the Add button

Klipboard Settings Screen

Change the Default Query Target

The default query target is Kusto Web Explorer. In the app Settings screen,

• Choose the Desktop option in the 'Query Target' drop down to use Kusto Explorer Desktop Application instead.
• Choose the Clipboard option in the 'Query Target' drop down to copy the resulting query back to the clipboard.

Enable Auto Start

In the app Settings screen, check the Start with Windows checkbox to start Klipboard automatically.

Windows User Experience Customization

1. Keep the app icon visible in the Quick Lunch tray, by dragging the app icon from the quick-lunch overflow pane to the quick-lunch task bar.
2. Add the app as a priority app to see notifications when Do Not Disturb is on (see instructions here).

You Are Ready to Go

• Copy a file, a table from Excel or a web page, structured text data or free text data.
• Right click the application tray icon
• Paste the data you placed in the clipboard to any of the query or store options
• The app will process the data you placed in the clipboard, then launch the chosen Query Editor to view the result
• Any errors or notifications will appear in the Windows notification tray

Next Steps

• Using-Quick Actions
• Mass Ingestion