Connecting Devices with ShipBlink – ShipBlink

Getting Started with DeviceBridge

DeviceBridge is a lightweight local application that connects ShipBlink to your hardware devices, including printers, during your shipping workflow. DeviceBridge supports Windows and macOS. Scale integration is coming soon.

📥 Installation Guide

Step 1: Download DeviceBridge

Download DeviceBridge for your operating system:

ZIP file password: Contact ShipBlink Support to request the password needed to extract the download.

Step 2: Install DeviceBridge

For Windows

Download the Windows installer. If it is inside a ZIP file, extract it using the password provided by ShipBlink Support.
Run the installer as an administrator and follow the on-screen instructions.
Once installed, DeviceBridge runs as a background service on your computer.

We recommend using Run as administrator when launching DeviceBridge on Windows.

For macOS

The installation order matters. Extract the ZIP file, then run the Terminal command below before opening the extracted DMG or dragging the app into Applications.

Download the macOS ZIP file and save it in your Downloads folder.
Extract the ZIP file using the password provided by ShipBlink Support. The extracted disk image should be named EasyPost-Enterprise-DeviceBridge.dmg. Keep this DMG file in your Downloads folder.
Open Terminal. You can find it in Applications > Utilities > Terminal, or search for “Terminal” using Spotlight.
Copy and paste the following command into Terminal, then press Return:
```
cd ~/Downloads && xattr -d com.apple.quarantine "EasyPost-Enterprise-DeviceBridge.dmg"
```
This command removes the macOS quarantine attribute from the downloaded DeviceBridge disk image. Use it only for the DeviceBridge file downloaded through the link in this article.

The command assumes the extracted DMG is in your Downloads folder and has the exact filename shown above. If it is somewhere else or has a different name, update the path or filename before running the command.
After the command completes, double-click EasyPost-Enterprise-DeviceBridge.dmg in Finder. In the window that opens, drag the EasyPost Enterprise DeviceBridge app into Applications.
Open your Applications folder and launch EasyPost Enterprise DeviceBridge.
When DeviceBridge is running, the EasyPost logo appears in the macOS menu bar:

If you already copied the app into Applications before running the command and it will not open, see macOS installation troubleshooting below.

🖨️ Printer Setup

DeviceBridge works with printers configured in Windows or macOS.

All printers, including USB printers, must be installed as system printers and configured as the default printer in your operating system to work with DeviceBridge.

Setting Up Your Printer

Ensure your printer is installed and available as a system printer. Set it as your operating system's default printer.
Confirm DeviceBridge is running on the computer connected to your printer.
In ShipBlink, go to Settings > Printing Setup.
Click Refresh Printers to detect available printers.
Choose your preferred printer from the dropdown.

⚡ Instant Print Feature

Instant Print enables labels to print automatically after a shipment is created, with no extra clicks needed.

Instant Print is currently optimized for Individual Shipment workflows. It is not fully supported for Batch processing at this time.

How to Enable Instant Print

Go to Settings > Printing Setup in ShipBlink.
Toggle Instant Print on.
Select your default printer for instant label printing.

⚖️ Scale Integration (Coming Soon)

Scale integration is under development for a future version of DeviceBridge.

Contact ShipBlink Support with questions about scale integration.

🛠️ Troubleshooting

macOS Installation: DeviceBridge Will Not Open

If macOS prevents DeviceBridge from opening, check the installation order. The Terminal command must be run on the extracted DMG before opening it and copying the app into Applications.

If you already copied the app into Applications before running the command:

Quit DeviceBridge if it is running.
Return to the extracted EasyPost-Enterprise-DeviceBridge.dmg file in Downloads.
Run the Terminal command in the macOS installation steps.
Open that DMG and drag DeviceBridge into Applications again. If Finder asks whether to replace the existing DeviceBridge app, choose Replace.
Launch DeviceBridge from Applications.

Terminal Shows “No such file or directory”

Confirm that you extracted the ZIP file and that EasyPost-Enterprise-DeviceBridge.dmg is directly inside your Downloads folder. If the file is in a subfolder, was saved elsewhere, or has a different filename, adjust the command to match its actual location and name.

Installation Still Fails

Contact ShipBlink Support with your macOS version, a screenshot of the error, and any error text shown in Terminal. Let us know whether the Terminal command was run before or after the app was copied into Applications.

DeviceBridge Not Connecting

If ShipBlink shows “DeviceBridge Not Connected”:

Confirm DeviceBridge is running. Look for its icon in the Windows system tray or the EasyPost logo in the macOS menu bar.
Restart DeviceBridge manually.
Check whether your firewall is blocking DeviceBridge.
Try restarting your browser or your computer.

Printer Not Detected or Not Printing

Make sure the printer is powered on and connected.
Verify it is installed as a system printer and configured as the default printer in your operating system.
Print a test page from your operating system to confirm the printer works.
Restart DeviceBridge, then go to Settings > Printing Setup in ShipBlink and click Refresh Printers.
Ensure your label files are in PDF format.

💻 System Requirements

Operating systems: Windows 10/11 or macOS
RAM: Minimum 4 GB
Hardware: Available USB ports if using USB devices
Network: Internet access required for ShipBlink

🔐 Security & Privacy

DeviceBridge runs locally on your computer and communicates with ShipBlink through your browser. It accesses the hardware devices you authorize.

🙋 Need Help?

Visit the ShipBlink Help Center.
Email support@shipblink.com.

Related to