{"id":15920930,"url":"https://github.com/halcy/notificat","last_synced_at":"2025-03-16T04:44:10.901Z","repository":{"id":66710796,"uuid":"136535496","full_name":"halcy/notificat","owner":"halcy","description":"Prints Mastodon WebPush notifications to your terminal","archived":false,"fork":false,"pushed_at":"2018-06-08T22:46:21.000Z","size":96,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-22T17:25:50.315Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/halcy.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":"2018-06-07T21:56:50.000Z","updated_at":"2019-01-07T09:57:35.000Z","dependencies_parsed_at":null,"dependency_job_id":"d7f4dea2-e9d2-4963-aa6b-ee9d876e75cd","html_url":"https://github.com/halcy/notificat","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halcy%2Fnotificat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halcy%2Fnotificat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halcy%2Fnotificat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/halcy%2Fnotificat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/halcy","download_url":"https://codeload.github.com/halcy/notificat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243826778,"owners_count":20354220,"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":[],"created_at":"2024-10-06T19:42:19.407Z","updated_at":"2025-03-16T04:44:10.881Z","avatar_url":"https://github.com/halcy.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# notificat.py\n\nPrints Mastodon WebPush notifications to your terminal.\n\n**To install:**\n\u003cpre\u003e\ngit clone\ncd notificat\npip3 install -r requirements.txt\n\u003c/pre\u003e\n\n**Usage:**\n\u003cpre\u003e\nusage: notificat.py [-h] [-f] [-j] [-s] [-w WSS_URL] [-a AUTOPUSH_CRED_FILE]\n                    [-p PORT] [-d HOSTNAME] [-c CERTBOT_EXECUTABLE]\n                    [-l LETSENCRYPT_PATH]\n                    instance cred_file\n\nPrints Mastodon WebPush notifications to the terminal, either via Mozilla\nAutopush (default, recommended) or by directly providing its own WebPush\nendpoint (complex and very impractical.)\n\npositional arguments:\n  instance              Base URL for the instance you want to get\n                        notifications from.\n  cred_file             Login credentials file name. Will be created if it\n                        does not exist. This file is not encrypted and will\n                        allow people to access your mastodon account. Keep it\n                        safe.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -f, --fancy           Use colours and unicode glyphs in output.\n  -j, --json            Output notifications as JSON.\n  -s, --all-scopes      When logging in, create an access token that is\n                        allowed full access instead of a push notification\n                        only token.\n  -w WSS_URL, --wss-url WSS_URL\n                        (autopush mode) Websocket URL for autopush. Default:\n                        ''wss://push.services.mozilla.com/'\n  -a AUTOPUSH_CRED_FILE, --autopush-cred-file AUTOPUSH_CRED_FILE\n                        (autopush mode) Autopush credential cache file name.\n                        Default: 'autopush_sub.pkl'\n  -p PORT, --port PORT  (direct mode) Port to listen on. Default: 80\n  -d HOSTNAME, --direct HOSTNAME\n                        Use direct WebPush mode instead of Mozilla Autopush,\n                        with specified host name.\n  -c CERTBOT_EXECUTABLE, --certbot-executable CERTBOT_EXECUTABLE\n                        (direct mode) Certbot command. Default: 'certbot-auto'\n  -l LETSENCRYPT_PATH, --letsencrypt-path LETSENCRYPT_PATH\n                        (direct mode) Certbot certificate path. Default:\n                        '/etc/letsencrypt/live/'\n\nFor normal client usage, it is strongly recommended that you use Mozilla\nAutopush. The direct mode requires your machine to have a globally resolvable\nhostname and to be reachable via at least port 80. You also need to have\ncertbot-auto installed and configured correctly. For autopush operation,\nnothing is required - it should just work.\n\u003c/pre\u003e\n\n**Screenshot:**\n\n![notificat screenshot](screenshot.png?raw=true \"Optional Title\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhalcy%2Fnotificat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhalcy%2Fnotificat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhalcy%2Fnotificat/lists"}