openscale/README.md

openScale <img src="https://travis-ci.org/oliexdev/openScale.svg?branch=master" alt="build:passed">
=========

openScale is an open source app to keep a log of your weight, body fat, water percentage and muscle percentage.

<a href="https://f-droid.org/repository/browse/?fdid=com.health.openscale" target="_blank">
<img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="80"/></a>
<a href="https://play.google.com/store/apps/details?id=com.health.openscale" target="_blank">
<img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png" alt="Get it on Google Play" height="80"/></a>

Install [openScale-dev-build.apk](https://github.com/oliexdev/openScale/blob/master/openScale-dev-build.apk) to get the latest development build generated by [Travis CI](https://travis-ci.org/). But be aware that this version may contain bugs and you don't get any automatically updates. 

# Features

- Logs your weight, body fat, water percentage and muscle percentage
- Display all your data on a chart and table 
- Import or export your data from/into a CSV file
- Support for multiple users
- Support for Bluetooth Xiaomi Mi Scale, Sanitas SBF70, Medisana BS444
- Connection to a custom made bluetooth scale (see [openScale wiki](https://github.com/oliexdev/openScale/wiki) for more information)
- All data belongs to you (no cloud service)

# Screens

<table>
  <tr>
    <th>
        <a href="doc/screens/screen_overview.png" target="_blank">
        <img src='doc/screens/screen_overview.png' width='200px' alt='image missing' /> </a> <br>
        <sub><b>overview page</b></sub>
    </th>
    <th>
        <a href="doc/screens/screen_graph.png" target="_blank">
        <img src='doc/screens/screen_graph.png' width='250px' alt='image missing' /> </a> <br>
        <sub><b>graph page</b></sub>
    </th>
  </tr>
  
  <tr>
    <td>
        <a href="doc/screens/screen_table.png" target="_blank">
        <img src='doc/screens/screen_table.png' width='250px' alt='image missing' /> </a> <br>
        <sub><b>table page</b></sub>
    </td>
    <td>
        <a href="doc/screens/screen_statistics.png" target="_blank">
        <img src='doc/screens/screen_statistics.png' width='250px' alt='image missing' /> </a> <br>
        <sub><b>statistics page</b></sub>
    </td>
  </tr>
  <tr>
    <td>
        <a href="doc/screens/screen_dataentry.png" target="_blank">
        <img src='doc/screens/screen_dataentry.png' width='200px' alt='image missing' /> </a> <br>
        <sub><b>data entry page</b></sub>
    </td>
    <td>
    <!-- empty cell -->
    </td>
  </tr>
</table>

# Contributing

If you found a bug, have an idea how to improve the openScale app or have a question, please create new issue or comment existing one. If you would like to contribute code, fork the repository and send a pull request.

# License

openScale is licensed under the GPL v3, see LICENSE file for full notice.

    Copyright (C) 2014  olie.xdev <olie.xdev@googlemail.com>
    
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>