Skip to content

User Guide

Jump to bottom
DadArcade edited this page Aug 13, 2026 · 3 revisions

Cupsie User Guide

Welcome to Cupsie! Cupsie brings native CUPS print server queues and standalone IPP/IPPS network printers directly into your Chrome browser's print dialog.

Quick Start (3 Steps)

  1. Install: Add Cupsie from the Chrome Web Store.
  2. Configure: Open Cupsie Options, enter your CUPS server or printer URL (e.g., http://192.168.1.10:631), and click Save Settings.
  3. Allow & Print: Click Allow on the Chrome host connection permission prompt, then press Ctrl + P (Cmd + P on Mac) to select your printer!

Table of Contents

  1. Installing the Extension
  2. Configuring Printers & CUPS Servers
  3. Granting Chrome Permissions
  4. Printing with Cupsie
  5. Authentication & Saved Passwords
  6. Troubleshooting & Support

1. Installing the Extension

  1. Open the Cupsie Web Store Page.
  2. Click Add to Chrome and confirm installation.

2. Configuring Printers & CUPS Servers

Opening Extension Options

  • Click the Cupsie icon in your toolbar and select Options (or right-click the icon $\rightarrow$ Options).
cupsie-options

Adding CUPS Print Servers

If your printers are managed on a central CUPS server:

  1. Locate CUPS Servers on the Options page.
  2. Enter the server URLs or IP addresses (one per line): 
    http://192.168.1.10:631
https://cups-server.local
  3. Cupsie will automatically discover all print queues available on those servers.

Note

HTTPS connections require trusted SSL certificates on your CUPS server.

Adding Standalone IPP/IPPS Printers

If connecting directly to a printer without a print server:

  1. Locate Standalone IPP Printers.
  2. Enter the details:
    • URL: E.g., ipp://192.168.1.50:631/ipp/print or http://10.0.1.25/ipp/print
    • Name (Optional): Friendly nickname (e.g., Office Color Laser).
  3. Click + Add Another Printer to add more standalone printers.
🔑 Advanced Settings: Requesting Username & Sync Intervals
  • Default Requesting Username: Tells the server who you are so it displays printer queues authorized for your account (defaults to "Chrome User").
  • Background Sync Interval: Set how frequently (in minutes) Cupsie refreshes printer status in the background.

3. Granting Chrome Permissions

Chrome requires explicit permission to access devices on your local network:

  1. Click the blue Save Settings button at the bottom of the Options page.
  2. Approve Permission Prompt: Chrome will display a browser popup asking for host permissions.

    [!IMPORTANT] You must click Allow or Grant. If denied, Chrome will block Cupsie from reaching your network printers.

  3. Upon approval, a green banner confirms: "Settings saved and printers synced!"
cupsie-permissions

Tip

Multiple Computers / Chrome Sync: If you sign into Chrome on another PC, your printer list syncs automatically, but local network permissions must be granted per-device. Click Save Settings on the new computer when prompted to trigger the permission pop-up and grant network access to your CUPS servers/printers.

4. Printing with Cupsie

  1. Open Chrome's print dialog using Ctrl + P (Windows/Linux) or Cmd + P (macOS).
  2. In the Destination dropdown, select your Cupsie printer.
  3. Custom printer settings (trays, paper type, stapling, duplexing) can be adjusted under advanced options.
  4. Click Print!

5. Authentication & Saved Passwords

If a printer or server requires password authentication, a Printer Login Required window will automatically pop up.

Logging In

  1. Enter your Username and Password in the dialog.
  2. Click Save Credentials. Cupsie tests them immediately:
    • ✅ Green message: Credentials verified; dialog closes automatically.
    • ❌ Red message: Invalid login; check credentials and try again.
  3. Check "Don't ask again" if you want Cupsie to skip prompting for a specific printer.

Managing Saved Credentials

  • View saved addresses and usernames under Stored Credentials on the Options page.
  • Click the ✕ button next to an entry to delete credentials, then click Save Settings.

6. Troubleshooting & Support

Issue Cause Action
Printers missing in print dialog Missing network permissions or incorrect URL Open Options, check server URL, click Save Settings, and click Allow on the Chrome prompt.
HTTP 401 / 403 Unauthorized Server requires authentication Enter valid credentials in the login popup. Manage stored logins under Stored Credentials.
Network Connection Failed Printer offline or wrong subnet Ensure printer is powered on and connected to the same local network.
Proxy / Firewall Block (HTTP 407) Enterprise network interception Verify network proxy credentials or consult your network administrator.

Diagnostic Logs

  1. Click View Troubleshooting Logs → on the Options page to view the 24 most recent events.
  2. Click Download Log to export a diagnostic .txt log file to send to your IT support team.

Clone this wiki locally