This repository contains a desklet for the Cinnamon desktop environment that displays financial market information provided by Yahoo Finance.
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 21
- Debian 9 with Cinnamon 3.2
- Manjaro with Cinnamon 3.8
- Fedora 38 Cinnamon Spin with Cinnamon 5.6 and libsoup3
Either follow the installation instructions on Cinnamon spices (recommended), or manually download the directory yfquotes@thegli (below "files") and copy the directory and its content to ~/.local/share/cinnamon/desklets/
Check out the desklet configuration settings, and choose the data refresh period, the list of quotes to show, and quote details to display. The default list contains the Dow 30 companies.
Problem: The desklet fails to load data, and shows error message "Status: 429 Too Many Requests".
Solution: Enable option Send custom User-Agent header found on the first tab "Quotes" in the configuration settings.
Only enable debug logging in case of problems, and when you know why you need it!
The log output goes to the standard file ~/.xsession-errors. All log messages produced by this desklet contain "yfquotes@thegli", so we can filter by this text. By default, the desklet logs only abnormal situations.
Significantly more log output can be generated when the debug log mode is active.
To activate the debug log mode, create an empty file "DEBUG" in the desklet installation directory, e.g. with the command touch ~/.local/share/cinnamon/desklets/yfquotes@thegli/DEBUG
Then the Cinnamon desktop needs to be restarted in order to re-initialize the desklet. This can be done by pressing Ctrl-Alt-Esc, or by logout/login.
To disable the debug log mode, delete the "DEBUG" file, and restart the Cinnamon desktop.
Features:
- new setting to manually update data by clicking on the "last update" timestamp label
- add Dutch translation (courtesy of qadzek)
- update Spanish translation (courtesy of haggen88)
Features:
- new setting to customize font color and font size
- new setting to customize date and time format (see date man page for options)
- new setting to control vertical scrollbar
Features:
- add Spanish translation (courtesy of haggen88)
- add Finnish translation (courtesy of MahtiAnkka)
- update Hungarian translation (courtesy of KAMI911)
- update Danish translation (courtesy of Alan01)
- update Italian translation (courtesy of Dragone2)
- brush up this README document
- implement an optional debug log mode for tracing and analysis of unexpected problem situations
Bugfixes:
- handle HTTP response status codes not supported by libsoup3
- update DOW 30 component symbols
Features:
- support cookie consent process for EU region
- setting for User-Agent header is now active by default
- include status details in error message
- add Romanian translation (courtesy of AndreiMiculita)
Bugfixes:
- remove obsolete setting to select Yahoo Finance Quotes API version, because V6 got disabled
- general code refactoring, and logging improvements
Features:
- add setting to include a User-Agent header in Yahoo Finance Quotes API requests
- update Hungarian translation (courtesy of KAMI911)
Bugfixes:
- fix libsoup3-specific code
Bugfixes:
- adapt to recent changes in Yahoo Finance Quotes API
Features:
- new setting to select the version of Yahoo Finance Quotes API
- update Danish translation (courtesy of Alan01)
- update Hungarian translation (courtesy of KAMI911)
- update Italian translation (courtesy of Dragone2)
Bugfixes:
- add support for libsoup3 (courtesy of fredcw)
Bugfixes:
- check timer reference before calling Mainloop.source_remove()
Features:
- update Brasilian and German translations
- fetch finance data asynchronously to improve responsiveness
Bugfixes:
- do not color percentage change value when corresponding setting is not selected
- increase default desklet width
- update screenshot image
- fix syntax errors in README.md
Features:
- add Russian translation (courtesy of sulonetskyy)
Features (courtesy of sulonetskyy):
- add symbolic trend change icons instead of .svg
- add configurable trend change colors instead of hardcoded colors
- add configurable strict rounding
- add UAH and RUB currency symbols
- change table items view (text align to the left, numbers/dates align to the right)
Features:
- change layout of settings dialog to tabbed views
- new setting to use alternative colors (use blue instead of green)
- add Hungarian translation (courtesy of KAMI911)
Features:
- add Italian translation (courtesy of Dragone2)
- add Korean translation (courtesy of chaeya)
- optimize png files (courtesy of NikoKrause)
Bugfixes:
- correct a msgid in translation files
Features:
- incorporate Danish translation (courtesy of Alan01)
Bugfixes:
- update DOW 30 component symbols
- resolve various issues reported by Codacy
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.
Bugfixes:
- update translation files with new setting
- extend desklet description for better searchability
Features:
- add setting to disable quote name hyperlink
Bugfixes:
- remove invalid quote symbol from default list
Features:
- allow multiple desklet instances
- add German translation
Features:
- add setting to sort quotes list
- update DOW 30 component symbols
Bugfixes:
- auto-retry in case of connection problem (e.g. TLS handshake)
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
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
Features:
- setting to show/hide the currency symbol
Bugfixes:
- change data retrieval to alternative url from Yahoo Finance
Based on the desklet source code from fthuin.
GNU General Public License v3.0