como 0.7.0
como: batteries complete
License: BSD
Requires Python: >=2.7.0

# como: batteries complete

[`como`](https://github.com/cwoebker/como) is a minimalistic utillity to monitor your battery.

[![PyPI Version](https://img.shields.io/pypi/v/penpal.svg)](https://pypi.python.org/pypi/como)
[![Build Status](https://secure.travis-ci.org/cwoebker/como.png?branch=master)](http://travis-ci.org/cwoebker/como)
[![PyPI License](https://img.shields.io/pypi/l/como.svg)](https://pypi.python.org/pypi/como)
[![PyPI Python Versions](https://img.shields.io/pypi/pyversions/como.svg)](https://pypi.python.org/pypi/como)
[![Say Thanks!](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/cwoebker)

---

## Naming ##

**Why como?**

The answer is simple: Alessandro Volta grew up in the town of [Como](https://maps.google.com/maps/place?ftid=0x47869c481027ed63:0xb99b96af785ff524&q=Como+italy&gl=us&ie=UTF8&ll=45.905539,8.869743&spn=0.000239,0.000343&t=h&z=12&vpsrc=0)
and since he invented the battery I thought it would be a great name.

![Map not found](https://mts0.google.com/vt/data=9JDtAHjlTn3x-Sj-pwj3TI8qbtmqB_-LnEoOWHi1JIH9W7fJrfYPYf2ali6aD042Ny8SYFLwPPZZKXlfEZ4QdxIpwulW3ms6uP5wUAoVf93Jyw3RqOzuf7phyiJTNTa7F40NnNzgarXK_1t3AxD-WqBu5Go8Gincuj1Ho04og_3Sa2UiBghMZdgO5C25rkiQkreOKiiL1sBaWOqNe2jnAM4MI2IC)

## What is this? ##

With como you can check out how your battery is doing.
You can easily `automate` this process so that you don't need to worry about it. 
Every once in a while you can quickly check out your battery `info`.
You can `export` this data into the portable `.csv` format and `import` it again later.
You can even import data form another battery utility such as [coconutBattery](http://www.coconut-flavour.com).

## [como.cwoebker.com](https://como.cwoebker.com) ##

Most importantly you can take all this to the next level, if you choose to do so.
`Upload` your battery data to the como web application to check everything out in a nice interface wherever you are. 
You can always easily `open` your computer's personal page.

## Installation

It's as simple as that:

`$ pip install como`

Afterwards run the `init` command to get everything setup and stop worrying.

`$ como init`

## Usage

`como` - Saves the current battery state.

`como info` - Prints information about battery and battery history.

`como import <file>` - Imports statistics from .csv file (time, capacity, cycles)

`como export` - Exports data to `como.csv` file to current directory.

`como upload` - Uploads data to server.

`como open` - Opens personal battery information page.

`como automate` - Turns scheduling on or off. Saving and Uploading.

`como init` - Quick command to get everything setup on first start.

`como reset` - Removes all entries in database.


## Advanced

`como` stores all battery information (with zlib compression) in the file `~/.como`.
You are free to do whatever you want with this data, it is yours after all.

So go out there and hack some code!

## Features ##

- Cross-Platform (Linux & Mac)
- Automatically run with `cron`/`launchd` scheduling
- Export data to `.csv` file
- Import data from `.csv` file
- Simple Statistics
- Histories for Cycles and Capacity
- Upload Data to server

## Contribute

[Fork and contribute!](https://github.com/cwoebker/como)

---

For questions and suggestions, feel free to shoot me an email at <me@cwoebker.com>.

Also, follow or tweet [@cwoebker](https://twitter.com/cwoebker).

---

Copyright (c) 2012-2020, Cecil Wöbker.
License: BSD (see LICENSE for details)