{"id":15018269,"url":"https://github.com/cyclenerd/latrine","last_synced_at":"2025-10-03T22:30:35.186Z","repository":{"id":9787167,"uuid":"11761963","full_name":"Cyclenerd/Latrine","owner":"Cyclenerd","description":"📡 Locus Map GPS Live Tracking Server Script","archived":true,"fork":false,"pushed_at":"2016-11-06T14:41:24.000Z","size":12,"stargazers_count":14,"open_issues_count":0,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-09-29T19:01:24.695Z","etag":null,"topics":["location","locus-map","perl","perl-script","storage-location","tracking"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cyclenerd.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":"2013-07-30T09:54:47.000Z","updated_at":"2024-07-24T22:47:35.000Z","dependencies_parsed_at":"2022-08-25T21:40:17.818Z","dependency_job_id":null,"html_url":"https://github.com/Cyclenerd/Latrine","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/Cyclenerd%2FLatrine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyclenerd%2FLatrine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyclenerd%2FLatrine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cyclenerd%2FLatrine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cyclenerd","download_url":"https://codeload.github.com/Cyclenerd/Latrine/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235198389,"owners_count":18951498,"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","locus-map","perl","perl-script","storage-location","tracking"],"created_at":"2024-09-24T19:51:46.094Z","updated_at":"2025-10-03T22:30:34.864Z","avatar_url":"https://github.com/Cyclenerd.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"Latrine\n=======\n\n[Locus Map](http://www.locusmap.eu/) Android GPS live tracking server script\n\n![ScreenShot](http://i.imgur.com/0QjqnmD.jpg)\n\nLatrine is a minimalist GPS live tracking server script.\nIt is very easy to set up and requires no database.\nAll you need is a web server which can execute Perl scripts.\n\nMore information on the live tracking feature of Locus Map Pro can be found on its [documentation web page](http://docs.locusmap.eu/doku.php?id=manual:user_guide:functions:live_tracking#web_services).\n\n\nFeatures\n--------\n\n* Tracking: Server receives data from Android device with Locus Pro installed and live tracking enabled.\n* Live following: Data sent by Locus Pro is shown live on map.\n* Multiple map layers: Currently you can choose between OpenStreetMap, OpenCylceMap, Hike and Bike (with Hillshading) and ESRI\n* Multi-user: Authentication with key\n\n\nFunctions\n---------\n\nAuthentication is done with a key. Anyone who knows the key can see and update the GPS location.\nYour key must be at least 5 characters up to 15 characters `a-zA-Z0-9_`.\n\n### Update\n\n\thttp://\u003cSERVER\u003e/latrine.pl?key=\u003cKEY\u003e\u0026lat=\u003cLatitude\u003e\u0026lon=\u003cLongitude\u003e\u0026alt=\u003cAltitude\u003e\u0026speed=\u003cSpeed\u003e\u0026bearing=\u003cBearing\u003e\u0026acc=\u003cAccuracy\u003e\n\nExample:\n\n\thttp://localhost/cgi-bin/latrine.pl?key=OnMyBike\u0026lat=45.09\u0026lon=6.07\u0026acc=5\u0026speed=4.16666667\n\n### Get JSON\n\n\thttp://\u003cSERVER\u003e/latrine.pl?key=\u003cKEY\u003e\u0026view=1\n\nExample:\n\n\thttp://localhost/cgi-bin/latrine.pl?key=OnMyBike\u0026view=1\n\nReply:\n\n\t{\n\t  \"lat\": \"45.09\",\n\t  \"lon\": \"6.07\",\n\t  \"alt\": \"0\",\n\t  \"speed\": \"4.16666667\",\n\t  \"bearing\": \"0\",\n\t  \"acc\": \"5\",\n\t  \"time\": \"1375194859\",\n\t  \"now\": \"1375195150\"\n\t}\n\n\n### Show map\n\n\thttp://\u003cSERVER\u003e/latrine.html?#\u003cKEY\u003e\n\nExample:\n\n\thttp://localhost/latrine.html?#OnMyBike\n\n\n\nInstallation\n------------\n\n1.) Adjust the storage location `my $store = '/tmp/latrine/';` in `latrine.pl`.\n\n2.) Adjust the location (URL) to your Perl script `var perlScript = 'latrine.pl';` in `latrine.html`.\n\n3.) Upload `latrine.pl` and `latrine.html` onto your web server. The Perl script `latrine.pl` must be executable by the web server.\n\n4.) Configure Locus Map. Do not forget the key.\n\n![LocusMap](http://i.imgur.com/m9jxS1t.png)\n\n5.) Go out :+1: \n\n\nSample Configuration for Mac OS X\n---------------------------------\n\n* Web Sharing must be [enabled](http://support.apple.com/kb/HT3323)\n* Copy `latrine.html` to `/Library/WebServer/Documents/`\n* Copy `latrine.pl` to `/Library/WebServer/CGI-Executables/` and run `chmod +x latrine.pl`\n* Default storage location in `latrine.pl` is just fine\n* Adjust the location (URL) in `latrine.html` to `var perlScript = '/cgi-bin/latrine.pl';`\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyclenerd%2Flatrine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcyclenerd%2Flatrine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcyclenerd%2Flatrine/lists"}