TruGrid SecureRDP - Mac Toolkit

The TruGrid Mac Toolkit is a macOS app that bundles the TruGrid diagnostic scripts and the live RDP session tracker into one place. It replaces the need for Mac users to run shell scripts from the terminal when they want to diagnose connectivity or jump between active sessions.

The toolkit is the Mac equivalent of the TruGrid SecureRDP Toolkit on Windows. The two tools share the same intent, the same report style, and the same conventions for where things live. Where the platforms differ (the Mac client logs differently, the macOS permission model is different), the toolkit adapts.

This article covers what the toolkit does, how to install it, the permissions it needs on first launch, and how to use each of its surfaces.

What it does

The toolkit gives you four things in one signed app bundle.

A menu bar item that shows your currently active RDP sessions at a glance, the same way the standalone TruGrid Session Tracker does. Click any session in the dropdown to bring that session's window to focus in Microsoft Windows App.

A main window with three diagnostic buttons. The first runs a one-shot Connector Reachability check, the second runs a 60-minute Network Monitor, and the third runs a Trace Route that captures the network path to the TruGrid front end, the latest known relay IP, and your default gateway. All three produce a self-contained HTML report on the Desktop, the same reports the standalone scripts produce when run from terminal.

A live output area that shows the diagnostic script's progress while it runs, so you can watch what is happening instead of waiting silently for the report to appear.

A Recent Reports list that shows the last twenty HTML reports the toolkit has produced, with timestamps and one-click open, as well as the ability to sort them or delete ones you no longer need. Useful for support tickets, comparing runs across days, or finding a report you generated yesterday and lost track of.

Installation

Download the App using this link: SecureRDP Mac Toolkit.

Drag it into the /Applications folder.

The toolkit appears in two places at once:

• A dock icon, while the main window is open.
• A menu bar item at the top-right of the screen, always present once the app is running.

First launch: permissions

The toolkit needs a macOS permissions to function.

• Accessibility. Lets the toolkit read the window titles of Microsoft Windows App so it can detect which RDP sessions are currently active. Without this, the menu bar item shows "Permissions required" and no session list appears.

Once the permission is granted, the Permissions section in the window disappears and the menu bar item begins showing active sessions within a few seconds.

The main window

The window has four sections, top to bottom.

**Focus Active Session. **This will simply bring the last active RDP session to the front of your MacOS.

Header. The TruGrid Mac Toolkit name on the left in TruGrid blue, the version number underneath, and a Focus Active Session button that brings your most recently active RDP session window to the front. The TruGrid logo sits on the right. The Focus Active Session button is disabled when no RDP session is currently active.

Diagnostics. Two rows, one per diagnostic script. Each row has a script name on the left, a small info icon next to it that opens the script's help article in your browser, then a Run button and an Open Latest Report button on the right.

Clicking Run starts the diagnostic. The output streams live into the Output section below. Clicking Open Latest Report opens the most recent HTML report this script has produced, regardless of whether the script is currently running.

Output. A compact panel showing the live stdout from whichever diagnostic is currently running, or the last to run if none is currently running. When a script is running, a Cancel button appears here that stops the run.

Recent Reports. A scrollable list of the last twenty HTML reports the toolkit has produced. Each row shows when the report was generated as a relative timestamp ("23 min ago"), a small blue badge identifying which diagnostic produced it (Reach or Monitor), and the report's filename. Click any row to open that report in your default browser.

The list updates automatically whenever a script run completes, and refreshes every five seconds while the window is visible.

The menu bar item

The menu bar item lives at the top-right of the screen alongside other system menu extras. Its label tells you, at a glance:

• The number of currently active RDP sessions.
• The name of the most recently active session, truncated if long.

Click the menu bar item to see the full active sessions list. Each session is clickable and brings that session's Windows App window to focus when clicked. Below the session list are two utility items:

• open Toolkit Window, which surfaces the main window if you have closed it, and Quit, which exits the toolkit entirely.
• the menu bar item is the toolkit's always-on surface. The main window can be closed without quitting the app; the menu bar item keeps tracking sessions in the background.

Running diagnostics

All diagnostics produce the same HTML reports as the standalone scripts. The reports are self-contained, openable in any browser, and safe to attach to support tickets.

Connector Reachability is a one-shot health check. It probes the TruGrid front-end endpoints with full TLS handshake and certificate inspection, checks your system proxy configuration, finds the running TruGrid Mac Connector by behavior, and probes the assigned RDP relay if a session is active. Runs to completion in a few seconds. See the Connector Reachability article for full details on what the report contains.

Network Monitor is a sustained passive probe. It samples five targets every two seconds (public DNS, your local gateway, the TruGrid front end, the currently assigned relay) for sixty minutes, clusters any outages it sees, and writes a report with a correlation verdict explaining which side of the path failed. Use it when an RDP disconnect happens intermittently and you want to capture which link broke when it broke. See the Network Monitor article for full details.

Trace Route is a one-shot snapshot of the network path your packets take to reach the TruGrid front end, your assigned relay (if a session is active or recently closed), and your default gateway. Each target's path is captured hop by hop with latency per hop, giving you a topology view that complements the success/failure picture from the other diagnostics. Use it when reachability or monitor diagnostics flag a problem but do not tell you where in the path the problem lives. The output identifies the gateway, the ISP edge, and the upstream provider hops, which is often enough to localize the issue to your network, your ISP, or somewhere past it.

Recent Reports

The Recent Reports section is populated by scanning your Desktop for files whose names match the toolkit's report naming convention. The toolkit produces reports with prefixes like TruGridMacClientReach_ and TruGridNetMonitor_, plus a timestamp. The Recent Reports list shows the twenty most recent matching files, sorted newest first.

If you move, rename, or delete a report file from the Desktop, the list updates on the next refresh (every five seconds, or immediately when a new report is generated). The toolkit does not store its own database of past reports; the file system is the source of truth.

Reports do not expire automatically. They accumulate until you delete them. Keeping them is harmless; they are static HTML files, each a few hundred kilobytes at most.

Updated on: 01/06/2026