Skip to content

harryrbrown/waterlogged

Repository files navigation

Waterlogged

screenshot-2024-08-17-21-04-10 screenshot-2024-08-17-21-05-06 screenshot-2024-09-15-14-59-19 screenshot-2024-09-15-14-56-57 screenshot-2024-09-15-14-57-51

Overview

Waterlogged is a Wear OS Tile that allows quick and easy recording of your water intake to Fitbit, via your watch.

Features

  • Authenticates with Fitbit through your paired device (phone), using OAuth 2.0 PKCE
  • Once authenticated, the tile provides three buttons to quickly record your water intake, based upon Fitbit's three default water options - a glass of water (250ml / 8oz), a bottle of water (500ml / 16oz), and a large bottle (750ml / 24oz)
  • The preset water amounts are customisable in the main app
  • Additionally a progress bar around the outside of the tile indicates your progress towards your daily water goal

Requirements

  • Wear OS device paired to a phone
  • Fitbit account

Installation

Waterlogged is currently in private testing on the Google Play store. To gain access to private testing, please join the Waterlogged Google Group, and then download from the Play Store. Thanks!

Usage

  1. After installing, go to the Watch app on your smartphone. Open "Tiles", tap "Add Tiles", and find Waterlogged's "Quick add water" tile. Screenshot_20240818-124055
  2. Swipe on your watch to locate your new tile. The first time using the tile, you'll need to authenticate with Fitbit. Follow the steps on the watch and, when prompted, open your phone to complete the web sign-in.
  3. After successful authentication, the tile should now present to you the three buttons for quick recording water. You're ready to go!

Privacy and security

The app does not store your Fitbit account information. The only details saved on-device are your access tokens once authenticated with Fitbit. These are required to maintain connection with Fitbit's APIs. They never leave your device.

Contributions

All contributions are welcome! If you'd like to contribute, please fork the repository and make changes as you'd like. Pull requests are welcomed.