{"id":15686302,"url":"https://github.com/ethomson/summoner","last_synced_at":"2026-03-01T22:01:58.380Z","repository":{"id":11094587,"uuid":"13445498","full_name":"ethomson/summoner","owner":"ethomson","description":"A simple Windows application to notify you of mentions in chat rooms like Campfire or TFS Team Rooms","archived":false,"fork":false,"pushed_at":"2014-12-12T19:42:38.000Z","size":152,"stargazers_count":10,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-08-13T22:30:50.664Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ethomson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-09T15:05:39.000Z","updated_at":"2025-02-06T04:15:14.000Z","dependencies_parsed_at":"2022-09-15T06:51:28.665Z","dependency_job_id":null,"html_url":"https://github.com/ethomson/summoner","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ethomson/summoner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethomson%2Fsummoner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethomson%2Fsummoner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethomson%2Fsummoner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethomson%2Fsummoner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ethomson","download_url":"https://codeload.github.com/ethomson/summoner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ethomson%2Fsummoner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29986241,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T21:06:37.093Z","status":"ssl_error","status_checked_at":"2026-03-01T21:05:45.052Z","response_time":124,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-10-03T17:37:43.678Z","updated_at":"2026-03-01T22:01:58.358Z","avatar_url":"https://github.com/ethomson.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"Summon̈er\n========\n\nA simple Windows application to notify you of mentions in chat rooms\nlike Campfire or TFS Team Rooms, so that you will never miss an\nimportant conversation just because you had your browser closed.\nIt can also make you look omniscient, eerily spooking your coworkers.\n\nSummon̈er scans chat rooms (\"clients\") for keywords and then fires\nnotifications when it sees them.\n\nClients\n-------\n\n  - [Campfire](https://campfirenow.com/)\n  - [TFS Team Rooms](http://tfs.visualstudio.com/en-us/learn/collaborate-in-a-team-room.aspx)\n\nNotifications\n-------------\n\n  - Console (Standard Output)\n  - [Growl for Windows](http://www.growlforwindows.com/gfw/)\n  - SMS (via [Bandwidth Developer Platform](https://catapult.inetwork.com/pages/login.jsf))\n\nUsage\n-----\n\nSimply running `summoner.exe` will start the program.\n\nCommand line options:\n\n- `/config:\u003cfilename\u003e`: specifies the configuration file (default: `summoner.config` in the same location as the `.exe`\n\nConfiguration\n-------------\n\nConfiguration is in the form of a JSON file.\n\n### Configuration Options\n\n- `poll_interval`: the number of seconds to pause before polling clients\n- `clients`: an array of client configuration definitions\n- `notifications`: an array of notification definitions\n\n### Client Configuration\n\nClient configuration is specified as key/value pairs.  The `type` \nconfiguration is mandatory.  Other configuration values will be\npassed to the client.\n\n#### Campfire\n\n- `type`: must be `campfire`\n- `uri`: URI to the Campfire account\n- `api-token`: API token for authentication\n- `room`: name of the room to monitor\n\n#### TFS Team Room\n\n- `type`: must be `tfs`\n- `uri`: URI to the TFS Project Collection\n- `username`: username to authenticate with, configured with Alternate Credentials for Team Foundation Service\n- `password`: password to authenticate with\n- `room`: name of the room to monitor\n\n### Notification Configuration\n\nNotification configuration is specified as key/value pairs.  The\n`type` configuration is mandatory.  Other configuration values will be\npassed to the client.\n\nAny notification may have the following configuration specified,\nin addition to the notification-specific configuration:\n\n- `contains`: limits the notification to message that contain the given text\n\n#### Console Notification\n\n- `type`: must be `console`\n\n#### Growl Notification\n\n- `type`: must be `growl`\n\n#### SMS Notification\n\n- `type`: must be `sms`\n- `userid`: user information for the Catapult API\n- `api-token`: API token for authentication\n- `api-secret`: API secret for authentication\n- `from`: sender phone number (in international format)\n- `to`: recipient phone number (in international format)\n\n#### Example\n\n    {\n        \"poll_interval\": 5,\n        \n        \"clients\": [\n            {\n                \"type\": \"campfire\",\n                \"uri\": \"https://mycampfire.campfirenow.com/\",\n                \"api-token\": \"secret\",\n                \"room\": \"Discussion Room\"\n            },\n            \n            {\n                \"type\": \"tfs\",\n                \"uri\": \"https://mytfs.visualstudio.com/DefaultCollection\",\n                \"username\": \"alternate_credential_username\",\n                \"password\": \"alternate_credential_password\",\n                \"room\": \"My Team Room\"\n            },\n        ],\n        \n        \"notifications\": [\n            { \"type\": \"console\" },\n            { \"type\": \"growl\" },\n            {\n                \"type\": \"sms\",\n                \"contains\": \"urgent\",\n                \"userid\": \"userid\",\n                \"api-token\": \"token\",\n                \"api-secret\": \"secret\",\n                \"from\": \"+19195551212\",\n                \"to\": \"+13125558989\",\n            }\n        ]\n    }\n\nNotes\n-----\n\nThis is super beta and may not work for you.  There would be much\nwork to make this production-ready, which is not a high priority.\n\nSummoner *monitors* rooms, it does not *join* them.  It (you) will\nnot be visible in the room list.  This lends to your aura of mystery.\n\nLicense\n----\n\nMIT\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethomson%2Fsummoner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fethomson%2Fsummoner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fethomson%2Fsummoner/lists"}