Skip to content

About

이어폰 위치 알림 — 조용한 위치 기반 알림 Flutter 앱 (Android, iOS)

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1,013 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EarLocAlert

Latest Version : v1.50.1 (2026-11-08)

English · 한국어 · 日本語 · 简体中文

Flutter Platform License

A quiet, location-based alert app: it tells you you've arrived by vibration, or through your earphones only.

When you reach a destination or leave a place, it lets you know without disturbing the people around you.

Map home: saved places and monitoring status   Add place: sound only when earphones are connected   Arrival alert: dismiss with one big button


Sound familiar?

  • You dozed off on the shuttle bus and missed your stop
  • An alarm went off in a library or an office and you wanted to disappear
  • You were wearing earphones, yet the alert came out of the speaker

How it works

Earphones connected (Bluetooth, wired or USB-C)  →  sound through the earphones only
Not connected                                    →  vibration only. The speaker stays silent

The app never plays sound through the device speaker. That is the reason it exists.

Feature Description
Places Pick a spot on the map, then set a name, radius (50 m to 2 km) and alert type
Background monitoring Works without keeping the app open
Arrive / leave alerts When you arrive, when you leave, or both
Quiet alert Repeating vibration until you dismiss it
Earphone detection Checks the connection at the moment the alert fires
Local storage Your location data never leaves the device
Languages English, Korean, Japanese, Chinese
Light & dark Follow the device or pick light or dark in Settings. The alert screen always stays dark so it never glares
Smartwatch A guide shows how to mirror alerts to Galaxy Watch or Apple Watch

Status

The app is feature-complete and is being prepared for release on Google Play. It is not officially released yet. Progress details: 11-ROADMAP (Korean).


Tech stack

Area Used
Framework Flutter 3.35.5 / Dart 3.9+
State management Riverpod (code generation)
Routing go_router
Models Freezed + json_serializable
Local storage Drift (SQLite)
Map Google Maps
Location geolocator + platform geofencing
Audio audio_session + just_audio
Ads Google Mobile Ads

Supported platforms

  • Android 8.0 (API 26) or later
  • iOS 13.0 or later

Behavior differs by platform. Android watches precisely with a foreground service, while iOS delegates to the OS geofencing. iOS limits monitored places to 20, and arrival detection may be delayed → 05-PLATFORM (Korean)


Development

flutter pub get      # install dependencies
dart format .        # format
flutter test         # test
flutter run          # run

Builds and releases are handled by GitHub Actions. The design docs in docs/ are written in Korean; start with 01-REQUIREMENTS and 10-DECISIONS (why things are the way they are).

See CONTRIBUTING.md before opening a pull request. Version history: CHANGELOG.md.


Privacy

  • Location data is stored on the device only and is never sent anywhere
  • The advertising identifier is collected by the ad provider (Google AdMob)
  • There is no sign-up and no account data is collected

Details: 09-RELEASE (Korean).


License

This repository is source-available. It is not an OSI-approved open source license.

PolyForm Noncommercial 1.0.0: reading, studying, modifying and forking are allowed for noncommercial purposes. Commercial use (store distribution, paid services, ad monetization, and so on) is not allowed.

The source is public so that anyone can verify that the app does not transmit location data off the device → NOTICE

Contact

About

이어폰 위치 알림 — 조용한 위치 기반 알림 Flutter 앱 (Android, iOS)

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

Generated from Cassiiopeia/projectops