Yahoo Finance Quotes

UUID: yfquotes@thegli
Last edited:
2 weeks ago 2020-10-04, 12:17
Last commit: [476a86b5] new options for style and behavior

Displays financial market information such as stock quotes and commodity prices from Yahoo Finance

README

Close

Cinnamon Desklet for Yahoo Finance quotes

Description

This repository contains a desklet for the Cinnamon desktop environment that displays financial market information provided by Yahoo Finance.

Screenshot

This desklet is based on the desklet from fthuin. The data retrieval part is adopted to an alternative service url, after the Yahoo Finance community table got retired in May 2017.

Tested with

  • Linux Mint Cinnamon 17 up to 20
  • Debian 9 with Cinnamon 3.2
  • Manjaro with Cinnamon 3.8

Installation

Either follow the installation instructions on Cinnamon spices, or manually download the folder yfquotes@thegli (below "files") and copy the folder and its content to ~/.local/share/cinnamon/desklets/.

Configuration

Check out the desklet configuration settings, and choose the data refresh period, the list of quotes to show (see also Known Limitations), and quote details to display. The default list contains the Dow 30 companies.

Release Notes

0.5.0 - October 4, 2020

Features:

  • new setting to color percentage change according to trend. Enabled by default if percentage change is displayed. Courtesy of plaihonen.
  • new setting to add Yahoo Finance hyperlink to symbol/quote. Enabled by default if symbol is displayed. Proposed by ngaro.
  • new setting to use long version for verbose quote name. Enabled by default if verbose name is displayed. Courtesy of ngaro.

0.4.2 - September 20, 2020

Bugfixes:

  • update translation files with new setting
  • extend desklet description for better searchability

0.4.1 - August 18, 2020

Features:

  • add setting to disable quote name hyperlink

Bugfixes:

  • remove invalid quote symbol from default list

0.4.0 - July 17, 2020

Features:

  • allow multiple Desklet instances
  • add German translation

0.3.0 - June 29, 2020

Features:

  • add setting to sort quotes list
  • update DOW 30 component symbols

Bugfixes:

  • auto-retry in case of connection problem (e.g. TLS handshake)

0.2.0 - May 23, 2018

Features:

  • show absolute price change amount
  • show last trade time/date
  • show timestamp of latest data refresh
  • add setting to configure rounding rule
  • make background transparency configurable
  • quote name links to Yahoo Finance details page
  • display severe errors such as network failure

Bugfixes:

  • improve error handling

0.1.0 - May 6, 2018

Features:

  • minor description adjustments in configuration settings

Bugfixes:

  • fix "value "nan" of type 'gfloat' is invalid or out of range for property" errors logged in .xsession-errors
  • works (again) with Cinnamon 3.2

0.0.1 - May 4, 2018

Features:

  • setting to show/hide the currency symbol

Bugfixes:

  • change data retrieval to alternative url from Yahoo Finance

Known Limitations

  • The quotes list might not be editable using the desklet's configuration dialog (encountered in Cinnamon 3.6 and earlier 3.x versions). As a workaround, export the configuration using the standard desklet settings menu to a (json) file, then edit the file with your favorite text editor, and finally import the configuration file again.

Credits

Based on the desklet source code from fthuin.

License

GNU General Public License v3.0

Log In To Comment!

8 Comments

plaihonen
plaihonen-3 weeks ago
Hi, quite useful desklet. I have some suggestions though. * Title on top of the desklet. This would be useful if more than one instance. The "updated" info could be moved from the bottom to the top with the title. * Option to add divider. This could be something like "---" in the quote symbols list. I have no clue how challenging this would be to program with the existing sorting functionality. * Option to align left. This would improve readability. At least with the longer "Verbose name" the impact would be significant.
Thomas Egli
Thomas Egli-2 weeks ago
I remember that I tried left alignment once. If the listed quote names have more or less the same length, then it looks better than centered, but if you have a mix of very short and very long names, then I felt that there is too much space to the next column. So I kept the center alignment, as I couldn't come up with something better, and in the meantime I got used to it. Regarding title and divider/spacer: I never thought about that but the sorting would definitely be a bit of a challenge.
jupiterjosh
jupiterjosh-1 month ago
Excellent desklet! May I make a suggestion that you include words like "stock" or "ticker" in your desklet description? You may find more people downloading the desklet if you add those words. I only found the spice by googling it, but since I was using the words "stock", "price", "ticker" etc, this desklet didn't come up in the desklet search bar.
Thomas Egli
Thomas Egli-4 weeks ago
Happy you like it. And thanks for your suggestion. I will improve the description in a future update.
newlinuxuser
newlinuxuser-3 months ago
Hi. how to add currency pairs?
Thomas Egli
Thomas Egli-3 months ago
Currency pair symbols follow the pattern "[Target Currency][Base Currency]=X", for instance "EURUSD=X". You can look them up on https://finance.yahoo.com/currencies.
Xcelerate11
Xcelerate11-4 months ago
This desklet is amazing! Does anyone know how I can create multiple instances of this desklet?
Thomas Egli
Thomas Egli-3 months ago
With the latest version, you can now create up to 10 instances.