https://github.com/d-e-s-o/dictcc-cli
A command line application for translating between languages using dict.cc's database.
https://github.com/d-e-s-o/dictcc-cli
dictionary dictionary-application rust
Last synced: 14 days ago
JSON representation
A command line application for translating between languages using dict.cc's database.
- Host: GitHub
- URL: https://github.com/d-e-s-o/dictcc-cli
- Owner: d-e-s-o
- License: gpl-3.0
- Created: 2018-01-09T18:21:10.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-02-09T17:40:21.000Z (over 4 years ago)
- Last Synced: 2025-11-29T14:17:24.605Z (7 months ago)
- Topics: dictionary, dictionary-application, rust
- Language: Rust
- Homepage:
- Size: 587 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
dictcc-cli
==========
- [Changelog](CHANGELOG.md)
Purpose
-------
**dictcc-cli** is a command line interface to
[dict.cc](https://www.dict.cc/). As such, it provides the capability to
translate words and phrases between languages. However, instead of
interacting with the online service it relies on its database for the
translation. This database has to be [retrieved
manually](#language-database).
Usage
-----
Being intended to be simple and fast to use, translating a term using
**dictcc-cli** is as simple as providing it as an argument to the
program:
```bash
$ dictcc-cli dictcc-lp1.db durchgeknallt
> durchgeknallt [ugs.] (adj): crazed
> durchgeknallt [ugs.] (adj): cuckoo [coll.]
> durchgeknallt [ugs.] (adj adv): loopy [coll.]
```
Note that the source an destination languages depends on the database
being used. In the example above the German database maps from German to
English and so this is the default direction of translation.
To translate the other way, the `-r/--reverse` option can be used:
```bash
$ dictcc-cli dictcc-lp1.db --reverse dorky
> dorky [coll.] (adj): bekloppt [ugs.]
> dorky [coll.] (adj): idiotisch
> dorky [coll.] (adj): deppert [österr.] [südd.]
```
Installation
------------
#### From Source
In order to compile the program the `sqlite` crate needs to be available
which allows access to the dict.cc database. This crate and its dependencies
are contained in the form of subrepos in compatible and tested versions. Cargo
is required to build the program.
The build is as simple as running:
```bash
$ cargo build --release
```
#### Language Database
The database containing the translations has to be retrieved separately
as there are various languages and sizes available. One possible way is
to install the dict.cc app on an Android phone, install the desired
language pack, and then copy the file `cc.dict.dictcc/dictcc-lp1.db` to
the device running **dictcc-cli**.