View on
Kevin Ryde > chart > chart


Annotate this POD



New  16
Open  4
View/Report Bugs


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.



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

syntax highlighting: