bundecto

bundecto is a minimal terminal-based text editor written in Python using curses. It aims to provide a distraction-free, keyboard-only editing experience directly in your terminal.

Features

• Minimal interface with a focus on productivity
• Fully keyboard-driven controls
• Support for scrolling, cursor movement, and text editing
• Quick save to file with Ctrl+S
• Exit with Ctrl+X
• Ctrl+H to show keybind help menu
• Ctrl+G to open debug menu

Installation

You can install bundecto using pip:

pip install bundecto

Or install from source:

git clone https://github.com/voyager-2021/bundecto.git
cd bundecto
pip install .

Usage

Launch the editor from your terminal:

bund [filename] [-v|-h|-r]

If the file exists, it will be loaded. Otherwise, a new buffer is created.

Development

Please read the CONTRIBUTING.md file for information on how to contribute to the project.

Clone the repo and install in editable mode:

git clone https://github.com/voyager-2021/bundecto.git
cd bundecto
pip install -e .

Bug Reporting

If you encounter any bugs, please help us improve bundecto by reporting issues on the GitHub repository:

• Check if the issue is already reported before opening a new one.
• Provide clear steps to reproduce the bug.
• Include your operating system, Python version, and terminal emulator details.
• If possible, include error messages or screenshots.
• Use a issue template to file a bug report.

Report bugs to: bundecto/issues

License

This project is licensed under the MIT License.

Acknowledgments

Inspired by the elegance of minimal terminal editors like micro, nano, and pico, but aimed to be as simple as possible in pure Python.