{"id":16541813,"url":"https://github.com/damianmoore/skylark-server","last_synced_at":"2025-09-04T04:47:01.066Z","repository":{"id":49699329,"uuid":"96367316","full_name":"damianmoore/skylark-server","owner":"damianmoore","description":"Get notifications on your phone that are easily sent via HTTP requests","archived":false,"fork":false,"pushed_at":"2022-12-08T05:46:01.000Z","size":53,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-04T05:45:08.420Z","etag":null,"topics":["notification","notification-android","notification-api","notification-app","notification-center","notification-server","notification-service","notifications"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/damianmoore.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":"2017-07-05T22:50:14.000Z","updated_at":"2023-07-29T06:47:40.000Z","dependencies_parsed_at":"2023-01-24T14:31:03.857Z","dependency_job_id":null,"html_url":"https://github.com/damianmoore/skylark-server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/damianmoore/skylark-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damianmoore%2Fskylark-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damianmoore%2Fskylark-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damianmoore%2Fskylark-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damianmoore%2Fskylark-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/damianmoore","download_url":"https://codeload.github.com/damianmoore/skylark-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/damianmoore%2Fskylark-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273554289,"owners_count":25126312,"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","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"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":["notification","notification-android","notification-api","notification-app","notification-center","notification-server","notification-service","notifications"],"created_at":"2024-10-11T18:55:57.216Z","updated_at":"2025-09-04T04:47:01.046Z","avatar_url":"https://github.com/damianmoore.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Skylark\n\n\u003cimg src=\"https://epixstudios.co.uk/filer/canonical/1532270627/2/\" alt=\"Skylark Logo\" width=\"196px\" height=\"170px\"\u003e\n\n*Easily send notifications to your phone via HTTP*\n\n\n## Running the server\n\n### Docker\n\nDocker compose is the quickest way to get the server up and running. This will launch the server on [http://localhost:8000](http://localhost:8000).\n\n```shell\ndocker run -p 8000:80 damianmoore/skylark-server:latest\n```\n\n### Checkout Python\n\nIf you want to help contribute or just want to avoid Docker then you can clone the repo, make a virtual environment, install requirements and run the Django runserver. It will be listening on [http://localhost:8000](http://localhost:8000).\n\n```shell\ngit clone https://github.com/damianmoore/skylark-server.git\npipenv install\npipenv shell\n./manage.py runserver\n```\n\n\n## Download and register the app\n\nThe latest Android release is available to download from [Google Play Store](https://play.google.com/store/apps/details?id=uk.co.epixstudios.skylark).\n\n\u003ca href='https://play.google.com/store/apps/details?id=uk.co.epixstudios.skylark\u0026pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'\u003e\u003cimg alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' height=\"64px\"/\u003e\u003c/a\u003e\n\nYou are welcome to clone and build the [Android app project](https://github.com/damianmoore/skylark-android) for yourself.\n\nOnce you have the app installed you will need to connect it to the address of an instance of the server you have running (see above).\n\nHelp would be much appreciated if you have iOS experience. We also aim to have a desktop, browser-based notification implementation.\n\n\n## Sending notifications\n\nNotification can be sent via HTTP POST or GET with data transported as JSON, POST data or URL encoding. Here are a couple of examples.\n\n### Python (requests library)\n\n```python\nimport requests\nrequests.post('http://localhost:8000/webhook/', params={\n    'title': 'Notification from Python',\n    'body': 'Sent with the requests library',\n    'color': '#3776ab',\n    'icon': 'https://www.python.org/static/opengraph-icon-200x200.png',\n})\n```\n\n### cURL\n\n```shell\ncurl -X POST \\\n-H \"Content-Type: application/json\" \\\n-d '{\"title\": \"Notification from cURL\", \"body\": \"Hello, World!\", \"color\": \"#ff9500\", \"icon\": \"http://i.imgur.com/7Ih60Gu.png\"}' \\\nhttp://localhost:8000/webhook/\n```\n\n\u003cimg src=\"https://epixstudios.co.uk/filer/canonical/1532292660/3/\" alt=\"Screenshot of Python notification\" width=50% /\u003e\u003cimg src=\"https://epixstudios.co.uk/filer/canonical/1532292660/4/\" alt=\"Screenshot of cURL notification\" width=50% /\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdamianmoore%2Fskylark-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdamianmoore%2Fskylark-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdamianmoore%2Fskylark-server/lists"}