battery-graph - Show a graph of the battery charge

NAME

       battery-graph - Show a graph of the battery charge

SYNOPSIS

       battery-graph [options] [files...]

DESCRIPTION

       Show a graph of the battery charge over time.

       The  files  given  are  assumed  to  contain  battery statistics in the
       battery-stats(5) format. If no files are  specified,  the  default  log
       files will be used.

       The  options  can  be  used  for  displaying  a  different interval. An
       interval is defined in terms of a from timestamp, a to timestamp and  a
       duration.   By  specifying  any  two,  the  third  will  be  calculated
       automatically. A missing duration will be defaulted to 3 hours.

OPTIONS

These programs follow the usual GNU command line syntax, with long
options starting with two dashes (‘-’).

-g geometry, --geometry geometry
Sets the X Windows geometry of the graph. This disables text
mode. See X(7) for how to specify the geometry.

-D display, --display display
Shows the graph on the given display. The same effect can be
achived by setting the DISPLAY environment variable. This
disables text mode. See X(7) for valid values.

--title string
Sets the title of the graph window. By default this will be
"Battery Graph". If this is set to the empty string, gnuplot(1)
will be allowed set the window title - this can be useful if you
want your ~/.Xdefaults to take effect for this.

-f date, --from date
Specifies the start date/time for the graph. This accepts
exactly the same date/time specifications as the date (1)
command - see examples below or the Texinfo manual for date for
details.

-t date, --to date
Specifies the ending date/time for the graph. This accepts
exactly the same date/time specifications as the date (1)
command - see examples below or the Texinfo manual for date for
details.

-s date, --since date
Shorthand for --from date --to now

-d duration, --duration duration
Specifies the duration for the graph. This can be given in units
of seconds, hours, days or weeks by suffixing the number with
’s’ (seconds), ’m’ (minutes), ’h’ (hours), ’d’ (days) or ’w’
(weeks).
Units cannot be combined - e.g. ’1d6h’ will not be valid,
whereas ’30h’ is OK. If no unit is specified, minutes will be
assumed.

--text Shows the graph in text mode on stdout. The resulting size of
the graph is determined by the values of the environment
variables. LINES and COLUMNS (failing that, the output from
tput will be used). This is the default when the environment
variable DISPLAY is not set.

EXAMPLES

       Show the last 2 hours:
              $ battery-graph --duration 2h

       Show the time since mid day:
              $ battery-graph --from 12:00 --to now
              or
              $ battery-graph --since 12:00

       Show the hour before last:
              $ battery-graph --from ’2 hours ago’ --duration 1h

       Show the 6 hours after noon:
              $ battery-graph --from 12:00 --duration 6h
              or
              $ battery-graph --from 12:00 --to 18:00

       Show the last 6 hours
              $ battery-graph --from ’6 hours ago’
              or
              $ battery-graph --since ’6 hours ago’

       Show the last 30 minutes in text mode:
              $ battery-graph --duration 30 --text

       Show statistics for Tuesday last week
              $ battery-graph --duration 24h --from ’tuesday last week’
              or
              $ battery-graph --duration 1d --from ’tuesday last week’

       Prove that the future hasn’t happened yet:
              $ battery-graph --from yesterday --to tomorrow

       Another way of wasting CPU cycles:
              $ battery-graph /dev/null

EXIT STATUS

       battery-graph depends on gnuplot (1) to give the correct exit status.

FILES

       If no files are given on the  command  line,  batter-graph  reads  from
       /var/log/battery-stats

ENVIRONMENT

       DISPLAY
              If this variable is not set, --text will be defaulted.

       LINES / COLUMNS
              Determines the size of the graph in text mode.

DIAGNOSTICS

       If  there  are  no statistics available for the period chosen, an empty
       graph will result.

NOTES

       There is no requirement for the from time to be  earlier  than  the  to
       time  -  if  so,  the  X  axis will be reversed. Similar results can be
       achieved using a negative duration.

       Also: battery-stat is quite happy to list  statistics  in  the  future;
       stupid, but obedient.

AUTHOR

       This manual page was written by Karl E. Jørgensen <karl@jorgensen.com>,
       for the Debian GNU/Linux system (but may be used by others).