This is a read-only archive. Find the latest Linux articles, documentation, and answers at the new!

Feature: Reviews

Track your investments with Grism

By Shashank Sharma on August 29, 2008 (7:00:00 PM)

Share    Print    Comments   

My dad has been pestering me for some time to find him an open source tool that he could use to follow the market trends. He's been thinking about investing a little something in the market, but not without due diligence. Grism, written in Ruby, is the tool my dad now uses to easily follow the changing market trends. It allows you to create watchlists and portfolios and offers charts to help you gauge the performance of particular stocks.

At the heart of Grism lies the YahooFinance Ruby module, which enables Grism to draw stock quotes from Yahoo! Finance. Grism has an extensive dependency list that includes Ruby, GTK+ 2.8, ruby-gtk2, and ruby-libglade2. Once you've installed these, download the latest tarball and run the command: tar zxvf grism-0.9.0.tar.gz. Browse into the newly created grism-0.9.0 directory and run the setup.rb script: ruby setup.rb.

You can then launch Grism from the terminal with the command grism, or, depending on your distribution, access it from Applications -> Office menu.

When you launch Grism, you'll see empty Watchlists and Portfolios on the left-hand sidebar. You can create as many watchlists as you want, and each watchlist can have any number of entries. You can create a new watchlist by clicking File -> New Watchlist.

After providing a name and brief description for your watchlist, you can begin to populate it with stock or mutual fund symbols. To create a new entry, click Stock -> Add Item. In the Watch List Entry dialog-box, type in the stock symbol and then specify the price of the stock. If you click the Use current market price check-box, Grism will draw the latest quote from Yahoo! Finance and use that for the entry. Unfortunately, this is where I find Grism slightly lacking, since it doesn't inform users of stock symbols. So, to create an entry for Google or Yahoo! or Apple Inc., you have to go to the Yahoo! Finance Web site and look up the stock symbols before you can create new entries in your watchlist.

If you wish to monitor the progress of Apple's stock, type AAPL in the Symbol field and click OK. When the market's open, you'll be able to see the change, previous close, and other details for this stock. If you want more details, such as the MarketCap and Dividend, click the magnifying glass icon to switch to the extended view.

Creating new portfolios is just as easy. Click New -> Portfolios and specify a name in the Portfolio Properties dialog-box. As with watchlists, Grism allows for multiple portfolios, and you can have any number of entries in each. To create a new entry, click Stock -> Add Item. After typing in the symbol for the stock, you'd have to specify whether you wish to buy or sell, so click on the appropriate radio button. Next, specify the number of shares you wish to trade. Click the "use current market price" check-box if you wish to buy or sell your shares at the market price, or type in the amount of your choice in the Price field. You can also enter the Transaction Cost in the Add to Portfolio dialog box.

When the markets are open, click Folder -> Refresh to get the latest quotes. Grism will show the change in the stock price for the current day, and the overall change from the time you created the new entry.

To check the performance of your stock, click Stock -> Chart. By default, Grism draws the chart for a one-year time period, but you can select a time period anywhere from a week to 10 years by clicking the drop-down list. Grism draws only two items on the charts, the stock price and its volume. To export the chart, click the icon on the top right of the window. Unfortunately, Grism exports the charts only to a PNG image, but it allows you to specify the dimension for the image.

You can move entries from one portfolio or watchlist to another. Once you've selected an entry in your watchlist or portfolio, click Stock -> Move to, and select where you wish to move it from the list. Grism also keeps a record of all your transactions, so you can click the Portfolio History icon for details of what shares you've bought and sold, at what prices and on what dates. Grism records all data in the ~/.grism directory.

As of now, Grism can only draw quotes from Yahoo! Finance, and there's no easy way to change this, since, according to developer Nicholas Rahn, "the yahoofinance module is 'hardwired' into the Grism code."


Grism is a great tool to familiarize yourself with the market before you take the plunge, and also to keep track of your actual investments, but it does have some minor quirks. These include its inability to suggest symbol names for stocks, and the fact that when you click Stock -> Refresh, Grism doesn't draw the latest quotes for all your portfolios and watchlists, but just the one that you have selected. Also, the quotes Grism draws from Yahoo! Finance are delayed 15-20 minutes. Despite these issues, I find Grism a useful tool for anyone interested in financial markets.

Shashank Sharma specializes in writing about free and open source software for new users and moderates the forum boards. He is the coauthor of Beginning Fedora, published by Apress.

Share    Print    Comments   


on Track your investments with Grism

Note: Comments are owned by the poster. We are not responsible for their content.

Track your investments with Grism

Posted by: Anonymous [ip:] on August 29, 2008 08:19 PM
Thanks for the informative article about Grism!

One small thing I would like to point out is that you can refresh all of your portfolios and watchlists at once by clicking File -> Refresh All or by just hitting F9.

Nicholas Rahn


Seems pointless. Why not just use Yahoo Finance directly?

Posted by: Anonymous [ip:] on August 31, 2008 09:47 AM
Apart from putting an extra layer of software between the user and Yahoo Finance, what exactly does Grism do?

All the functionality described in the article (and a lot more) is available from Yahoo Finance directly.

If Grism let you specify some other source of data, it just might be useful. But it doesn't - Yahoo Finance is apparently "hardwired" into the code.


Eclipse Trader might help dad...

Posted by: Anonymous [ip:] on August 31, 2008 04:53 PM
I wouldn't want to discourage a project that could be so potentialy useful, but based on this review Eclipse Trader is far more functional. Candles, filters, MA, A/D...the list of technical analysis tools is quite impressive.


RE: Yahoo Finance directy and Eclipse Trader

Posted by: Anonymous [ip:] on September 12, 2008 03:45 PM
Anonymous #1: YahooFinance offers more functionality than Grism, for sure. However, can you see how each watchlist/portfolio is doing without switching to it? Can you switch to a watchlist/portfolio with 1 click? Can you see basic fundamental data with 1 click? I find Grism's interface to be more convenient for the functionality that it does offer. And for the paranoid among us, your portfolio information is on your computer, not on Yahoo's servers.

Anonymous #2: Eclipse Trader is a well done application with lots of functionality especially on the technical analysis (TA) side. If you're really into TA, Eclipse Trader is probably the best open source application out there. However, if you're not into TA or a massive GUI with flashing Level II quotes and blinking option spreads, but just want to track your portfolios and watchlists in a convenient interface, you might want to take a second look at Grism.


This story has been archived. Comments can no longer be posted.

Tableless layout Validate XHTML 1.0 Strict Validate CSS Powered by Xaraya