{"id":44259154,"url":"https://github.com/rikmueller/whatsaround","last_synced_at":"2026-02-10T16:42:02.688Z","repository":{"id":333252302,"uuid":"1136456452","full_name":"rikmueller/whatsaround","owner":"rikmueller","description":"Discover places around your route or location","archived":false,"fork":false,"pushed_at":"2026-02-03T15:56:03.000Z","size":276,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-04T04:36:16.127Z","etag":null,"topics":["folium","gpx","leaflet","map","osm","overpass-api"],"latest_commit_sha":null,"homepage":"https://getwhatsaround.app","language":"TypeScript","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/rikmueller.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-17T18:12:08.000Z","updated_at":"2026-02-03T14:49:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/rikmueller/whatsaround","commit_stats":null,"previous_names":["rikmueller/osm_finder","rikmueller/whats-along-my-track","rikmueller/along-gpx","rikmueller/whatsaround"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/rikmueller/whatsaround","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rikmueller%2Fwhatsaround","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rikmueller%2Fwhatsaround/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rikmueller%2Fwhatsaround/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rikmueller%2Fwhatsaround/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rikmueller","download_url":"https://codeload.github.com/rikmueller/whatsaround/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rikmueller%2Fwhatsaround/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29307926,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T16:09:25.305Z","status":"ssl_error","status_checked_at":"2026-02-10T16:08:52.170Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["folium","gpx","leaflet","map","osm","overpass-api"],"created_at":"2026-02-10T16:42:01.967Z","updated_at":"2026-02-10T16:42:02.683Z","avatar_url":"https://github.com/rikmueller.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WhatsAround\n\n**Find OpenStreetMap POIs along your GPX tracks. Plan smarter: campsites, water sources, shelters, restaurants—everything you need along your route.**\n\n**🌐 Try it online: [getwhatsaround.app](https://getwhatsaround.app)**\n\n---\n\n## 1. How to Use 💡\n\n### 1.1 Upload Your GPX Track\n\n- Drag and drop your `.gpx` file onto the map\n- Your track appears instantly (blue line with start/end markers)\n- Map automatically centers on your route\n\n### 1.2 Choose What to Find\n\n**Quick presets:**\n- 🏕️ Campsites\n- 💧 Drinking water\n- 🏠 Accommodation (hotels, hostels, B\u0026Bs)\n- 🍴 Food \u0026 restaurants\n- 🏪 Shops \u0026 supermarkets\n- 🚽 Public toilets\n- ⛺ Shelters\n\n**Custom filters:**\nBuild your own using OpenStreetMap tags (e.g., `amenity=restaurant`, `shop=bicycle`)\n\n### 1.3 Generate Results\n\n- Set your search radius (1-50 km from track)\n- Click **Search**\n\n### 1.4 Explore Results\n\n- **Interactive map** - Click markers for details (name, distance, website, hours)\n- **Excel export** - Sorted by distance from start, with all metadata\n- **Multiple tile layers** - OpenStreetMap, OpenTopoMap, CyclOSM\n- **Mobile-friendly** - Works on phones and tablets\n\n---\n\n## 2. Project Design \u0026 Architecture\n\n### 2.1 Project Structure 🏗️ \n\n```\nWhatsAround/\n├── backend/              # Python backend\n│   ├── api/             # Flask REST API\n│   └── core/            # Processing pipeline (GPX, Overpass, filtering)\n├── cli/                 # Command-line interface\n├── frontend/            # React + TypeScript web UI\n│   └── src/\n│       ├── components/  # UI components (Map, Settings, Modals)\n│       └── hooks/       # WebSocket integration\n├── config/              # Configuration by usage mode\n│   ├── cli/            # CLI standalone\n│   ├── local-dev/      # Local development\n│   ├── docker-dev/     # Docker with hot reload\n│   └── docker-prod/    # Production Docker\n├── deployment/          # Docker build files\n└── data/\n    ├── presets.yaml    # Filter presets\n    ├── input/          # GPX files\n    └── output/         # Generated results\n```\n\n### 2.2 Key Technologies\n\n**Backend:**\n- Python 3.x with Flask for REST API\n- pandas + openpyxl for Excel export\n- Folium for map generation\n- pyproj for geodesic calculations\n- Overpass API for OSM queries\n\n**Frontend:**\n- React 18 + TypeScript\n- Vite for fast development\n- Leaflet + React-Leaflet for interactive maps\n- Socket.IO for real-time updates\n- Axios for API communication\n\n**Infrastructure:**\n- Docker Compose for containerization\n- Nginx for production reverse proxy\n\n\n### 2.3 Key Features ✨ \n\n- **🗺️ Map-first interface** - See your track and POIs continuously\n- **⚡ Real-time updates** - POIs appear as they're found\n- **📱 Mobile responsive** - Collapsible settings, touch-friendly\n- **🎨 Smart coloring** - Different colors for different POI types\n- **🎯 Accurate distances** - WGS84 geodesic calculations\n- **📦 Self-contained** - Runs offline after setup (uses public Overpass API)\n\n\n### 2.4 Frontend Architecture\nsee **[FRONTEND.md](FRONTEND.md)** \n\n\n### 2.5 Configuration ⚙️\n\nWhatsAround is configured via environment variables. See respective configuration directories for available options.\n\n**Filter presets** are defined in [data/presets.yaml](data/presets.yaml). Add your own!\n\n---\n\n## 3.  Getting Started on your machine 🚀\n\nYou don't want to use getwhatsaround.app, but rather your own setup?\nWhatsAround offers **four ways to run** the application on your machine, depending on your needs.\n\nTo start, clone the repository:\n```bash\ngit clone https://github.com/rikmueller/whatsaround.git\n```\nAnd decide on a flavor:\n\n### 3.1 Command-Line Interface ⌨️\n\nFor batch processing and automation: [config/cli/README.md](config/cli/README.md)\n\n### 3.2 Local Development 💻\n\nRun backend and frontend locally for development: [config/local-dev/README.md](config/local-dev/README.md)\n\n### 3.3 Docker Development (Dev-Setup with hot reload) 🐳 \n\nDevelopment environment with hot reload: [config/docker-dev/README.md](config/docker-dev/README.md)\n\n### 3.4 Docker Production 🌐\n\nProduction environment: [config/docker-prod/README.md](config/docker-prod/README.md)\n\n---\n\n## 4. Everything else\n\n### 4.1 Contributing 🤝 \n\nContributions welcome! Please open an issue first to discuss major changes.\n\n---\n\n### 4.2 License 📜\n\nMIT License - see [LICENSE](LICENSE) for details\n\n---\n\n### 4.3 Credits 🙏\n\nBuilt with amazing open-source projects:\n\n- **[OpenStreetMap](https://www.openstreetmap.org/)** - Community-driven map data\n- **[Overpass API](https://overpass-api.de/)** - OSM query infrastructure\n- **[React](https://react.dev/)** + **[TypeScript](https://www.typescriptlang.org/)** - Modern web framework\n- **[Leaflet](https://leafletjs.com/)** - Interactive maps\n- **[Flask](https://flask.palletsprojects.com/)** - Python web framework\n- **[pandas](https://pandas.pydata.org/)** + **[openpyxl](https://openpyxl.readthedocs.io/)** - Data processing\n- **[Folium](https://python-visualization.github.io/folium/)** - Python → Leaflet maps\n\nInspired by **[GPX Studio](https://gpx.studio/)** ❤️\n\n---\n\n### 4.5 Development Status ⚠️\n\nThis project is under active development. Features and APIs may change. Documentation may lag behind implementation. Use at your own risk for production workloads.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frikmueller%2Fwhatsaround","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frikmueller%2Fwhatsaround","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frikmueller%2Fwhatsaround/lists"}