Financial Stats

Description

KDE Plasma widget that displays financial stats. It supports Bitcoin (BTC), Gold (Au), Silver (Ag) and ratios between them. Optionally it can display value of user's "stack" after taxes.

Many features are configurable:

More screenshots are in: docs

Goal

The widget is intented to provide quick glance values (panel widget) and detailed stats (using hover-on pop-up text) of major Financial Items like Bitcoin, Gold and Silver.

Installing/Updating

From shell:

• Update

wget https://github.com/eugenesan/finstats/releases/latest/download/finstats-v0.9.x.plasmoid -O ${TMPDIR:-/tmp}/finstats.plasmoid && kpackagetool6 -t Plasma/Applet -u ${TMPDIR:-/tmp}/finstats.plasmoid && systemctl --user restart plasma-plasmashell.service

• Install

wget https://github.com/eugenesan/finstats/releases/latest/download/finstats-v0.9.x.plasmoid -O ${TMPDIR:-/tmp}/finstats.plasmoid && kpackagetool6 -t Plasma/Applet -i ${TMPDIR:-/tmp}/finstats.plasmoid && systemctl --user restart plasma-plasmashell.service

Manual with Plasma UI:

• Install via "Add Widgets..." -> "Get New Widgets..." -> "Download..."
• Install from KDE Store
• Download Latest *.plasmoid from Releases page and install it via "Add Widgets..." -> "Get New Widgets..." -> "Install Widget From Local file"

In cases of panel freezes or crashes 🆘

There is a chance that the widget will be incompatible with your OS distribution. In such cases you can use the following script to downgrade the panel version:

wget https://github.com/eugenesan/finstats/releases/download/v0.6.8/finstat.plasmoid -O ${TMPDIR:-/tmp}/finstat.plasmoid && kpackagetool6 -t Plasma/Applet -u ${TMPDIR:-/tmp}/finstat.plasmoid && systemctl --user restart plasma-plasmashell.service

Or you can remove the widget:

kpackagetool6 --type Plasma/Applet --remove com.github.eugenesan.finstat

Please, don't forget to fill the report about the issues.

Debugging

Links:

• https://develop.kde.org/docs/plasma/widget/properties/
• https://develop.kde.org/docs/features/configuration/porting_kf6/
• https://develop.kde.org/docs/plasma/widget/testing/

Useful shell commands:

$ systemctl --user restart plasma-plasmashell
$ plasmoidviewer --applet com.github.eugenesan.finstats
$ plasmawindowed com.github.eugenesan.finstats
$ plasmapkg2 -i .
$ export QML_XHR_DUMP=1
$ export QT_LOGGING_RULES="*.debug=true; qt.*.debug=false"

License

This project is licensed under the GPL-3.0-or-later License - see the LICENSE file for details

Contributions

Pull requests and Issue reports are always welcome.

Acknowledgments

• antroids for providing a template for this applet application-title-bar

• spmdrd for providing inspiration for this applet plasma-applet-cryptocurrency-price