{"id":48191,"library":"ip-report","title":"ip-report","description":"Node.js WebSocket client that periodically reports machine name and IP address to a server every 10 seconds. Current stable version is 0.0.45. Published with low release cadence. Key differentiators: lightweight, no build steps, runs via npx, supports Windows/Linux/macOS, and automatically installs Electron 28+ as a dependency for desktop notifications. Primarily used for machine monitoring or asset tracking in local networks.","status":"active","version":"0.0.45","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","websocket","client"],"install":[{"cmd":"npm install ip-report","lang":"bash","label":"npm"},{"cmd":"yarn add ip-report","lang":"bash","label":"yarn"},{"cmd":"pnpm add ip-report","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required for desktop notification support","package":"electron","optional":true}],"imports":[{"note":"ip-report is primarily a CLI tool, not a library. Use npx or global install.","wrong":"require('ip-report')","symbol":"default (running as script)","correct":"npx ip-report"},{"note":"No documented exports; package likely only exposes a CLI. Assume no imports.","wrong":"import { setClientName } from 'ip-report'","symbol":"setClientName (if exposed)","correct":"const ipReport = require('ip-report'); if (ipReport.setClientName) ipReport.setClientName('MyMachine')"}],"quickstart":{"code":"CLIENT_NAME='my-server' npx ip-report@0.0.45","lang":"javascript","description":"Runs the ip-report client with a custom machine name, connecting to default WebSocket server."},"warnings":[{"fix":"Update Node.js to version 18 or higher.","message":"Node.js 18+ required. Older Node.js versions will fail.","severity":"breaking","affected_versions":"<0.0.45"},{"fix":"Set ELECTRON_SKIP_PLATFORM_CHECK=1 or install electron globally beforehand.","message":"Electron auto-install may fail in headless environments or restricted CI systems.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Configure a custom server URL via environment variable SERVER_URL if available.","message":"The default WebSocket server (wss://li.feng3d.com) may be down or untrusted for production use.","severity":"gotcha","affected_versions":">=0.0.1"},{"fix":"Pin to exact version in scripts.","message":"No SemVer guarantee; version 0.0.x may break at any time.","severity":"breaking","affected_versions":">=0.0.1"}],"env_vars":null,"search_vec":"'0.0.45':25 '10':19 '28':46 'address':14 'asset':59 'automat':43 'build':35 'cadenc':30 'client':6,66 'current':21 'depend':49 'desktop':51 'differenti':32 'electron':45 'everi':18 'instal':44 'ip':2,13 'ip-report':1 'javascript':64 'key':31 'lightweight':33 'local':62 'low':28 'machin':10,56 'monitor':57 'name':11 'network':63 'node.js':4 'notif':52 'npx':39 'period':8 'primarili':53 'publish':26 'releas':29 'report':3,9 'run':37 'second':20 'server':17 'stabl':22 'step':36 'support':40 'track':60 'use':54 'version':23 'via':38 'websocket':5,65 'windows/linux/macos':41","created_at":"2026-06-07T16:55:22.114800+00:00","updated_at":"2026-06-07T16:55:22.114800+00:00","problems":[{"fix":"Upgrade Node.js to 18+ or use nvm to switch version.","cause":"Node.js version below minimum requirement.","error":"Error: The engine \"node\" is incompatible with this module. Expected version \">=18\". Got \"16.x\""},{"fix":"Run `npm install electron` or set ELECTRON_SKIP_PLATFORM_CHECK=true if not needed.","cause":"Electron dependency not installed (optional but needed for some features).","error":"Error: Cannot find module 'electron'"},{"fix":"Ensure you have network access to the server, or configure a custom endpoint.","cause":"Default server is unreachable or misconfigured.","error":"WebSocket connection to 'wss://li.feng3d.com/' failed: Error: connect ECONNREFUSED"},{"fix":"Check that your OS is supported (Windows/Linux/macOS) and architecture is x64.","cause":"Package contains native modules or Electron binaries not compatible with your OS/arch.","error":"npx: installed 1 in 2.084s\nError: Unsupported platform: win32-x64 not in ['linux-x64','darwin-x64']"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"ip-report","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}