https://github.com/johnfactotum/quick-lookup
Simple GTK dictionary application powered by Wiktionary
https://github.com/johnfactotum/quick-lookup
dictionary gjs gtk wiktionary
Last synced: 29 days ago
JSON representation
Simple GTK dictionary application powered by Wiktionary
- Host: GitHub
- URL: https://github.com/johnfactotum/quick-lookup
- Owner: johnfactotum
- License: gpl-3.0
- Created: 2019-09-16T04:26:39.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-02-13T07:22:38.000Z (3 months ago)
- Last Synced: 2025-03-30T05:07:59.396Z (about 1 month ago)
- Topics: dictionary, gjs, gtk, wiktionary
- Language: JavaScript
- Size: 889 KB
- Stars: 94
- Watchers: 7
- Forks: 9
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# Quick Lookup
Quick Lookup is a simple GTK dictionary application powered by [Wiktionary](https://en.wiktionary.org/)™.
## Features
- Lookup definitions for words or phrases using the [Wikimedia REST API of Wiktionary](https://en.wiktionary.org/api/rest_v1/#/Page%20content/get_page_definition__term_)
- Choose language by entering language name or ISO-639-1 code (e.g., "English" or "en")
- Open internal links within the app
- Go back to previous page with the back button
- Look up selected text from any app by setting a keyboard shortcut to launch this app with the `--selection` command line option
## Installation
Dependencies:
- `gjs (>= 1.70)`
- `gtk4`
- `libadwaita (>= 1.4)`
- `webkitgtk-6.0`
To install, run `meson builddir && sudo meson install -C builddir`
To uninstall, run `sudo meson uninstall -C builddir`
An [AUR package](https://aur.archlinux.org/packages/quick-lookup/) is available for Arch Linux and derivatives.
### Run without installing
```bash
gjs quick-lookup.js
```
### Flatpak
#### Building Flatpaks manually
##### Using Gnome Builder
Open [Gnome Builder](https://wiki.gnome.org/Apps/Builder), choose "Clone Repository…", and follow the instructions. After cloning the project, hit Ctrl+F5 to build and run.
##### Using `flatpak-builder`
```bash
flatpak-builder --force-clean --install --user build com.github.johnfactotum.QuickLookup.json
```
## FAQ
### Why does it only support English Wiktionary?
This app only supports the [English version](https://en.wiktionary.org/) of [Wiktionary](https://www.wiktionary.org/). This means that you can lookup all words of all languages and find their definitions and descriptions in English.
This is because Wiktionary's definition API is currently only available for English. Explanation from [MediaWiki](https://www.mediawiki.org/wiki/Wikimedia_Apps/Wiktionary_definition_popups_in_the_Android_Wikipedia_app):
> Wiktionary content is unstructured, and presenting a concise set of definitions requires parsing them from the page HTML. English Wiktionary has an entry layout guide which assisted in this for the current English-only implementation.
### Why is WebKit a dependency?
Because I'm lazy and I used the DOM APIs provided by WebKit to manipulate HTML markups.
### Will you add support for other online/offline dictionaries?
Probably not, because I'm lazy.
---
Wiktionary is a trademark of the Wikimedia Foundation. This program is not endorsed by or affiliated with the Wikimedia Foundation.