A global marine tide, tidal currents, and lunar/solunar reconnaissance platform indexing 32,013 coastal stations worldwide across North & Central America, South America, Asia, Africa, Oceania, and Europe.
Ebb&Flow is a tactical oceanic surveillance and coastal telemetry application designed for mariners, anglers, surfers, and coastal observers. Styled with an Oceanic Deep Water Glassmorphism aesthetic (deep abyss navy, bioluminescent teal accents, frosted translucent glass panels, and live canvas wave fluid animations), it tracks astronomical tides, water elevations, tidal tendencies, lunar phases, and solunar coefficients without requiring manual refreshing.
- 🌐 Global Tide Station Coverage (32,013 Stations):
- Compiled directly from tides4fishing.com across 6 continents:
- North & Central America (
/am) - South America (
/su) - Asia (
/as) - Africa (
/af) - Oceania (
/oc) - Europe (
/eu)
- North & Central America (
- Instant offline fuzzy search across stations, coastal regions, and countries.
- Compiled directly from tides4fishing.com across 6 continents:
- ⏱️ 100% Real-Time Telemetry (Zero Reloads):
- Continuous second-by-second water elevation calculation and tidal tendency tracking (
FLOODING (RISING) ▲vsEBBING (FALLING) ▼). - Next High Tide and Next Low Tide countdown timer ticking live.
- Interactive Dynamic Waveform Canvas: 24-hour harmonic tide curve with fluid wave oscillation and glowing real-time cursor.
- Continuous second-by-second water elevation calculation and tidal tendency tracking (
- 📍 Location Persistence & Sticky Behavior:
- The app always re-opens to the last chosen location and firmly maintains that position across sessions until explicitly changed.
- 🏠 Home Base & Quick Access with Customizable Nicknames:
- 1-tap Home Base designation with direct top HUD jump button.
- Quick Access bookmarked list allowing personalized custom nicknames (e.g., "My Secret Surf Break", "Weekend Fishing Pier", "Home Marina").
- 🌕 Lunar & Solunar Activity Tracking:
- Real-time lunar phase calculation (illumination percentage, lunar age in days).
- Maritime tidal coefficient (20 - 118 scale) and solunar feeding activity classification.
↗️ One-Touch Deep Link Telemetry:- Direct deep-link launching full historical tables, solunar charts, and barometric data on Tides4Fishing.
- 📱 Native Hardware Integration:
- Android native client with edge-to-edge dark theme, hardware-accelerated WebView, SharedPreferences persistence bridge, and haptic feedback.
- Custom launcher icons generated from
/home/prime3vil/Pictures/Ebb&Flow.jpg.
Ebb&Flow/
├── app/ # Android Native Client (Kotlin + AndroidX + WebKit)
│ ├── src/main/java/com/ebbflow/app/
│ │ ├── MainActivity.kt # Activity lifecycle, edge-to-edge display
│ │ └── EbbFlowBridge.kt # Native SharedPreferences & haptic bridge
│ ├── src/main/assets/map/ # Core Oceanic Map & UI Engine
│ │ ├── index.html # Main map HUD & sliding telemetry drawer
│ │ ├── oceanic.css # Deep Water Glassmorphism stylesheet
│ │ ├── tide_engine.js # Real-time harmonic tide & solunar calculation
│ │ ├── quick_access.js # Persistent storage & nickname manager
│ │ ├── tides_data.js # 32,013 compiled stations database
│ │ └── leaflet/ # Hardware-accelerated Leaflet & MarkerCluster
│ └── src/main/res/ # Mipmap launcher icons & themes
├── scripts/
│ ├── compile_tides4fishing.py # High-concurrency 6-continent scraper
│ └── generate_app_icons.py # Icon generator from source image
├── tide_stations.json # Full JSON station database (7.4 MB)
└── Ebb&Flow.apk # Standalone installable Android APK (5.6 MB)
To compile the standalone release APK:
./gradlew assembleReleaseThe compiled package will be placed at Ebb&Flow.apk in the root directory.
To refresh station data from tides4fishing:
python3 scripts/compile_tides4fishing.pyReady-to-use release binaries are available under Releases:
| Platform | Package File | Architecture | Format |
|---|---|---|---|
| Android | Ebb&Flow.apk |
Universal | Standalone Installable APK (v2) |
| Linux (x64) | Ebb&Flow-Linux-x64.zip |
x86_64 | Portable Standalone Binary |
| Windows (x64) | Ebb&Flow-Windows-x64.zip |
x86_64 | Portable .zip (Ebb&Flow.exe) |
| macOS (Apple Silicon) | Ebb&Flow-Mac-AppleSilicon-arm64.zip |
Apple Silicon (M1-M4) | Standalone .app bundle |
| macOS (Intel) | Ebb&Flow-Mac-Intel-x64.zip |
Intel x64 | Standalone .app bundle |
Follow the simple visual instructions below to install and launch Ebb&Flow through your operating system's graphical interface:
- Download
Ebb&Flow.apkfrom Releases directly on your device (or download to PC and transfer via USB). - Open your device's Files or Downloads app and tap
Ebb&Flow.apk. - If Android displays "For your security, your phone is not allowed to install unknown apps from this source":
- Tap Settings in the prompt.
- Toggle "Allow from this source" to ON.
- Tap the back arrow.
- Tap Install and wait for the installer to finish.
- Tap Open to launch Ebb&Flow, or tap the Ebb&Flow icon in your app drawer.
- Download
Ebb&Flow-Windows-x64.zipfrom Releases. - Locate the file in Windows File Explorer (in your
Downloadsfolder). - Right-click
Ebb&Flow-Windows-x64.zip-> select Extract All... -> click Extract. - Open the extracted
Ebb&Flow-win32-x64folder. - Double-click
Ebb&Flow.exeto launch the console. - (First Launch / SmartScreen): If Windows SmartScreen displays "Windows protected your PC":
- Click "More info".
- Click "Run anyway".
- (Optional Desktop Shortcut): Right-click
Ebb&Flow.exe-> Show more options -> Send to -> Desktop (create shortcut).
- Download the archive matching your Mac's processor from Releases:
Ebb&Flow-Mac-AppleSilicon-arm64.zip: For Apple Silicon (M1, M2, M3, M4) Macs.Ebb&Flow-Mac-Intel-x64.zip: For Intel-based Macs.
- In Finder, double-click the
.zipfile to extract it. - Open the extracted folder and drag
Ebb&Flow.appinto your Applications folder (/Applications). - Launch
Ebb&Flowfrom your Applications folder, Launchpad, or Spotlight (Cmd + Space). - (First Launch / Gatekeeper Approval):
- If macOS displays "Ebb&Flow cannot be opened because the developer cannot be verified":
- Option 1: Right-click (or Control-click)
Ebb&Flow.appin Finder -> choose Open -> click Open in the confirmation dialog. - Option 2: Go to System Settings -> Privacy & Security, scroll down to the Security section, and click "Open Anyway".
- Option 1: Right-click (or Control-click)
- If macOS displays "Ebb&Flow cannot be opened because the developer cannot be verified":
- Download
Ebb&Flow-Linux-x64.zipfrom Releases. - Open your desktop file manager (Dolphin in KDE, Nautilus / Files in GNOME) and right-click the
.zipfile -> choose Extract Here (or Extract Archive). - Open the extracted
Ebb&Flow-linux-x64folder. - Enable executable permission:
- Right-click the
Ebb&Flowbinary -> select Properties. - Navigate to the Permissions tab.
- Check the box "Is executable" (KDE) or "Allow executing file as program" (GNOME).
- Click OK.
- Right-click the
- Double-click
Ebb&Flowto launch! - (Optional System Menu Integration): If cloning the repository, you can run
./install.shinsideLinux appto automatically install icons, application menu launchers, and theebb-flowCLI command.
For developers and power users who prefer using the command line:
With USB debugging enabled on your phone:
adb install -r "Ebb&Flow.apk"# 1. Download & extract archive:
unzip "Ebb&Flow-Linux-x64.zip" -d EbbFlow
# 2. Grant execution permission:
chmod +x "EbbFlow/Ebb&Flow-linux-x64/Ebb&Flow"
# 3. Launch application:
"./EbbFlow/Ebb&Flow-linux-x64/Ebb&Flow"# 1. Extract archive:
Expand-Archive -Path ".\Ebb&Flow-Windows-x64.zip" -DestinationPath ".\EbbFlow"
# 2. Launch:
& ".\EbbFlow\Ebb&Flow-win32-x64\Ebb&Flow.exe"# 1. Extract to Applications:
unzip "Ebb&Flow-Mac-AppleSilicon-arm64.zip" -d /Applications/
# 2. Clear quarantine attribute (Gatekeeper bypass):
xattr -cr "/Applications/Ebb&Flow-darwin-arm64/Ebb&Flow.app"
# 3. Launch:
open "/Applications/Ebb&Flow-darwin-arm64/Ebb&Flow.app"Distributed under the MIT License. See LICENSE for details.
Maintained with 🌊 by Prime3vil