https://github.com/benmanone/minicloze

Rust-based command-line language-learning game. Uses the Tatoeba database.
https://github.com/benmanone/minicloze

command-line game language-learning language-learning-game lightweight linux macos rust tatoeba windows

Last synced: about 1 month ago
JSON representation

Rust-based command-line language-learning game. Uses the Tatoeba database.

• Host: GitHub
• URL: https://github.com/benmanone/minicloze
• Owner: benmanone
• Created: 2023-01-31T19:56:24.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-10-08T13:40:02.000Z (8 months ago)
• Last Synced: 2024-04-02T13:10:29.386Z (2 months ago)
• Topics: command-line, game, language-learning, language-learning-game, lightweight, linux, macos, rust, tatoeba, windows
• Language: Rust
• Homepage:
• Size: 426 KB
• Stars: 9
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Lists

• cli-apps - minicloze - Rust-based command-line language-learning game using the Tatoeba database. (<a name="utility"></a>Utilities)
• awesome-cli-apps - minicloze - Rust-based command-line language-learning game using the Tatoeba database. (<a name="utility"></a>Utilities)

README

        
# minicloze

A command-line cloze-based language-learning game using the Tatoeba database of sentences. Written in Rust. The name is a reference to the Clozemaster app. This repository contains the Cargo workspace for minicloze.

# Features

- Support for over 400 languages

- Lookup unfamiliar words on Wiktionary

- Support for MacOS, Linux and Windows

- Lean implementation, written in pure Rust

# Targets

- **Long-term**

- Build a FOSS version of Clozemaster

- **Short-term**

- Build an Iced-based GUI frontend alongside the current CLI frontend

- Play between two non-English languages

# Installation

To install `minicloze-cli`, the only currently supported frontend, use `cargo install minicloze` (more likely to be up-to-date) or just download a release.

# Usage

For `minicloze-cli`, just pass in the language (from www.tatoeba.org) you want to use, e.g. `minicloze french`. Add `inverse` for inverse mode (`minicloze french inverse`).

![Example of use with French](french.gif)

# Dependencies

www.crates.io/crates/minreq

www.crates.io/crates/serde

www.crates.io/crates/rand

www.crates.io/crates/open

www.crates.io/crates/levenshtein

www.crates.io/crates/colored

# Contributing

Any help is very welcome, just open a PR or an issue and I'll probably be able to reply quickly. Right now the focus is on expanding from the basic idea into a more fully-fledged and user friendly experience.

# Tatoeba Licensing

All sentences are from Tatoeba (www.tatoeba.org). Tatoeba's data is released under the CC-BY 2.0 FR license.