Update README, add a screenshot

I've given up on the idea of a "proper" TUI framework.

I've also learnt that Wayland isn't a completely dead end.
This commit is contained in:
Přemysl Eric Janouch 2021-07-23 20:43:53 +02:00
parent 87f90f6420
commit 4245dc35df
Signed by: p
GPG Key ID: A0420B94F92B9493
2 changed files with 12 additions and 9 deletions

View File

@ -2,13 +2,16 @@ StarDict Terminal UI
==================== ====================
'sdtui' aims to provide an easy way of viewing translation as well as other 'sdtui' aims to provide an easy way of viewing translation as well as other
kinds of dictionaries in your terminal. I wasn't successful in finding any free kinds of dictionaries in your terminal, and is inspired by the dictionary
dictionary software of this kind, GUI or not, and thus decided to write my own. component of PC Translator. I wasn't successful in finding any free software
of this kind, GUI or not, and thus decided to write my own.
The project is covered by a permissive license, unlike vast majority of other The project is covered by a permissive license, unlike vast majority of other
similar projects, and can serve as a base for implementing other dictionary similar projects, and can serve as a base for implementing other dictionary
software. I wasn't able to reuse _anything_ for StarDict. software. I wasn't able to reuse _anything_ for StarDict.
image::sdtui.png[align="center"]
Further Development Further Development
------------------- -------------------
While I've been successfully using sdtui for a long time now, some work has to While I've been successfully using sdtui for a long time now, some work has to
@ -17,11 +20,8 @@ Linux and/or BSD distributions. Help is much appreciated.
An approximate list of things that need to be resolved: An approximate list of things that need to be resolved:
- rewrite the frontend using a proper TUI framework - the tab bar and the text input field don't handle overflows well
- possibly make it work better with multiple dictionaries as now it's only - figure out a way to become capable of displaying most StarDict dictionaries
acceptable if you give them short names in the configuration so that they
all fit in the header
- figure out a way to become capable of displaying most dictionaries
Packages Packages
-------- --------
@ -32,7 +32,7 @@ Building and Running
-------------------- --------------------
Build dependencies: CMake, pkg-config, asciidoctor + Build dependencies: CMake, pkg-config, asciidoctor +
Runtime dependencies: ncursesw, zlib, ICU, termo (included), Runtime dependencies: ncursesw, zlib, ICU, termo (included),
glib-2.0, pango, xcb and xcb-xfixes (optional) glib-2.0, pango, xcb, xcb-xfixes (the latter two optional)
$ git clone --recursive https://git.janouch.name/p/sdtui.git $ git clone --recursive https://git.janouch.name/p/sdtui.git
$ mkdir sdtui/build $ mkdir sdtui/build
@ -82,7 +82,8 @@ odd = 16 255
The `watch-selection` option makes the application watch the X11 primary The `watch-selection` option makes the application watch the X11 primary
selection for changes and automatically search for selected text. selection for changes and automatically search for selected text.
This feature requires XCB and it will never work on Wayland by its design. This feature requires XCB. Wayland is currently unsupported, but would require
a compositor supporting the wlr-data-control protocol.
You can also set up some dictionaries to be loaded at startup automatically: You can also set up some dictionaries to be loaded at startup automatically:
@ -92,6 +93,8 @@ name1 = ~/path/to/dict.ifo
name2 = ~/another/dict.ifo name2 = ~/another/dict.ifo
.... ....
The names define how they will appear in the tab bar.
Dictionaries Dictionaries
------------ ------------
Unfortunately this application only really works with specific dictionaries. Unfortunately this application only really works with specific dictionaries.

BIN
sdtui.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB