{"id":28492462,"url":"https://github.com/zupzup/calories","last_synced_at":"2025-07-03T02:05:32.381Z","repository":{"id":44335941,"uuid":"73689948","full_name":"zupzup/calories","owner":"zupzup","description":"Calories Tracker for the Commandline","archived":false,"fork":false,"pushed_at":"2022-12-30T21:58:08.000Z","size":3227,"stargazers_count":107,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-06-08T08:11:25.719Z","etag":null,"topics":["boltdb","calories","calories-tracker","cli-app","commandline","go","golang","storm"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zupzup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-14T09:45:22.000Z","updated_at":"2025-06-06T20:41:45.000Z","dependencies_parsed_at":"2023-01-31T17:00:30.364Z","dependency_job_id":null,"html_url":"https://github.com/zupzup/calories","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/zupzup/calories","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zupzup%2Fcalories","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zupzup%2Fcalories/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zupzup%2Fcalories/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zupzup%2Fcalories/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zupzup","download_url":"https://codeload.github.com/zupzup/calories/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zupzup%2Fcalories/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263245295,"owners_count":23436511,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boltdb","calories","calories-tracker","cli-app","commandline","go","golang","storm"],"created_at":"2025-06-08T08:10:25.692Z","updated_at":"2025-07-03T02:05:32.372Z","avatar_url":"https://github.com/zupzup.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"calories\n=========\n\n[![Build Status](https://travis-ci.org/zupzup/calories.svg?branch=master)](https://travis-ci.org/zupzup/calories)\n[![Go Report Card](https://goreportcard.com/badge/github.com/zupzup/calories)](https://goreportcard.com/report/github.com/zupzup/calories)\n[![GoDoc](https://godoc.org/github.com/zupzup/calories?status.svg)](http://godoc.org/github.com/zupzup/calories)\n\n![Screenshot](logo.png)\n\nCalories is a commandline tool for tracking calories and weight using the [Harris Benedict](https://en.wikipedia.org/wiki/Harris%E2%80%93Benedict_equation) formula for calculating your BMR (Basal Metabolic Rate).\n\nFeatures\n---------\n\n![Screenshot](screenshot.png)\n\n* Weight Timeline\n* Day / Week / Month Overview\n* Personalized Configuration\n* Metric \u0026 Imperial Support \n* JSON Import / Export\n* Optional JSON Output for all Commands\n* History\n\nInstallation\n-------------\n\nUsing Go:\n\n```\ngo get github.com/zupzup/calories\n```\n\nOr with the released [Binaries](https://github.com/zupzup/calories/releases) for\n\n* OS X (32-bit, 64 bit)\n* Windows (32-bit, 64 bit)\n* Linux (32-bit, 64 bit)\n\nGetting Started\n---------------\n\nWhen you start `calories`, it will ask you where to put the `calories.db` file, which will store all of your data.\n\nThen, it asks you to create your configuration using\n\n```bash\ncalories config --weight=0.0 --height=0.0 --activity=0.0 --birthday=01.01.1970 --gender=female --unit=metric\n\n// Example Metric\ncalories config --weight=88.0 --height=189.0 --activity=1.375 --birthday=02.09.1986 --gender=male --unit=metric\n\n// Example Imperial (with shorthand flags)\ncalories config --w=226.0 --h=72.8 --a=1.55 --b=02.09.1986 --g=male --u=imperial\n```\n\nExcept 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.\n\nThe Activity Setting depends on how much you exercise and needs to be set independently of the unit system based on this table:\n\n| Amount of Exercise                    | Activity |\n|---------------------------------------|----------|\n| Little to no exercise\t                |   1.2    |\n| Light exercise (1–3 days per week)    |   1.375  |\n| Moderate exercise (3–5 days per week) |   1.55   |\n| Heavy exercise (6–7 days per week)    |   1.725  |\n| Very heavy exercise\t                |   1.9    |\n\nAfter configuration you're all setup. Just typing `calories` will show you all entries of the current day.\n\nYou can add entries using e.g.: `calories add 150 apple`.\n\nUsage\n------\n\nAll commands follow the same structure:\n\n```bash\ncalories [options] \u003ccommands\u003e [\u003carguments...\u003e]\n```\n\nYou can use these commands to get an overview of all the different commands and information on how to use them:\n\n```bash\ncalories -help\n\ncalories -commands\n\ncalories \u003ccommand\u003e -help\n```\n\n#### Adding an Entry\n\n```bash\n// Add an apple with 100 calories\ncalories add 100 Apple\n\n// Add dates and cashews \ncalories add 300 \"dates and cashews\"\n\n// Add a Burger with 1000 calories \ncalories add 1000 Burger\n\n// Add an apple with 100 calories for a certain day\ncalories add --d=01.01.2017 100 Apple\n```\n\n#### Display Modes \n\n```bash\n// Show the current day\ncalories\n\n// Show a certain day\ncalories --d=01.01.2017\n\n// Show the current week\ncalories --w\n\n// Show the current month\ncalories --m\n\n// Show the last 30 days\ncalories --h=30\n\n// Show the last 1000 days\ncalories --h=1000\n```\n\n#### Clearing all entries on a Day \n\nThe `clear` commands ask for your permission, before they actually delete anything.\n\n```bash\n// Clear the current day\ncalories clear\n\n// Clear a specific day\ncalories clear --d=01.01.2017\n```\n\n#### Clearing a position inside an Entry \n\n```bash\n// Clear the position on the current day (1-n)\ncalories clear --p=1\n\n// Clear the position on the current day (1-n)\ncalories clear --d=01.01.2017 --p=1\n```\n\n#### View Weight Timeline \n\n```bash\n// Show Weight Timeline\ncalories weight\n```\n\n#### Add Weight\n\n```bash\n// Add new weight on today's date\ncalories weight 85.0 \n```\n\n#### Configuration\n\nIf you set the configuration, after you already set it, the configuration is overwritten. However, you will get asked before this happens.\n\n```bash\n// Display the current configuration\ncalories config\n\n// Example Metric\ncalories config --weight=88.0 --height=189.0 --activity=1.375 --birthday=02.09.1986 --gender=male --unit=metric\n\n// Example Imperial (with shorthand flags)\ncalories config --w=226.0 --h=72.8 --a=1.55 --b=02.09.1986 --g=male --u=imperial\n```\n\n#### Export \n\n```bash\n// Export all Data to backup.json\ncalories export \u003e backup.json\n```\n\n#### Import \n\nImport does **NOT** ask your permission before overwriting data.\n\n```bash\n// Import all data from backup.json, OVERWRITING ALL DATA! \ncalories import --f=backup.json \n```\n\n#### JSON Output\n\nAll commands have a `--o` flag for JSON output, which makes it possible to easily integrate calories with other tools.\n\n```bash\n// Default is terminal\ncalories --o terminal\n\n// And there is also JSON \ncalories --o json\n```\n\nThat's it - have fun! :)\n\nCredit\n-------\n\nRenee French, For the Go Gopher the Logo is based on\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzupzup%2Fcalories","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzupzup%2Fcalories","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzupzup%2Fcalories/lists"}