https://github.com/jdhartley/terminal-for-fitbit
Terminal is a Fitbit clock face styled to match a terminal session in a Unix environment
https://github.com/jdhartley/terminal-for-fitbit
fitbit fitbit-clockface fitbit-ionic fitbit-versa horology terminal
Last synced: 5 months ago
JSON representation
Terminal is a Fitbit clock face styled to match a terminal session in a Unix environment
- Host: GitHub
- URL: https://github.com/jdhartley/terminal-for-fitbit
- Owner: jdhartley
- License: unlicense
- Created: 2019-01-30T00:25:46.000Z (over 7 years ago)
- Default Branch: sdk5
- Last Pushed: 2025-02-24T20:47:57.000Z (over 1 year ago)
- Last Synced: 2025-12-02T00:24:33.845Z (7 months ago)
- Topics: fitbit, fitbit-clockface, fitbit-ionic, fitbit-versa, horology, terminal
- Language: JavaScript
- Homepage: https://terminal.watch/
- Size: 608 KB
- Stars: 139
- Watchers: 8
- Forks: 17
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Terminal for Fitbit
Inspired by [quarlow's amazing terminal watchface for Galaxy Gear](https://www.reddit.com/r/unixporn/comments/9ndo8o/oc_always_keep_some_terminal_with_you/), Terminal is a clock face styled to match a terminal session in a Unix environment.
## Screenshots
### Sense, Versa 3
### Versa, Versa 2
### Ionic
### Versa Lite
_Versa Lite supports distance instead of elevation gain._
## Changelog
### Terminal 2.4.0 - 2023-02-15
- Add a new data line: Time with seconds
- Add a new "Prompt" option to settings
- Allow customizing the shell prompt character from the default bash ($)
- Switch to a csh/zsh "#", or enter LEET MODE and see "%" like the superuser you are!
### Terminal v2.3.0 - 2022-06-15
- Add two new data lines: Calories burned and Activity Zone Minutes
- While charging, update BATT line to show CHRG state
- Fix: update HRRT data line to support custom heart rate zones (bug #19)
### Terminal v2.2.1 - 2022-06-14
- Fix cursor positioning when there are fewer than 5 data lines (bug #39)
### Terminal v2.2.0 - 2022-05-29
- Add a new "Cursor" option to settings
- Cursors blink every second
- Choose between no cursor (default), full block, half block, i-beam, or underline.
- Misc: Add a "reset settings to default" button
- Update @fitbit/sdk to ^6.1.0
### Terminal v2.1.0 - 2020-09-25
- Add support for Fitbit Sense and Versa 3
### Terminal v2.0.2 - 2020-09-21
- Fix: Prevent clipping of usernames longer than 4 char (bug #14)
- Misc: Add warning in settings if username is longer than 8 char
### Terminal v2.0.1 – 2020-07-03
- Fix: Better support for the wider Ionic screen
- Fix: Add `access_internet` permission to fix loading of Theme previews
- This permission will be used more in an upcoming version of Terminal
- Misc: Better instructions on removing/adding data when your watch has 6 rows
### Terminal v2.0.0 – 2020-03-22
- A complete and total rewrite of Terminal, loaded with new features and customizability!
- Add support for rearranging and changing up to 6 lines of content
- `TIME`, `DATE`, `BATT`, `STEP`, `DIST`, `LVLS` (on supported devices), and `HRRT`.
- Add support for customizing fonts:
- Source Code Pro (original font from v1), Hack, Fira Code, Sudo, Roboto Mono, and Nova Mono.
- Add support for themes:
- Default (original theme from v1), Dracula, Hopscotch, Solarized Dark, and Solarized Light.
- Update @fitbit/sdk to ^4.1.0
### Terminal v1.1.0 – 2020-01-09
- Add official support for Versa 2 (mira)
- Add support for Versa Lite (gemini)
- Show distance (`[DIST]`) in km or mi instead of floors (`[LVLS]`)
- The `[DIST]` option will appear for other devices in a future update
- Bugfix: Sometimes settings would become unrecoverably damaged, preventing username changes.
- Update @fitbit/sdk to ^4.0.2
- Update @fitbit/sdk-cli to ^1.7.1
- Update fitfont to ^1.3.1
- Rebuild font files
- Internal: start work to supporting dynamic row content
### Terminal v1.0.3 – 2019-10-07
- Bugfix: Versa 2 hostname displays as "@versa 2" instead of "@versa"
- Update @fitbit/sdk to ^3.1.2
- Update @fitbit/sdk-cli to ^1.6.3
### Terminal v1.0.2 – 2019-01-31
- Bugfix: Fix "12pm" displaying as "12am"
### Terminal v1.0.1 – 2019-01-30
- Bugfix: Fix username painting
- Bugfix: Remove debug code preventing stale heartrates from displaying as '--'
## Credits
- Inspired by quarlow's [amazing terminal watchface](https://www.reddit.com/r/unixporn/comments/9ndo8o/oc_always_keep_some_terminal_with_you/) for Galaxy Gear/Wear OS, nsmith543's [terminal watchface](https://github.com/nsmith543/terminal) clone for Garmin watches, and Dr_Schmoctor's [terminal watchface](https://amazfitwatchfaces.com/bip/view/?id=15384) clone for Amazfit Bip.
- [FitFont for Fitbit](https://github.com/gregoiresage/fitfont) (seriously, thank you so much Grégoire)
- [Source Code Pro Medium](https://github.com/adobe-fonts/source-code-pro)
- Fitbit's open source [Moment clock face](http://github.com/fitbit/sdk-moment)