2015 MATE Documentation Project 2004 2005 Raphael Slinckx 2007 Terrence Hall 2010 Enrico Minack MATE Documentation Project GNOME Documentation Project &legal; MATE Documentation Team GNOME Documentation Team Terrence Hall

teebob21@gmail.com

Enrico Minack

enrico-minack@gmx.de

&app; V&manrevision; &date; MATE Documentation Team MATE Documentation Project This manual describes version &appversion; of &app;. To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the MATE Feedback Page. User manual for &app; Invest invest-applet The &app; MATE panel applet downloads current quotes for stocks, stock indices, currencies and precious metals. Quotes are downloaded from Yahoo! Finance and are displayed directly in the panel with automatic cycling through multiple stocks. &app; provides the following features: Retrieve quotes for any stock, stock index, currency or precious metal known by Yahoo! Finance Quotes are automatically updated every 15 minutes (configurable from 1-60 minutes) Current stock symbol, price, and percentage change are displayed directly in the panel Direction indicator icons show whether stocks are up, down, or neutral Multiple stocks automatically cycle through the display every 5 seconds (configurable from 1-60 seconds) Click on the applet to manually cycle to the next configured stock Tooltip shows summary of all configured stocks with current prices and changes To add &app; to a MATE panel, right-click on the panel, then choose Add to Panel. Select &app; in the Add to Panel dialog, then click OK. Click Close when finished. To remove &app; from a MATE panel, right-click on the icon, then choose Remove From Panel. More information about the MATE panel can be found in the MATE Panel documentation. Before the applet can provide you with recent quotes, you have to configure it with stock symbols. Once configured, the applet will display stock information directly in the panel and automatically cycle through multiple stocks. You can click on the applet to manually advance to the next stock, or right-click for options to refresh data and configure preferences. To add new quotes to &app;, perform the following steps: Right-click on the applet icon, and select Preferences. In the Stock symbols field, enter the symbols of the stocks you want to track, separated by commas. For example: AAPL,GOOGL,MSFT Optionally, configure the Refresh interval (how often to download new quotes, in seconds). Optionally, configure the Cycle interval (how often to cycle through different stocks in the display, in seconds). Click OK when you are finished configuring. If you do not know the actual symbol of your quote, go to http://finance.yahoo.com/. Enter the name of the quote in the text field in the upper-left corner of the screen. While typing, it will list you matching quotes. The first column depicts the symbol of the quote, the second column shows the name, and in the third column, the stock exchange of the quote is listed. The currency of the quote may vary among different stock exchange centers, depending on their respective countries. Below, you can see a screenshot of searching for the "yahoo" quote. Screenshot of Yahoo! Finance when searching a quote. &app; supports all quotes that can be found at Yahoo! Finance. In particular, these are of the following type. These are the majority of quotes that are available. Search or browse on Yahoo! Finance to find out what is there. All quotes that start with an ^ are actually indices, a quote that represents a number of other quotes' performance. Examples are the Dow Jones Industrial Average (^DJI) and the NASDAQ Composite (^IXIC). Exchange rates between any two currencies are also available. The respective symbol is constructured as follows. Currency AAA in currency BBB, or in other words, how much does currency AAA cost in currency BBB, has the symbol AAABBB=X. If you want to know how much EUR you get for one USD (how much does one USD cost in EUR), you choose USDEUR=X. You can find more information at the currency page of Yahoo! Finance. Currencies are represented using their ISO 4217 currency code. The ISO 4217 currency code also lists precious metals as currencies. These are Gold, Silver, Palladium and Platinum. Their currency code starts with X, followed by their chemical symbol: XAU, XAG, XPD, and XPT, respectively. With those currency codes, the rate of precious metals in any currency are available via the currency rates described above. To give an example, Gold in USD has the symbol XAUUSD=X. You can even get the reverse (USDXAU=X): how much Gold measured in troy ounce do you get for one USD? Your configured quotes are displayed directly in the panel next to the direction indicator icon. The display shows the current stock symbol and price (e.g., "AAPL: $150.25"). If you have multiple stocks configured, they will automatically cycle through the display. You can also click on the applet to manually advance to the next stock. Hover over the applet to see a tooltip with all configured stocks and their current prices and changes. To immediately update the information that is displayed in the applet, right-click on the applet, then choose Refresh. To remove quotes from &app;, perform the following steps: Right-click on the applet icon, and select Preferences. In the Stock symbols field, edit the comma-separated list to remove the symbols you no longer want to track. Click OK when you are finished. &app; displays quotes directly in the panel and automatically cycles through multiple stocks if configured. The applet shows: Direction Icon - Shows an up arrow (green) for positive change, down arrow (red) for negative change, or neutral icon for no change Stock Information - Displays the current stock symbol and price (e.g., "AAPL: $150.25") Automatic Cycling - If multiple stocks are configured, the display automatically cycles through them every few seconds Manual Cycling - Click on the applet to manually advance to the next stock Tooltip Summary - Hover over the applet to see a tooltip with all configured stocks, their current prices, and percentage changes Quotes are displayed in their original currency as retrieved from Yahoo! Finance. The current version does not support currency conversion or portfolio tracking features.