Skip to content

MoriNo23/hydrapotion

Repository files navigation

Hydrapotion

Desktop hydration tracker — smart, personal, medical-grade logging.

Go Fyne License

Features

  • Quick logging — 150ml / 250ml / 500ml one-click buttons
  • Smart goal — base 35ml/kg + mood bonus + weather bonus (temp, humidity)
  • Weekly chart — bar chart with goal line + weekly average, medical-grade visual
  • Mood tracking — log mood per day (😊 Bien, 😐 Neutral, 😞 Bajo, 😰 Tenso)
  • Dark theme — clean dark UI, easy on the eyes
  • System tray — minimize to tray, quick-add from context menu
  • Smart reminders — dynamic interval adapting to time-of-day (×0.7 afternoon, ×2.0 night) and weather (×0.5 if ≥35°C). Configurable base: 1h–3h.
  • Weather — auto-fetches temperature & humidity via Open-Meteo
  • Export — CSV (Fecha,ml,Estado de animo) & JSON for doctor visits
  • Sound effects — ASMR keyboard sounds on interaction
  • Single binary — no Node.js, no Electron, no runtime deps

Installation

Dependencies

# Debian / Ubuntu
sudo apt install golang-go libgl1-mesa-dev xorg-dev pulseaudio libnotify-bin

From source

git clone https://github.com/MoriNo23/hydrapotion.git
cd hydrapotion
go build -o ~/bin/hydrapotion .
~/bin/hydrapotion

Or run directly:

go run .

Pre-built binary

Download from Releases:

chmod +x hydrapotion-linux-amd64
./hydrapotion-linux-amd64

Optional: copy to PATH and add .desktop entry for app launcher.

Usage

  1. Open app → set weight and height in settings (gear icon)
  2. Click 150ml / 250ml / 500ml to log water
  3. Select your mood — affects daily goal
  4. Check weekly chart below the cards
  5. Export data (CSV / JSON) from settings for medical records

Data is stored in ~/.hydrapotion/ (settings.json + history.json).

Tech Stack

Component Technology
Language Go
GUI Fyne v2 (develop)
Storage JSON in ~/.hydrapotion/
Weather Open-Meteo API (free)
Notifications notify-send
Sound paplay (PulseAudio)

CI

Every push builds the binary via GitHub Actions. Releases include a pre-compiled hydrapotion-linux-amd64 asset.

License

MIT

About

Desktop hydration tracker built with Wails + React

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors