NAME

chart -- Stock and commodity price charting and downloading

SYNOPSIS

chart [--options] [symbol...]

DESCRIPTION

Chart is a stock and commodity charting program written in Perl and using the Gtk toolkit.

For a summary of the command line options run chart --help. Full documentation is provided in the manual:

doc/chart.info

Info format, can be viewed with Emacs or the stand-alone Info viewer.

lib/App/Chart/doc/chart.html

HTML, can be viewed from within Chart (Help/Manual menu entry), or with any browser.

OPTIONS

The default is to start the Gtk graphical interface, with an optional initial symbol to display. Just a part of a symbol can be given, the same as in the File/Open dialog, so for instance

    chart bh

is enough to start on BHP.AX, if that's the only "bh" in the database.

--display=DPY

Specify the X display name for Gtk. The default is the DISPLAY environment variable, as usual. This is a standard Gtk option, see the gtk-options man page for others (none of which do much).

--download

Download data for the given symbols, lists, or wildcards instead of running the GUI. For example

    chart --download BHP.AX GM
    chart --download "*.NZ"
    chart --download --all

Wildcards usually have to be quoted to stop the shell expanding them as filenames. On a tty a status line is shown with progress.

--all

The "All" list of all current symbols (ie. non-historical) for download etc.

--alerts

The "Alerts" list of symbols for download etc.

--favourites

The "Favourites" list of user symbols for download etc.

--watchlist

Start in the Watchlist dialog, with a selected symbols list, per the options above, or the Favourites list by default. For example

    chart --watchlist --all

--ticker

Run just the scrolling stock ticker display, not the whole GUI. Symbols, lists or wildcards select what to display (in order). For example

    chart --ticker BHP.AX --favourites GM "*.NZ"

--verbose

Print extra messages (to standard output). This is mainly for --download.

-v, --version

Print the program version number and exit.

-h, --help

Print a summary of the command line options and exit.

ENVIRONMENT VARIABLES

CHART_DIRECTORY

Directory name to use instead of the default ~/Chart.

HOME

For default ~/Chart directory.

TZ

Local timezone.

Chart uses LWP for various downloading. See LWP on the several environment variables it takes (such as HTTP proxies etc).

FILES

~/Chart/init.pl

User extensions (Perl code).

~/Chart/gui.pl

User GUI extensions (Perl code).

~/Chart/notes.sqdb

User annotations and saved preferences (SQLite database).

~/Chart/database.sqdb

Downloaded data (SQLite database).

SEE ALSO

gtk-options(7), info(1)

HOME PAGE

http://user42.tuxfamily.org/chart/index.html

LICENCE

Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2013, 2014, 2015, 2016 Kevin Ryde

Chart 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, or (at your option) any later version.

Chart 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 Chart; see the file @chartdatadir@/COPYING. Failing that, see http://www.gnu.org/licenses/.