{"id":18665324,"url":"https://github.com/robertklep/homey-syslog","last_synced_at":"2025-07-05T09:34:55.375Z","repository":{"id":57266410,"uuid":"113547554","full_name":"robertklep/homey-syslog","owner":"robertklep","description":"Remote syslog logging for Homey apps","archived":false,"fork":false,"pushed_at":"2017-12-08T15:38:15.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-15T02:43:04.850Z","etag":null,"topics":["athom","athom-homey","home-automation","homey","ios","syslog"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robertklep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-08T07:53:32.000Z","updated_at":"2017-12-08T07:56:33.000Z","dependencies_parsed_at":"2022-08-25T03:41:05.008Z","dependency_job_id":null,"html_url":"https://github.com/robertklep/homey-syslog","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertklep%2Fhomey-syslog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertklep%2Fhomey-syslog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertklep%2Fhomey-syslog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertklep%2Fhomey-syslog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robertklep","download_url":"https://codeload.github.com/robertklep/homey-syslog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239492639,"owners_count":19647993,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["athom","athom-homey","home-automation","homey","ios","syslog"],"created_at":"2024-11-07T08:27:12.658Z","updated_at":"2025-02-18T14:49:59.388Z","avatar_url":"https://github.com/robertklep.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# homey-syslog\n\nA simple library to enable [Homey](https://www.athom.com/) apps to log to a remote syslog server. This requires that you have a syslog server running somewhere in your network, configured to accept external connections from syslog clients.\n\nThis library patches the built-in Homey logging code so anything that gets logged will _also_ be logged to the syslog server.\n\n## Installation\n\n```\n$ npm i homey-syslog\n```\n\n## Usage\n\nIn your apps `app.js`:\n```\nrequire('homey-syslog')([ SYSLOG_SERVER ][, opts]);\n```\n\n`SYSLOG_SERVER` is the name or IP-address of your syslog server.\n\nIt's optional iff you provide `Homey.env.SYSLOG_HOST`, i.e. if you have a file `env.json` that defines it:\n\n```\n{ \"SYSLOG_HOST\" : \"11.22.33.44\" }\n```\n\nValid options:\n* `port` : TCP/UDP port for the syslog server. Defaults to `Homey.env.SYSLOG_PORT`, or `514` otherwise.\n* `transport`: either `tcp` or `udp` (the default)\n* `globalHandlers`: when `true`, will hook `uncaughtException` and `unhandledRejection` to log these errors over syslog. Defaults to `Homey.env.SYSLOG_GLOBALHANDLERS === true`.\n\n## Example\n\n```\nrequire('homey-syslog')('192.168.1.123', {\n  port           : 514,\n  transport      : 'tcp'\n  globalHandlers : true,\n});\n```\n\n## DON'T USE IN PRODUCTION CODE\n\nThe purpose of this library is to aid during development of Homey apps, it's not intended to be used for apps in production.\n\nAn option could be to explicitly set a `DEBUG` environment variable in `env.json`, and only load this library when that variable evaluates to true:\n```\n// env.json\n{ \"DEBUG\" : \"true\", \"SYSLOG_HOST\" : \"...\" }\n\n// app.js\nif (Homey.env.DEBUG === 'true') {\n  require('homey-syslog')(...);\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertklep%2Fhomey-syslog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobertklep%2Fhomey-syslog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertklep%2Fhomey-syslog/lists"}