{"id":16334399,"url":"https://github.com/cmacrae/xur-notify","last_synced_at":"2025-08-25T16:04:30.114Z","repository":{"id":57599346,"uuid":"76663240","full_name":"cmacrae/xur-notify","owner":"cmacrae","description":"Push notifications for Xûr's inventory","archived":false,"fork":false,"pushed_at":"2017-05-05T21:37:02.000Z","size":25,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-12-26T16:42:50.437Z","etag":null,"topics":["bungie","destiny","notifications","push-notifications","pushover","schedule"],"latest_commit_sha":null,"homepage":"https://github.com/cmacrae/xur-notify","language":"Go","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/cmacrae.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":"2016-12-16T15:17:25.000Z","updated_at":"2020-06-20T00:12:05.000Z","dependencies_parsed_at":"2022-09-26T19:53:11.868Z","dependency_job_id":null,"html_url":"https://github.com/cmacrae/xur-notify","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/cmacrae%2Fxur-notify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmacrae%2Fxur-notify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmacrae%2Fxur-notify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmacrae%2Fxur-notify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cmacrae","download_url":"https://codeload.github.com/cmacrae/xur-notify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239321400,"owners_count":19619697,"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":["bungie","destiny","notifications","push-notifications","pushover","schedule"],"created_at":"2024-10-10T23:38:18.256Z","updated_at":"2025-02-17T16:18:54.096Z","avatar_url":"https://github.com/cmacrae.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Go Report Card](https://goreportcard.com/badge/github.com/cmacrae/xur-notify)](https://goreportcard.com/report/github.com/cmacrae/xur-notify) [![Build Status](https://travis-ci.org/cmacrae/xur-notify.svg?branch=master)](https://travis-ci.org/cmacrae/xur-notify) [![license](http://img.shields.io/badge/license-MIT-red.svg?style=flat)](LICENSE)\n# xur-notify\nPush notifications for Xûr's inventory\n\n## About\nXûr is the mysterious traveling salesman in [Bungie](https://bungie.net)'s game [Destiny](https://www.destinythegame.com/uk/en/home). Each weekend he visits, he brings with him exotic items which he puts up for sale for Guardians.  \n\n`xur-notify` is a little utility, intended to be run on schedule, to instantly notify Guardian's of Xûr's arrival and the particular gifts he bears.\n\nCurrently, the following notification methods are supported:  \n- Push notifications, with the excellent [Pushover](https://pushover.net)  \n_Note: plans for other notification methods are emerging_\n\n## What's in the notification\nRight now, the notification simply sends a list of the exotic armour/weapons on sale.  \nIn future versions, more detailed information will be provided, such as stat-roll and quality.\n\n## Preview\nLockscreen                 |  Pushover\n:-------------------------:|:-------------------------:\n![](http://i.imgur.com/j1YJwSN.png)  |  ![](http://i.imgur.com/l6dbZq4.png)\n\n## Usage\n[**Subscribe via Pushover**](https://pushover.net/subscribe/Xr-mwxq4o1v35qs8er) to receive notifications from `xur-notify` at 10:00AM UTC every Friday!  \n\n_Warning: This is an experimental implementation - due to potential influx in users, please bear with me in this initial release. I'm personally hosting the infrastructure triggering the notifications, so there may be some unforeseen problems in early usage_\n\n### Running your own instance of xur-notify\nI have Open Source software and the brilliant community behind it to thank for so much in my life, I'd like to stay true to my roots.  \nSo, if you'd rather just run your own `xur-notify`, feel free!  \n\nIn this current implementation, `xur-notify` requires the following environment variables:  \n- `BNET_API_KEY` - can be obtained from [bungie.net](https://www.bungie.net/en/Application)\n- `PUSHOVER_TOKEN` - use your own application token, from [pushover.net](https://pushover.net)\n- `PUSHOVER_RECIPIENT_KEY` - use your user/group token, from [pushover.net](https://pushover.net)\n- `TIMEZONE` - specify your timezone, defaults to `Europe/London` if unset (use tz database zone format)\n\n#### Docker\nA [Docker image (`cmacrae/xur-notify`)](https://hub.docker.com/r/cmacrae/xur-notify/) is available, and should be run like so:\n``` bash\ndocker run --name xur-notify -d -e PUSHOVER_TOKEN=$PUSHOVER_TOKEN -e PUSHOVER_RECIPIENT_KEY=$PUSHOVER_RECIPIENT_KEY -e BNET_API_KEY=$BNET_API_KEY cmacrae/xur-notify:1.0.0-alpha\n```\n_Note: the relevant environment variables would need to be set in order for this to work_\n\nThis Docker image simply uses `cron` to execute `xur-notify` at 10:00 AM UTC (Xûr's arrival time).  \nIf you'd like to alter this to suit your schedule, you can build your own Docker image changing the following line to your own time in `cron` format:  \n``` cron\nRUN echo -e \"0\\t10\\t*\\t*\\t5\\t/bin/xur-notify \u0026\u003e /dev/stdout\" \u003e /etc/crontabs/root\n```\n\n#### Binary\nOr, simply head over to [the releases page](https://github.com/cmacrae/xur-notify/releases) and grab the latest binary for your platform, set your environment variables, and run it!  \nYou'll probably want to have this execute on a schedule, so you get seemless notifications when Xûr arrives.\n\n## Licensing\nSee the [LICENSE](LICENSE) file\n\n## Credit\n- @gregdel: [for making Pushover integration so slick](https://github.com/gregdel/pushover)\n- @jmoiron: [for easing handling of json structures](https://github.com/jmoiron/jsonq)\n- The awesome people at [superblock](https://superblock.net/contact/) for [Pushover](https://pushover.net)!\n- [Allyn H](http://allynh.com/blog/) for his series of blog posts that inspired me to write `xur-notify`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmacrae%2Fxur-notify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmacrae%2Fxur-notify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmacrae%2Fxur-notify/lists"}