sdcv − console version of StarDict program
sdcv [ options ] [list of words]
sdcv is a simple, cross-platform text-based utility for working with dictionaries in StarDict format. Each word from "list of words" may be a string with a leading ’/’ for using a Fuzzy search algorithm, with a leading ’|’ for using full-text search, and the string may contain ’?’ and ’*’ for regexp search. It works in interactive and non-interactive mode. To exit from interactive mode press Ctrl+D. In interactive mode, if sdcv was compiled with readline library support, you can use the UP and DOWN keys to cycle through history.
−h −−help
Display help message and exit
−v −−verbose
Display version and exit
−l −−list−dicts
Display list of available dictionaries and exit
−u −−use−dict filename
For search use only dictionary with this bookname
−n −−non−interactive
For use in scripts
−x −−only−data−dir
For use in scripts: only use the dictionaries in data-dir, do not search in user and system directories
−e −−exact−search
Do not fuzzy-search for similar words, only return exact matches
−j −−json
Print the results of list-dicts and searches as json, not as plain text. For use in automatically processing the results of a dictionary lookup.
−−utf8−output
Force sdcv to not convert to locale charset, output in utf8
−−utf8−input
Force sdcv to not convert from locale charset, assume that input is in utf8
−−data−dir path/to/directory
Use this directory as the path to the stardict data directory. This means that sdcv searches for dictionaries in data-dir/dic directory.
−−color |
Use ANSI escape codes for colorizing sdcv output (does not work with json output). |
/usr/share/stardict/dic
$(HOME)/.stardict/dic
Place where sdcv expects to find dictionaries. Instead of /usr/share/stardict/dic you can use any directory you want, just set the STARDICT_DATA_DIR environment variable. For example, if you have dictionaries in /mnt/data/stardict-dicts/dic, set STARDICT_DATA_DIR to /mnt/data/stardict-dicts.
$(HOME)/.sdcv_history
This file includes the last $(SDCV_HISTSIZE) words, which you sought with sdcv. SDCV uses this file only if it was compiled with readline library support.
$(HOME)/.sdcv_ordering
This is a text file containing one dictionary bookname per line. It specifies in which order the results of a search should be shown.
Environment Variables Used By sdcv:
STARDICT_DATA_DIR |
If set, sdcv uses this variable as the data directory, this means that sdcv searches dictionaries in $STARDICT_DATA_DIR\dic |
||
SDCV_HISTSIZE |
If set, sdcv writes in $(HOME)/.sdcv_history the last $(SDCV_HISTSIZE) words, which you look up using sdcv. If it is not set, then the last 2000 words are saved in $(HOME)/.sdcv_history. |
||
SDCV_PAGER |
If SDCV_PAGER is set, its value is used as the name of the program to use to display the dictionary article. |
Email bug reports to dushistov at mail dot ru. Be sure to include the word "sdcv" somewhere in the "Subject:" field.
Evgeniy A. Dushistov, Hu Zheng
stardict(1), http://sdcv.sourceforge.net/, http://stardict.sourceforge.net