Skip to main content

A tiny terminal text editor built with Textual

Project description

tini-editor 📝

tini is a minimal, terminal-based text editor built with Python's curses module. It's inspired by nano, but written in Python and designed for simplicity and speed.

✨ Features

  • Open and edit any text file from the terminal
  • Keyboard shortcuts:
    • Ctrl+S – Save
    • Ctrl+Q – Quit (prompts to save if file is modified)
    • Ctrl+Z – Undo
    • Ctrl+Y – Redo
    • Enter – New line
    • Backspace – Delete character to the left
    • Delete – Delete character to the right
    • Arrow keys – Move cursor
    • Ctrl+Left/Right – Jump cursor by word
  • Line numbers (light gray, non-intrusive)
  • Undo/Redo history (cleared on save or exit)
  • Automatic scrolling for both vertical and horizontal movement
  • If the file doesn’t exist, it will be created when saved

🚀 Installation

pip install tini-editor

🧑‍💻 Usage

tini <filename>

Example:

tini notes.txt

📦 Development Setup

Clone the repo and install dependencies:

git clone https://codeberg.org/yourusername/tini-editor.git
cd tini-editor
pip install -e .

Run locally:

python -m tini.app <filename>

🗺️ Planned Features

  • Syntax highlighting for popular languages
  • Copy, cut, and paste support
  • Text selection and highlighting
  • Search and replace
  • Configurable tab width and indentation
  • Mouse support (where available)
  • Customizable color themes
  • Status bar with file info and cursor position

📄 License

This project is licensed under the MIT License.


🙏 Acknowledgments

  • Built with curses
  • Inspired by nano, but even tinier

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tini_editor-1.2.0.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tini_editor-1.2.0-py3-none-any.whl (7.5 kB view details)

Uploaded Python 3

File details

Details for the file tini_editor-1.2.0.tar.gz.

File metadata

  • Download URL: tini_editor-1.2.0.tar.gz
  • Upload date:
  • Size: 7.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for tini_editor-1.2.0.tar.gz
Algorithm Hash digest
SHA256 4ff720681f913afc7563aa2ec32399e3ac95807ffb871c9eeef47f65abee8678
MD5 acc0fe117ff2184e2f8200915067d840
BLAKE2b-256 75e9974f8d68b48543b1a9897ee7d293cf837ab7fae9f73d4de1e7ee63b5dc2d

See more details on using hashes here.

File details

Details for the file tini_editor-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: tini_editor-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 7.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for tini_editor-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 800737a9165f7bd01c56d883661ac5b3a3ead12739e11c567263c731e91fad6a
MD5 f7766982791748d0df09d3d65b08c71f
BLAKE2b-256 d9983cebc0e1bfb435d7d3fa2ce8611da57492f703f9019a48661fce0d420821

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page