NAME

       sdcv - console version of StarDict program

SYNOPSIS

       sdcv [ options ] [list of words]

DESCRIPTION

       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.

OPTIONS

       -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).

FILES

       /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

       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.

BUGS

       Email  bug  reports  to  dushistov  at  mail  dot ru. Be sure to include the word "sdcv" somewhere in the
       "Subject:" field.

AUTHORS

       Evgeniy A. Dushistov, Hu Zheng

SEE ALSO

       stardict(1), http://sdcv.sourceforge.net/, http://stardict.sourceforge.net