Kevin Ryde


chart -- Stock and commodity price charting and downloading


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


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:


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


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


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.


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 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.


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


The "Alerts" list of symbols for download etc.


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


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

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"

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.



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


For default ~/Chart directory.


Local timezone.

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



User extensions (Perl code).


User GUI extensions (Perl code).


User annotations and saved preferences (SQLite database).


Downloaded data (SQLite database).


gtk-options(7), info(1)



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