{"id":14036768,"url":"https://github.com/berrnd/locory","last_synced_at":"2025-04-19T13:24:29.390Z","repository":{"id":71289236,"uuid":"73564431","full_name":"berrnd/locory","owner":"berrnd","description":"A private / self-hosted location history solution","archived":false,"fork":false,"pushed_at":"2023-04-14T13:19:59.000Z","size":3639,"stargazers_count":61,"open_issues_count":1,"forks_count":5,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-08-13T03:05:32.453Z","etag":null,"topics":["location-history","ownyourdata","php","self-hosted"],"latest_commit_sha":null,"homepage":"https://locory-demo.berrnd.xyz","language":"PHP","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/berrnd.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}},"created_at":"2016-11-12T16:33:23.000Z","updated_at":"2024-07-13T12:54:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"cb7b914a-e63e-44be-b26c-027fef1de47c","html_url":"https://github.com/berrnd/locory","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berrnd%2Flocory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berrnd%2Flocory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berrnd%2Flocory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/berrnd%2Flocory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/berrnd","download_url":"https://codeload.github.com/berrnd/locory/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224957025,"owners_count":17398360,"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":["location-history","ownyourdata","php","self-hosted"],"created_at":"2024-08-12T03:02:13.137Z","updated_at":"2024-11-16T18:29:46.918Z","avatar_url":"https://github.com/berrnd.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"# locory\r\nA private / self-hosted location history solution\r\n\r\n## Motivation\r\nI love to have a location history, but because such data is too private to let this do others for you, I searched for a self hosted solution, found nothing that fitted my needs completely, so this is locory.\r\n\r\n# Give it a try\r\nPublic demo of the latest version \u0026rarr; [https://locory-demo.berrnd.xyz](https://locory-demo.berrnd.xyz)\r\n\r\n## How to install\r\nJust unpack the [latest release](https://github.com/berrnd/locory/releases/latest) on your PHP enabled webserver, copy `config-dist.php` to `data/config.php`, edit it to your needs, create the new database on the server you configured, ensure that the `data` directory is writable and you're ready to go. Alternatively clone this repository and install composer dependencies manually.\r\n\r\nIf you use nginx as your webserver, please include `try_files $uri /index.php;` in your location block.\r\n\r\n## What currently is possible\r\n- It provides an API to save location data\r\n- It gives you a simple web interface to show your location history in custom time ranges, calculates the (linear) distance, and so on\r\n\r\n### Get data in\r\nMake a POST to `https://locory/api/add/csv`, the body has to be one or multiple lines in the format `\u003cparseable timestamp (ISO is good)\u003e,\u003clatitude\u003e,\u003clongitude\u003e,\u003caccuracy (integer, in meters)\u003e`.\r\nI personally do this with [Automagic](https://play.google.com/store/apps/details?id=ch.gridvision.ppam.androidautomagic) on my smartphone.\r\n\r\n### Calculate distance between location points\r\nThis can be a long running task, so this is not done at the time of import - just setup a cron job for example every hour.\r\n\r\n`*/60 * * * * www-data php /\u003clocory\u003e/index.php /cli/calculate/distance GET`\r\n\r\n### Show your location history\r\nJust browse to the your install URL and login with the configured credentials\r\n\r\n## Screenshots\r\n![Main page](https://github.com/berrnd/locory/raw/master/publication_assets/mainpage.png \"Main page\")\r\n\r\n## Todo\r\nThe analysis features are very basic for now, there are much more great things, heatmaps, \"where spent I most of my time\", and so on...\r\n\r\n## License\r\nThe MIT License (MIT)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberrnd%2Flocory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fberrnd%2Flocory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fberrnd%2Flocory/lists"}