Metadata-Version: 2.1
Name: words-tui
Version: 23.2
Summary: A TUI (Text User Interface) app for daily writing.
Project-URL: Documentation, https://github.com/anze3db/words-tui#readme
Project-URL: Issues, https://github.com/anze3db/words-tui/issues
Project-URL: Source, https://github.com/anze3db/words-tui
Project-URL: Changelog, https://github.com/anze3db/words-tui/blob/main/CHANGELOG.md
Author-email: Anže Pečar <anze@pecar.me>
License-Expression: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.8
Requires-Dist: click
Requires-Dist: peewee
Requires-Dist: textual
Requires-Dist: tree-sitter
Description-Content-Type: text/markdown

# words-tui

`words-tui` is an app for daily writing in your terminal, built with [Textual](https://github.com/Textualize/textual).

[![PyPI - Version](https://img.shields.io/pypi/v/words-tui.svg)](https://pypi.org/project/words-tui)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/words-tui.svg)](https://pypi.org/project/words-tui)

-----

**Table of Contents**

- [Demo](#demo)
- [Installation](#installation)
- [Running](#running)
- [License](#license)

## 🎬 Demo

https://github.com/anze3db/words-tui/assets/513444/a6a2d15c-f5ad-4e2a-a343-ffe7abfdb582

## Installation

The easiest way to install `words-tui` is with [pipx](https://pypa.github.io/pipx/).

```console
pipx install words-tui
```

Alternatively, you can install it with `pip`:

```console
pip install words-tui
```

## Running

To run `words-tui`, simply run the following command:

```console
words-tui
```

It stores all of your writing in ~/.words-tui.db by default, but you can override this with the `WORDS_TUI_DB` environment variable or the `--db` flag.

```console
words-tui --db /path/to/db
```

## License

`words-tui` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
