{"id":29995409,"url":"https://github.com/stichoza/flipper-nearby-files","last_synced_at":"2025-08-05T01:39:32.977Z","repository":{"id":305418318,"uuid":"1021724160","full_name":"Stichoza/flipper-nearby-files","owner":"Stichoza","description":"🧭 Flipper Zero application for viewing nearby files sorted by distance from your GPS location.","archived":false,"fork":false,"pushed_at":"2025-07-28T17:36:54.000Z","size":134,"stargazers_count":12,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-28T18:07:44.731Z","etag":null,"topics":["flipper","flipper-zero","flipper-zero-app","flipper-zero-application","flipperzero"],"latest_commit_sha":null,"homepage":"","language":"C","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/Stichoza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"ko_fi":"stichoza","custom":["https://www.paypal.me/stichoza","https://btc.com/bc1qc25j4x7yahghm8nnn6lypnw59nptylsw32nkfl"]}},"created_at":"2025-07-17T21:04:29.000Z","updated_at":"2025-07-28T17:36:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"8b457941-d24a-40ab-8586-c63e64542463","html_url":"https://github.com/Stichoza/flipper-nearby-files","commit_stats":null,"previous_names":["stichoza/flipper-nearby-files"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/Stichoza/flipper-nearby-files","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stichoza%2Fflipper-nearby-files","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stichoza%2Fflipper-nearby-files/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stichoza%2Fflipper-nearby-files/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stichoza%2Fflipper-nearby-files/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Stichoza","download_url":"https://codeload.github.com/Stichoza/flipper-nearby-files/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Stichoza%2Fflipper-nearby-files/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268820431,"owners_count":24312380,"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-08-04T02:00:09.867Z","response_time":79,"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":["flipper","flipper-zero","flipper-zero-app","flipper-zero-application","flipperzero"],"created_at":"2025-08-05T01:39:30.401Z","updated_at":"2025-08-05T01:39:32.966Z","avatar_url":"https://github.com/Stichoza.png","language":"C","funding_links":["https://ko-fi.com/stichoza","https://www.paypal.me/stichoza","https://btc.com/bc1qc25j4x7yahghm8nnn6lypnw59nptylsw32nkfl"],"categories":[],"sub_categories":[],"readme":"# Nearby Files\n\nA GPS-enabled file browser for Flipper Zero that displays SubGHz, NFC, and RFID files sorted by distance from your current location.\n\n\u003cimg src=\".catalog/screenshots/screenshot1.png\" width=\"256\"\u003e \u003cimg src=\".catalog/screenshots/screenshot2.png\" width=\"256\"\u003e \u003cimg src=\".catalog/screenshots/screenshot3.png\" width=\"256\"\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eShow Preview\u003c/summary\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/d91aacc7-ba4f-4cc8-b855-ed37298d8df0\" width=\"512\"\u003e\n\u003c/details\u003e\n\n\n\u003e [!Tip]\n\u003e Check out [flipper-map.stichoza.com](https://flipper-map.stichoza.com) for a web version of this app. Visualize files on a map in your browser.\n\n## Features\n\n- **GPS Integration**: Uses real GPS coordinates to calculate distances to files\n- **Multi-format Support**: Scans `.sub`, `.nfc`, and `.rfid` files from standard directories\n- **Distance-based Sorting**: Files are sorted by proximity to your current GPS location\n- **Smart Filtering**: Only displays files containing GPS coordinates\n- **Distance Display**: Shows distance to each file (e.g., [45m], [1.3km], [23km])\n- **Direct Launch**: Click any file to launch the appropriate app (SubGHz, NFC, or RFID)\n\n## Installation\n\nThe app comes bundled with [Momentum](https://momentum-fw.dev/) firmware. If you're using any other firmware, you can install by any of following ways:\n\n### Option 1: Install from App Catalog\n\n1. Go to [lab.flipper.net](https://lab.flipper.net/apps/nearby_files) and search for **Nearby Files**.\n2. Connect your Flipper Zero to your PC or laptop using USB cable.\n3. Click **Install**.\n\n### Option 2: Install from File\nInstall from **[releases](https://github.com/Stichoza/flipper-nearby-files/releases/latest)** (stable builds) or **[workflows](https://github.com/Stichoza/flipper-nearby-files/actions/workflows/build.yml)** (development builds).\n\n1. Choose which version you would like to install.\n   - For stable builds, go to [latest release](https://github.com/Stichoza/flipper-nearby-files/releases/latest) page.\n   - For development builds, go to [build workflow](https://github.com/Stichoza/flipper-nearby-files/actions/workflows/build.yml) and select latest build.\n4. Download file corresponding to your firmware version. The FAP file is built for the Official Firmware (both release and development versions) and for Momentum and Unleashed custom firmwares (files with `-unlshd` and `-mntm` suffixes).\n5. Extract `nearby_files.fap` from the ZIP file to the `apps/GPIO` folder on your Flipper Zero SD card.\n\n### Option 3: Build from Source\n\nIf you're building from source, you most pobably know what to do and how.\n\n## Usage\n\n### Requirements\n- GPS module connected via GPIO pins.\n- SD card with SubGHz/NFC/RFID files containing GPS coordinates.\n\n### GPS Waiting Screen\nThe app waits for a valid GPS fix before scanning files. You'll see:\n- **No GPS Module** – if no GPS hardware is detected.\n- **Waiting for GPS...** – when looking for GPS.\n- **Calculating distances...** – when calculating distances to files.\n\n### File List\nOnce GPS coordinates are acquired, the app scans and displays files sorted by distance:\n- Files with GPS coordinates are shown with distance indicators.\n- Files without coordinates are excluded from the list.\n- Click any file to launch the respective app.\n\n### Menu Options\nPress Back in the file list to access:\n- **Refresh List**: Re-scan files with updated GPS position\n- **About**: App information and version details\n\n\u003e [!Important]\n\u003e File list is not automatically recalculated unless you click \"Refresh List\" in the menu. The reason is to avoid choosing wrong file when the list suddenly updates right before you click.\n\n## Hardware Setup\n\nConnect a GPS module to your Flipper Zero using the GPIO pins.\n\n| GPS | Flipper      |\n|-----|--------------|\n| VCC | 3.3V (Pin 9) |\n| GND | GND (Pin 11) |\n| TX  | RX (Pin 14)  |\n| RX  | TX (Pin 13)  |\n\n\u003e [!Tip]\n\u003e GPS module wiring is well described in [ezod/flipperzero-gps](https://github.com/ezod/flipperzero-gps?tab=readme-ov-file#hardware-setup) repository.\n\n## File Requirements\n\nFiles must contain GPS coordinates in one of these formats:\n\n```yml\nLat: 41.123456\nLon: 44.123456\n```\n\n\u003e [!Note]\n\u003e `Latitude` and `Longitude` keywords are also supported. `Latitute` (typo) is also supported for legacy reasons.\n\nThese coordinates are **automatically** added to SubGHz files if you're using a custom firmware (like Momentum or RogueMaster) that has \"subdriving\" feature – recording location from GPS module at the time of signal capture. You can also manually add coordinates by editing the file either via Flipper mobile app or directly on SD card.\n\nCurrently there are no apps or firmware that adds GPS data to NFC and RFID files, but you can always add coordinates to those files manually. Useful for location specific cards, like work badges, apartment access cards, elevator badges, etc.\n\n\u003e [!Warning]\n\u003e If your Flipper is crashing or rebooting while running GPS related apps, try setting `Listen UART` to `None` in Flipper settings.\n\u003e Source: https://github.com/flipperdevices/flipperzero-firmware/issues/4081#issuecomment-2631762477\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstichoza%2Fflipper-nearby-files","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstichoza%2Fflipper-nearby-files","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstichoza%2Fflipper-nearby-files/lists"}