Metadata-Version: 2.4
Name: k-hunter
Version: 0.4.1
Summary: Keyboard typing trainer app 
Keywords: typing,trainer,terminal,tui,textual
Author: Rivkat Karimov
Author-email: Rivkat Karimov <redscorpion32.rk@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Education
Classifier: Topic :: Terminals
Requires-Dist: platformdirs>=4.5.1
Requires-Dist: textual>=7.5.0
Requires-Python: >=3.10
Project-URL: Homepage, https://github.com/spaghetti-backend/k-hunter
Project-URL: Repository, https://github.com/spaghetti-backend/k-hunter
Project-URL: Issues, https://github.com/spaghetti-backend/k-hunter/issues
Description-Content-Type: text/markdown

![Logo](https://raw.githubusercontent.com/spaghetti-backend/keyhunter/main/docs/logo.webp)

# KeyHunter

A simple terminal-based typing trainer built with [Textual].  
Minimalist interface, flexible configuration, and progress tracking — right in
your terminal.

---

## Project Status

The project is currently under development.  
Features are gradually expanding and may change over time.

---

## Features

<details>
<summary><strong>Training Modes</strong></summary>

Available modes:

- Standard multi-line mode  
- Scrolling line mode  

![StandardEngine](https://raw.githubusercontent.com/spaghetti-backend/keyhunter/main/docs/typer.webp)

</details>

<details>
<summary><strong>Flexible Configuration</strong></summary>

- Content type selection  
- Adjustable word count  
- Customizable typing area  

![Settings](https://raw.githubusercontent.com/spaghetti-backend/keyhunter/main/docs/settings.gif)

</details>

<details>
<summary><strong>Statistics & Profile</strong></summary>

View training results and track your progress.

![Profile](https://raw.githubusercontent.com/spaghetti-backend/keyhunter/main/docs/profile.webp)

</details>

---

## Requirements

- Python 3.10 or higher  
- Any modern terminal  

---

## Installation

It is recommended to install CLI applications in an isolated environment.

### Using uv

```bash
uv tool install k-hunter
```

### Using pipx

```bash
pipx install k-hunter
```

### Using pip

```bash
pip install k-hunter
```

Using [pipx] or [uv] is recommended for CLI tools.

## Usage

Run the application with:

```bash
k-hunter
```

Hotkeys are displayed in the bottom panel of the interface.

## Roadmap

- [x] Improved navigation
- [ ] Advanced statistics
- [ ] Additional languages
- [ ] Code snippet training mode

<!-- external Links -->
[Textual]: https://textual.textualize.io
[uv]: https://docs.astral.sh/uv
[pipx]: https://github.com/pypa/pipx
