zefr0x / krunner-currency

A KRunner plugin for converting currency using DuckDuckGo spice API. You may also use a proxy, and you can use it as a python module.

Warning : This repository/project is no longer maintained. I'm no longer using KDE's KRunner. If you are interested in the plugin, it's free software under the GPL-3.0 license, so you can create a fork and do any thing you want with it.

If you want an alternative, Qalculate! is a good project, you can convert currencies using it.

Warning This plugin is not well tested and it should be improved. Don't use it for sensitive operations.

KRunner Currency

A KRunner plugin for converting currencies using DuckDuckGo spice API.

Installation

Dependencies

• python-requests

If you dan't have requests installed the install.sh script will use pip to install it.

Install from git source code

Go to the directory that you want to keep the code in it, for example /home/<username>/.local/share/krunner-sources/.

$ git clone https://github.com/zer0-x/krunner-currency.git
$ cd krunner-currency
$ ./install.sh

🔴 Don't delete the source code after the installation.

Uninstall

Go to the source code directory and run the uninstall script:

$ ./uninstall.sh

Install from the kde store

1. Open system settings
2. Go to search > KRunner
3. Click on Get New Plugins...
4. Search for the Plugin
5. Click Install

Uninstall

Please run the uninstall script manually, because the GUI will remove the script before running it.

Usage

terms

You are able to use any type of the following terms:

• 13 SAR USD
• 13.64 sar usd
• 13 SAR $
• 13 SR $
• 13 US euro - Not available yet.
• 13 dollars riyal - Not available yet.

Not all the currencies are supporter when using a symbol or a name. Take a lock on the data/ directory.

qeury

1. Type the keyword ~ in KRunner.
2. type <Space> and then writer your conversion term.
3. Click <Enter> to flip the conversion.
4. Also you are able to use the actions to copy the result, copy the conversion or copy the URL for the conversion in xe.com

Privacy

The amount to be converted will not be sent to the API, but it will query the value of 1 currency unit to get the rate, then it will do the conversion locally.

Using tor or any proxy

If i found a good reference for the Config method in KRunner i would've done this in a UI, but i didn't so you need to edit the source code for that feature.

Go to the source directory and open 'converter.py', then comment and uncomment the following lines:

• Use an onion URL if you want to use tor:

@@ -10,6 +10,6 @@
- BASE_API_URL = "https://duckduckgo.com/js/spice/currency"
+ # BASE_API_URL = "https://duckduckgo.com/js/spice/currency"
- # BASE_API_URL = (
- #     "https://duckduckgogg42xjoc72x3sjasowoarfbgcmvfimaftt6twagswzczad.onion/"
- #     + "js/spice/currency"
- # )
+ BASE_API_URL = (
+     "https://duckduckgogg42xjoc72x3sjasowoarfbgcmvfimaftt6twagswzczad.onion/"
+     + "js/spice/currency"
+ )

• Specify a proxy to be used by the requests session:

@@ -17,5 +17,5 @@
- PROXIES: dict = {}
+ # PROXIES: dict = {}
- # PROXIES = {
- #     "http": "socks5h://127.0.0.1:9050",
- #     "https": "socks5h://127.0.0.1:9050",
- # }
+ PROXIES = {
+     "http": "socks5h://127.0.0.1:9050",
+     "https": "socks5h://127.0.0.1:9050",
+ }

Usage as a python module

import converter
convert = converter.Converter()

# Parsing the input then returning the result
term = "48.120 eur sa"
result = convert(term)
# Or giving direct data without the need te be parsed
# amount: float, from_currency: str, to_currency: str
result = convert.get_results(48.120, "EUR", "SAR")

Todo list

• Find better keyword
• Support convert by name by creating names dict
• Support convert by localized names
• Localize the displayed currencies names