{"id":21244327,"url":"https://github.com/turquoisespace/notification-box","last_synced_at":"2026-04-19T10:33:04.204Z","repository":{"id":136988963,"uuid":"374588124","full_name":"TurquoiseSpace/notification-box","owner":"TurquoiseSpace","description":"Android app to send personalized push notifications, using GCP","archived":false,"fork":false,"pushed_at":"2023-06-18T08:18:21.000Z","size":11420,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-15T04:26:48.374Z","etag":null,"topics":["android","api","apk","curl","gcp","postman","push-notifications"],"latest_commit_sha":null,"homepage":"","language":"Java","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/TurquoiseSpace.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-07T08:18:31.000Z","updated_at":"2023-06-18T08:18:26.000Z","dependencies_parsed_at":null,"dependency_job_id":"835e4f1a-a03d-4d92-a278-a84731743c78","html_url":"https://github.com/TurquoiseSpace/notification-box","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/TurquoiseSpace/notification-box","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TurquoiseSpace%2Fnotification-box","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TurquoiseSpace%2Fnotification-box/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TurquoiseSpace%2Fnotification-box/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TurquoiseSpace%2Fnotification-box/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TurquoiseSpace","download_url":"https://codeload.github.com/TurquoiseSpace/notification-box/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TurquoiseSpace%2Fnotification-box/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32004036,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["android","api","apk","curl","gcp","postman","push-notifications"],"created_at":"2024-11-21T01:22:27.800Z","updated_at":"2026-04-19T10:33:04.154Z","avatar_url":"https://github.com/TurquoiseSpace.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n# Notification Box #\n\n![Visit Count](https://profile-counter.glitch.me/TurquoiseSpace_notification-box/count.svg)\n\n\n## Description ##\n\n`notification-box` is available for android, and published exclusively on github\n\nsend custom push notifications to yourself\n\ncan be used to send and receive `push notfications` of events / appointments / reminders / alerts,\nor for any other purpose you can think of\n\n\n## Releases ##\n\n* Stable\n\n[notification-box-0.0.3](https://github.com/TurquoiseSpace/notification-box/releases/download/0.0.3/notification-box-0.0.3.apk)\n\n* Tag / Tree\n\n[0.0.3](https://github.com/TurquoiseSpace/notification-box/tree/3ee8745ecdce381bc0b3ec68f57d79e4927ada21)\n\n\n## Repository ##\n\n* Browse\n\nhttps://github.com/TurquoiseSpace/notification-box\n\n* Download ZIP\n\nhttps://github.com/TurquoiseSpace/notification-box/archive/refs/heads/master.zip\n\n\n## Clone ##\n\n* HTTPS\n\n\t```git clone https://github.com/TurquoiseSpace/notification-box.git```\n\n* SSH\n\n\t```git clone git@github.com:TurquoiseSpace/notification-box.git```\n\n* GitHub CLI\n\n\t```gh repo clone TurquoiseSpace/notification-box```\n\n\n## Usage Instructions ##\n\n\n#### Notification Box - Android App - Initial / One Time Setup ####\n\n1) download the apk,\ndirectly onto your mobile device,\nor,\nonto your laptop / desktop, then copy it onto your mobile device \n\n2) in your android mobile device, go to settings and enable `allow installing apps from external sources`\n\n3) install the apk, in your mobile device\n\n\u003cimg src=\"https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot_2021-07-05-14-24-42-73.jpg\" alt=\"Notification Box - Android - App Icon\" width=\"30%\" height=\"30%\"\u003e\n\n4) open the app with name `Firebase Cloud Messaging`, having a green Android bot icon\n\n\u003cimg src=\"https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot_2021-07-05-14-24-46-61.jpg\" alt=\"Notification Box - Android - App Home / Main Screen\" width=\"30%\" height=\"30%\"\u003e\n\n5) click on the \"LOG TOKEN\" button,\nit will generate the `FCM Registration Token`,\nthis is a client specific token, which would be used to send the push notifications to this particular android device client app,\nand is supposed to look something like this\n\n\t```cuo0-PvyQkO-lL5XsqHDAk:APA91bEmCznZGGnD-huqBrbNBhzyzUgkvMyFQoVJSDf4zYbuUGrghUT0DMSz3eVV2I7tINGJWw88qqS3Mx0rGVzVnRQpqqKbDqKvmEnN9z3aSRPUK4f1JTNoZ7JZ2rA_AFTCSjUhmRhn```\n\nindeed it will, be different / unique for you\n\n\u003cimg src=\"https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot_2021-07-05-14-24-49-32.jpg\" alt=\"Notification Box - Android - Log / Generate Token\" width=\"30%\" height=\"30%\"\u003e\n\n6) click on the \"COPY TOKEN\" button\n\n\u003cimg src=\"https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot_2021-07-05-14-24-51-68.jpg\" alt=\"Notification Box - Android - Copy Token\" width=\"30%\" height=\"30%\"\u003e\n\n7) from your mobile, open an email client whichever you use, like gmail or any other email service, in app or browser,\nand send yourself this token, on email,\nso you can access / use it later, from your laptop or desktop\n\n\u003cimg src=\"https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot_2021-07-05-14-25-45-83.jpg\" alt=\"Gmail - Android - Compose / Send Email\" width=\"30%\" height=\"30%\"\u003e\n\n\n#### Sending Push Notification - Postman ####\n\n1) on your desktop or laptop, open your email, in which you had shared your `FCM Registration Token`,\nand copy that token\n\n![Gmail - Web Browser](https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot%20from%202021-07-05%2016-06-19.png)\n\n2) open Postman, and paste this FCM registration token in the `raw` `JSON` Request Body, as the value of `to` attribute,\nthe request body would look something like this\n\n\t```\n\t{\n\t\t\"to\" : \"cuo0-PvyQkO-lL5XsqHDAk:APA91bEmCznZGGnD-huqBrbNBhzyzUgkvMyFQoVJSDf4zYbuUGrghUT0DMSz3eVV2I7tINGJWw88qqS3Mx0rGVzVnRQpqqKbDqKvmEnN9z3aSRPUK4f1JTNoZ7JZ2rA_AFTCSjUhmRhn\",\n\t\t\"data\" : {\n\t\t\t\"title\" : \"testing\",\n\t\t\t\"message\" : \"Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.\",\n\t\t\t\"json_key\" : \"json_value\",\n\t\t\t\"array\" : [\n\t\t\t\t\"hola\",\n\t\t\t\t\"amigos\",\n\t\t\t\t\"and\",\n\t\t\t\t\"senoritas\"\n\t\t\t],\n\t\t\t\"object\" : {\n\t\t\t\t\"inner_json_key\" : \"inner_json_value\"\n\t\t\t}\n\t\t}\n\t}\n\t```\n\n![Postman - Client - Request Body](https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot%20from%202021-07-05%2017-16-53.png)\n\n3) in the request url, copy paste the below\n\n\t```https://fcm.googleapis.com/fcm/send```\n\n4) set the HTTP Method as\n\n\t```POST```\n\n5) in the Request Headers, copy paste the following header\n\n\t```Authorization:key=AAAAucpu21Y:APA91bEYxJ6XGquZzAxqJnyUYeSwi7ocOWO4iJwi676vXnRXrDn-TazsJmESzQHHv5Dx2OO3HFOk5moxzpvEPCMCv3UA5ZopDnVFBK6lOeE1qWQugDVabmN229DAXd3G7tdul7mmlYpF```\n\n![Postman - Client - Request Header - Key Value Pair](https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot%20from%202021-07-05%2017-21-28.png)\n\nwhere the header name is `Authorization` and the header value is `key=AAAAucpu21Y:APA91bEYxJ6XGquZzAxqJnyUYeSwi7ocOWO4iJwi676vXnRXrDn-TazsJmESzQHHv5Dx2OO3HFOk5moxzpvEPCMCv3UA5ZopDnVFBK6lOeE1qWQugDVabmN229DAXd3G7tdul7mmlYpF`\n\nthe value of this header contains the `API Access Key` of this project which is registered with the `Google Cloud Platform`\n\n![Postman - Client - Request Header - Bulk Edit](https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot%20from%202021-07-05%2017-21-52.png)\n\n6) click on `Send` button,\ncheck the response status, must be `200 OK`,\nalso check the response body for `success` count as `1`\n\n![Postman - Client - Response Status and Body](https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot%20from%202021-07-05%2017-23-57.png)\n\n7) Voila !\nYou should have received the Push Notification in your Android Client\n\n\n#### Receiving Push Notification - Notification Box - Android App ####\n\n1) actual push notification\n\n\u003cimg src=\"https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot_2021-07-05-17-33-20-73.jpg\" alt=\"Notification Box - Android - Push Notification\" width=\"30%\" height=\"30%\"\u003e\n\n2) view the current and all the pervious push notifications, which are persisted, from the android client database,\nby clicking on a push notification which has arrived,\nor,\nby clicking on the bell icon on the home / main screen of the `notification-box` app\n\n\u003cimg src=\"https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot_2021-07-05-17-33-28-31.jpg\" alt=\"Notification Box - Android - Current and Previous Notifications\" width=\"30%\" height=\"30%\"\u003e\n\nwhen no push notifications are persent in the app database client\n\n\u003cimg src=\"https://github.com/TurquoiseSpace/notification-box/blob/master/assets/apk-0.0.3/Screenshot_2021-07-05-14-24-56-64.jpg\" alt=\"Notification Box - Android - No Previous Notifications\" width=\"30%\" height=\"30%\"\u003e\n\n\n## Reference Links ##\n\nhttps://console.cloud.google.com/\n\nhttps://guides.github.com/features/mastering-markdown/\n\n\n## Git Commands ##\n\n* List All Tags (Local)\n\n\t```git show-ref --tags```\n\n* List All Tags (Remote)\n\n\t```git ls-remote --tags origin```\n\n* Delete Tag (Local)\n\n\t```git tag -d \u003cactual_tag\u003e```\n\n\t```git tag -d 0.0.9```\n\n* Delete Tag (Remote)\n\n\t```git push origin :\u003cactual_tag\u003e```\n\n\t```git push origin :0.0.9```\n\n* Create Tag (Local)\n\n\t```git tag \u003cactual_tag\u003e```\n\n\t```git tag 0.0.9```\n\n* Create Tag (Remote)\n\n\t```git push origin \u003cactual_tag\u003e```\n\n\t```git push origin 0.0.9```\n\n\n## Contact Info ##\n\nnotification-box@googlegroups.com\n\nFeel free to drop us an email\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturquoisespace%2Fnotification-box","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fturquoisespace%2Fnotification-box","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturquoisespace%2Fnotification-box/lists"}