{"id":25658845,"url":"https://github.com/emberfox205/stalkinator","last_synced_at":"2026-06-18T17:31:24.675Z","repository":{"id":242549251,"uuid":"809859042","full_name":"emberfox205/stalkinator","owner":"emberfox205","description":"A Flask-based webapp to monitor positions using Arduino ","archived":false,"fork":false,"pushed_at":"2024-07-18T09:37:34.000Z","size":3210,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T13:48:19.085Z","etag":null,"topics":["flask-application","gps","iot-application","javascript","position-tracking","python3","sqlalchemy","sqlite3","webapp"],"latest_commit_sha":null,"homepage":"","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/emberfox205.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-03T15:27:54.000Z","updated_at":"2025-02-28T16:03:40.000Z","dependencies_parsed_at":"2024-06-21T22:32:44.293Z","dependency_job_id":"04ef9462-bf5f-4d10-9dea-854cf9bdc054","html_url":"https://github.com/emberfox205/stalkinator","commit_stats":null,"previous_names":["emberfox205/stalkinator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/emberfox205/stalkinator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberfox205%2Fstalkinator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberfox205%2Fstalkinator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberfox205%2Fstalkinator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberfox205%2Fstalkinator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emberfox205","download_url":"https://codeload.github.com/emberfox205/stalkinator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emberfox205%2Fstalkinator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34501472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"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":["flask-application","gps","iot-application","javascript","position-tracking","python3","sqlalchemy","sqlite3","webapp"],"created_at":"2025-02-24T00:29:11.383Z","updated_at":"2026-06-18T17:31:24.647Z","avatar_url":"https://github.com/emberfox205.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stalkinator\n\n![Static Badge](https://img.shields.io/badge/Python-3.12.0-blue?style=flat\u0026logo=Python\u0026logoColor=white)\n\nA Flask-based web application that tracks children's location to aid parental control using Arduino Cloud.\n\n[Github repository](https://github.com/emberfox205/stalkinator)\n\n## Setup\n\n### Server-side\n\nClone this repo:\n\n```bash\ngit clone git@github.com:emberfox205/stalkinator.git\n```\n\nInstall all the dependencies (preferably into a virtual environment):\n\n```bash\npip install -r requirements.txt\n```\n\nRegister an [Arduio Cloud](https://cloud.arduino.cc/) account and subscribe to at least the **Maker** tier.\n\nRegister for a [Geoapify](https://www.geoapify.com/) key (free of charge).\n\nIn your local repo, set up an `.env` file with the following structure:\n\n```bash\nCLIENT_ID=arduino_client_id\nCLIENT_SECRET=arduino_secret\nGEOAPIFY_API_KEY=\"geoapify_api_key\"\n```\n\nReplace `arduino_client_id`, `arduino_secret` and `geoapify_api_key` with actual data.\n\n\u003e [!NOTE]\n\u003e The Geoapify key must be quoted.\n\n[Optionally] Install [DB Browser for SQLite](https://sqlitebrowser.org/dl/) to manage the database with a GUI.\n\n### Client-side\n\nDownload mobile Arduino app for the tracked target:\n\n- [iOS AppStore](https://apps.apple.com/vn/app/arduino-iot-cloud-remote/id1514358431?l=vi)\n- [Android PlayStore](https://play.google.com/store/apps/details?id=cc.arduino.cloudiot\u0026hl=en)\n\nTurn the device into a Thing/Device and note the Thing ID to register on the web application.\n\n\u003e [!NOTE]\n\u003e When registering on the webpage, your email **matters** as emails informing whether the tracked target has left / entered safezone or entered dangerzone will be sent there. Check your spam in case you can not see them.\n\n## Initialization\n\nRun `app.py` for the application itself. Follow standard Flask procedures to open a localhost website. `app.py` can be run independently without Arduino data for demonstration purposes.\n\n```bash\npython app.py\n```\n\nRun `data_script.py` to interact with the Arduino Cloud API.\n\n```bash\npython data_script.py\n```\n\n\u003e [!WARNING]\n\u003e\n\u003e - Only the Billiards category in the Dangerzone tab is functional. Other options are for demonstration.\n\u003e - Options in the Settings tab are for demonstration purposes only. They are, for now, out of scope of the project.\n\n## Credits\n\n- [Arduino iot-api Python client](https://github.com/arduino/iot-client-pyhttps://github.com/arduino/iot-client-py)\n- [Geoapify Places API](https://www.geoapify.com/places-api/)\n- [GPS Tracking guide - Text](https://iot.microchip.com/docs/arduino/examples/GPS%20Tracker/Arduino%20Sketch)\n- [GPS Tracking guide - Video](https://www.youtube.com/watch?v=WYT7r62AEYo\u0026t=6s)\n- [Icons](https://www.flaticon.com/)\n- [Leafletjs](https://leafletjs.com/)\n- [Map display](https://www.openstreetmap.org/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femberfox205%2Fstalkinator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femberfox205%2Fstalkinator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femberfox205%2Fstalkinator/lists"}