Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tarkatronic/fitbit-graphs
Generating useful graphs from Fitbit's body data
https://github.com/tarkatronic/fitbit-graphs
Last synced: about 1 month ago
JSON representation
Generating useful graphs from Fitbit's body data
- Host: GitHub
- URL: https://github.com/tarkatronic/fitbit-graphs
- Owner: tarkatronic
- License: mit
- Created: 2020-08-08T19:53:01.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-08-14T15:12:09.000Z (over 4 years ago)
- Last Synced: 2024-10-15T03:52:42.218Z (3 months ago)
- Language: Python
- Homepage:
- Size: 296 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fitbit-graphs
Generating useful graphs from Fitbit's body data
## Development
### Prerequisites
This project uses Poetry for its dependency and project management. If you have not already, you will need to [install Poetry](https://python-poetry.org/docs/#installation). You will also need at least Python 3.6 in order to work on this project.
### Setup
Once you have your basics set up, getting going is as easy as one command:
```sh
poetry install
```
From here, you should be ready to get working!
### Running things
Everything is still very much in the testing and pre-alpha stage, so files are not in their final places. No tests are in place. No fancy entry points exist yet. To run the code and generates graphs, you will want to do a couple of things.
1. Create a `data/` folder inside the `fitbit-graphs/` folder.
2. Go to https://www.fitbit.com/settings/data/export and export all of your historical data, month by month, from Fitbit.
* You will want to be sure to select only the "Body" option under "Include Data", or things will break.
* You should use a consistent naming pattern for the files, to keep them separated and organized. I personally name them with the format `body-YYYY-MM.csv`. For example, `body-2020-08.csv`.
* You must save the files with a `.csv` file extension, or the scripts will not find them.
Now that your data is all set up and ready, all you need to do to run one of the scripts is:
```sh
poetry run python
```
For example:
```sh
poetry run python test2.py
```
And voila, you're off to the races!