{"id":33987259,"url":"https://github.com/zkillboard/redisq","last_synced_at":"2026-04-04T13:01:23.664Z","repository":{"id":34386780,"uuid":"38313560","full_name":"zKillboard/RedisQ","owner":"zKillboard","description":"A simple queue service for \"pushing\" killmails from zKillboard.","archived":false,"fork":false,"pushed_at":"2026-03-19T17:03:00.000Z","size":169,"stargazers_count":46,"open_issues_count":0,"forks_count":6,"subscribers_count":10,"default_branch":"master","last_synced_at":"2026-03-20T08:55:27.611Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://zkillredisq.stream/listen.php","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zKillboard.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2015-06-30T14:21:55.000Z","updated_at":"2026-03-19T17:03:04.000Z","dependencies_parsed_at":"2024-04-03T13:53:07.153Z","dependency_job_id":"ab1e24ab-a3c1-488e-adbf-65defa49950c","html_url":"https://github.com/zKillboard/RedisQ","commit_stats":{"total_commits":49,"total_committers":3,"mean_commits":"16.333333333333332","dds":"0.20408163265306123","last_synced_commit":"6f4b0c0dcb34b7f2d098dd6511470dc0446cdc9a"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zKillboard/RedisQ","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zKillboard%2FRedisQ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zKillboard%2FRedisQ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zKillboard%2FRedisQ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zKillboard%2FRedisQ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zKillboard","download_url":"https://codeload.github.com/zKillboard/RedisQ/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zKillboard%2FRedisQ/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31400460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"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":"2025-12-13T05:06:38.240Z","updated_at":"2026-04-04T13:01:23.658Z","avatar_url":"https://github.com/zKillboard.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [!IMPORTANT]\n\u003e # 🚨RedisQ will be sunsetted on May 31, 2026\nPlease see https://github.com/zKillboard/zKillboard/wiki/API-(R2Z2) for information on the replacement.\n\n===\n\n# RedisQ\n\nA simple queue service using Redis as the backend. All you have to do is point your code to https://zkillredisq.stream/listen.php. Then parse the JSON that you receive and do anything you like with it.\n\nIf no killmail has come in for 10 seconds, you'll receive a null package, example:\n{\"package\":null}\n\nThe server will remember your queueID for up to 3 hours, therefore, pauses in your code will not cause you to miss out on killmails.\n\n##### Do I need Redis to use this service?\n\nYou don't need Redis to use this service, its only called RedisQ because the service itself is powered by Redis.\n\n##### How do I identify myself?\n\nRedisQ will use the parameter queueID to identify you. This field is required! Example:\n\n    https://zkillredisq.stream/listen.php?queueID=Voltron9000\n\n##### How can I wait less than 10 seconds if there isn't a new killmail?\n\nBy default, RedisQ will wait up to 10 seconds for a new killmail to come in. To wait less than this 10 seconds, you can use the ttw parameter, which is short for timeToWait. Example:\n\n    https://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026ttw=1\n\nAnd yes, you can combine the ttw and queueID parameters. The code will enforce a minimum of 1 and a maximum of 10 seconds.\n\n##### Something changed with the way RedisQ works, help?\n\nAs of August, 2025, a change has been implemented such that the /listen.php endpoint redirects to /object.php with an objectID for your next package.  Be sure that whatever tool you are using can accommodate redirects.\n\n    https://zkillredisq.stream/object.php?objectID=NotRealObjectID\n\n#### Limitations\n\n- You may have one (1) request being handled at a time per queueID. Additional requests being served while another request is already polling will resolve with http code 429.\n- You may request at a limit of two (2) requests per second per IP address.  This limitations is enforced by CloudFlare – if you exceed this limitation your request will resolve with http code 429.\n\n#### FAQ\n\n###### So, this seems too easy. What do I have to do again?\n\nIt really is very, very simple. All you have to do is point something at https://zkillredisq.stream/listen.php, that can be curl, file_get_contents, wget, etc. etc. Here's an example of getting a killmail with PHP\n\n  ```\n  $raw = file_get_contents(\"https://zkillredisq.stream/listen.php?queueID=YourIdHere\");\n  $json = json_decode($raw, true);\n  $killmail = $json['package'];\n  ```\n  \nThat's it, really. You now have a killmail. Put that into a loop and you can keep feeding yourself all the killmails as zKillboard gets them.\n\n###### Can I have pauses between requests without missing any killmails?\n\nYes, RedisQ identifies you based on your queueID and will remember you for up to 3 hours. So you can setup cron jobs to run every minute, 5 minutes, 15 minutes, etc. and not worry about missing any of the killmails.\n\n###### Can I use more than one connection on RedisQ?\n\n(This sections is currently deprecated, perhaps only temporarily) \n\nOnly one connection at a time is allowed. If you try for more the extra connections will receive a http 429 error. Too many 429 errors will cause your IP and userid (if provided) to be temporarily banned for several hours.\n\n###### Can I subscribe to just my pilot's / character's / alliance's killmails?\n\nYes!  Use the filter parameter.  See the section below on RedisQ Filter Rules.\n\n\thttps://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026filter=alliance_id=434243723\n\nIf you pass an invalid filter then a 400 Invalid Request error is thrown.\n\n###### Can you just redirect me to the killmail on ESI?\n\nSure!  Use the esi paramter with value 'y' and a redirect straight to the killmail will be given instead.\n\n    https://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026esi=y\n\n###### Seriously? Why do this and not use websockets or something like that?\n\nWebsockets are great, sure, but I wanted to write something that was damn easy to implement in any language. RedisQ isn't trying to be fancy like websockets, it is only trying to disemminate killmails in a quick and very simple fashion.\n\n###### Why is it called RedisQ?\n\nBecause I used Redis to implement what I was trying to do, it's a queue type service, and so I went with the completely unoriginal name RedisQ.\n\n###### Why are you using .php extension when RedisQ isn't using PHP?\n\nThe initial version of RedisQ utilized PHP as the backend language of choice.  However, a subsequent rewrite is now using NodeJS.  To keep things simple and allow for great backwards compatibility the endpoints kept their .php extension.\n\n###### I thought the URL was redisq.zkillboard.com?\n\nThe URL was changed in May, 2025 to zkillredisq.stream.\n\n###### How do I say RedisQ?\n\nEveryone says it different, but I say it like red-is-q.  You can say it however you want though.\n\n# RedisQ Filter Rules\n\n## 1. Operators\n- `=` : equals  \n- `!=` : not equals  \n- `\u003c` : less than  \n- `\u003c=` : less than or equal  \n- `\u003e` : greater than  \n- `\u003e=` : greater than or equal  \n\n## 2. Chaining Rules\n- **AND** (`;`): all conditions must match  \n  - Example:  \n    ```\n    alliance_id=1234;damage_done\u003e=500\n    ```\n    → Matches only if both conditions are true.  \n\n- **OR** (`,`): at least one condition must match  \n  - Example:  \n    ```\n    alliance_id=1234,4321,5678\n    ```\n    → Matches if any of the listed conditions are true.  \n\n- **Important:** You cannot mix `;` and `,` in the same filter string.  \n\n## 3. Matching Behavior\n- Works on **any key** inside the RedisQ `package` object (deeply nested).  \n- If a key’s value is an **array**, all elements of the array are searched.  \n- Values are compared as **numbers** if both sides are numeric, otherwise as strings.  \n\n## 4. Examples\n- `https://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026filter=character_id=5678`  \n  → true if any `character_id` equals 5678  \n\n- `https://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026filter=damage_done\u003e=1000`  \n  → true if any `damage_done` is ≥ 1000  \n\n- `https://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026filter=alliance_id!=9999`  \n  → true if no matching `alliance_id` equals 9999  \n\n- `https://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026filter=alliance_id=1234;damage_done\u003e500`  \n  → both must match (AND)  \n\n- `https://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026filter=character_id=1111,character_id=2222`  \n  → matches if either character ID is found  \n\n- `https://zkillredisq.stream/listen.php?queueID=Voltron9000\u0026filter=labels=marked`  \n  → matches if any key `labels`, which could be a key or an array, equals or contains the value marked\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzkillboard%2Fredisq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzkillboard%2Fredisq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzkillboard%2Fredisq/lists"}