Skip to main content

Text User Interface (TUI) that allows users to manage keybindings

Project description

⌨️ Keybind Vault

A TUI (Text-based User Interface) app built with Textual for managing your keyboard shortcuts. Organize, search, add, edit, and delete keybinds in a sleek terminal interface.


Features

  • Dark Mode toggle
  • Search keybinds by keys, name, or description
  • Add, Edit, Delete keybinds
  • Organize keybinds into categories
  • Uses a lightweight sqlite3 database for storage

Preview

(Add a screenshot or GIF of your terminal UI here, if possible)


Getting Started

1. Clone the repo

git clone https://github.com/your-username/keybind-vault.git
cd keybind-vault

2. Set up a virtual environment

python -m venv .venv
source .venv/bin/activate    # On Windows: .venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Run the application

python -m keybind_vault

Or if installed via an entry point (e.g. via setup.py):

keybind-vault

Project Structure

keybind_vault/
│
├── db/                    # SQLite database logic
│   ├── __init__.py
│   └── sqlite_db.py
│
├── modals/                # Textual modal screens for Add, Edit, Delete, etc.
│   ├── styles/            # Textual CSS for the modal screens
│   ├── add_modal.py
│   ├── delete_modal.py
│   ├── edit_modal.py
│   ├── search_modal.py
│   ├── vault_types.py
│   └── __init__.py
│
├── styles/
│   └── styles.tcss        # Textual CSS for the main file
│
├── main.py                # Main Textual app logic
└── __init__.py

Tech Stack

  • Textual — modern TUI framework for Python
  • Python 3.13+
  • SQLite (via sqlite3 module)

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

keybind_vault-1.0.0.tar.gz (8.2 kB view details)

Uploaded Source

Built Distribution

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

keybind_vault-1.0.0-py3-none-any.whl (13.6 kB view details)

Uploaded Python 3

File details

Details for the file keybind_vault-1.0.0.tar.gz.

File metadata

  • Download URL: keybind_vault-1.0.0.tar.gz
  • Upload date:
  • Size: 8.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.8

File hashes

Hashes for keybind_vault-1.0.0.tar.gz
Algorithm Hash digest
SHA256 93bfca4a32bcbaf0b54f9566aeb702a872fcc73601b194c611a7a5b9453fe4f5
MD5 cf4ef441a2749cf60b88db3ff232e78a
BLAKE2b-256 e92c37999c60e65639ed93498b23a7350f1066808739757e30a6c148fc7e5258

See more details on using hashes here.

File details

Details for the file keybind_vault-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for keybind_vault-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 196ca642845f2697e13a4185205e866c0523c717fd15b1c3e4af09444d73d68f
MD5 a2418b48b4e90c1713eb8b721a3c4d45
BLAKE2b-256 029419612fa42527ea37fa5efc0c9c0027f41c36c5223e8cc7c2de425c51acfc

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