calories
Calories is a commandline tool for tracking calories and weight using the Harris Benedict formula for calculating your BMR (Basal Metabolic Rate).
Features
- Weight Timeline
- Day / Week / Month Overview
- Personalized Configuration
- Metric & Imperial Support
- JSON Import / Export
- Optional JSON Output for all Commands
- History
Installation
Using Go:
go get github.com/zupzup/calories
Or with the released Binaries for
- OS X (32-bit, 64 bit)
- Windows (32-bit, 64 bit)
- Linux (32-bit, 64 bit)
Getting Started
When you start calories, it will ask you where to put the calories.db file, which will store all of your data.
Then, it asks you to create your configuration using
calories config --weight=0.0 --height=0.0 --activity=0.0 --birthday=01.01.1970 --gender=female --unit=metric
// Example Metric
calories config --weight=88.0 --height=189.0 --activity=1.375 --birthday=02.09.1986 --gender=male --unit=metric
// Example Imperial (with shorthand flags)
calories config --w=226.0 --h=72.8 --a=1.55 --b=02.09.1986 --g=male --u=imperial
Except for Activity, the parameters should be pretty self-explanatory. You can use both the metric or the imperial system, but you need to specify the one you are using in the configuration.
The Activity Setting depends on how much you exercise and needs to be set independently of the unit system based on this table:
| Amount of Exercise | Activity |
|---|---|
| Little to no exercise | 1.2 |
| Light exercise (1–3 days per week) | 1.375 |
| Moderate exercise (3–5 days per week) | 1.55 |
| Heavy exercise (6–7 days per week) | 1.725 |
| Very heavy exercise | 1.9 |
After configuration you're all setup. Just typing calories will show you all entries of the current day.
You can add entries using e.g.: calories add 150 apple.
Usage
All commands follow the same structure:
calories [options] <commands> [<arguments...>]
You can use these commands to get an overview of all the different commands and information on how to use them:
calories -help
calories -commands
calories <command> -help
Adding an Entry
// Add an apple with 100 calories
calories add 100 Apple
// Add dates and cashews
calories add 300 "dates and cashews"
// Add a Burger with 1000 calories
calories add 1000 Burger
// Add an apple with 100 calories for a certain day
calories add --d=01.01.2017 100 Apple
Display Modes
// Show the current day
calories
// Show a certain day
calories --d=01.01.2017
// Show the current week
calories --w
// Show the current month
calories --m
// Show the last 30 days
calories --h=30
// Show the last 1000 days
calories --h=1000
Clearing all entries on a Day
The clear commands ask for your permission, before they actually delete anything.
// Clear the current day
calories clear
// Clear a specific day
calories clear --d=01.01.2017
Clearing a position inside an Entry
// Clear the position on the current day (1-n)
calories clear --p=1
// Clear the position on the current day (1-n)
calories clear --d=01.01.2017 --p=1
View Weight Timeline
// Show Weight Timeline
calories weight
Add Weight
// Add new weight on today's date
calories weight 85.0
Configuration
If you set the configuration, after you already set it, the configuration is overwritten. However, you will get asked before this happens.
// Display the current configuration
calories config
// Example Metric
calories config --weight=88.0 --height=189.0 --activity=1.375 --birthday=02.09.1986 --gender=male --unit=metric
// Example Imperial (with shorthand flags)
calories config --w=226.0 --h=72.8 --a=1.55 --b=02.09.1986 --g=male --u=imperial
Export
// Export all Data to backup.json
calories export > backup.json
Import
Import does NOT ask your permission before overwriting data.
// Import all data from backup.json, OVERWRITING ALL DATA!
calories import --f=backup.json
JSON Output
All commands have a --o flag for JSON output, which makes it possible to easily integrate calories with other tools.
// Default is terminal
calories --o terminal
// And there is also JSON
calories --o json
That's it - have fun! :)
Credit
Renee French, For the Go Gopher the Logo is based on
![Regression after imperial import bug fix, --h=[int HEIGHT] is set in centimeters when imperial measures are set](https://avatars.githubusercontent.com/u/13276804?v=4)
To be clear, I prefer the behavior of it just overwriting the current value, as I don't have to do math or remember what my last value was. I just put in what the value currently IS.
