# FlitKey

> FlitKey is a fast, 100% offline, local-first text expander for Windows (10/11) and Linux (X11 & Wayland). Built with Python 3.10+ and PyQt6.

## Core Capabilities
- **Instant Keyword Expansion**: Replaces typed trigger abbreviations (e.g. `;addr`, `/date`) with full text snippets or dynamic values across all desktop applications.
- **Searchable Snippet Picker**: Global shortcut (`Alt` + `Space`) opens a fast fuzzy-search overlay window.
- **Dynamic Placeholders**: Injects live date (`{{date}}`), time (`{{time}}`), timestamp (`{{datetime}}`), clipboard contents (`{{clipboard}}`), and controls cursor placement (`$|$` or `{{cursor}}`).
- **Espanso & AutoHotkey Importers**: One-click batch conversion for `.yml`, `.ahk`, `.csv`, `.tsv`, and `.json` libraries.
- **100% Offline & Private**: Zero telemetry, zero cloud calls, zero accounts. Data stored locally in `~/.config/flitkey/config.json` (Linux) / `%APPDATA%\flitkey\config.json` (Windows).

## Technical Specifications
- **Language**: Python 3.10+
- **GUI Framework**: PyQt6
- **Platforms**: Windows 10/11 (64-bit), Linux (Debian/Ubuntu/Arch - X11 & Wayland)
- **License**: MIT License (Open-Source)
- **Current Version**: v2.4.1

## Quick Installation Commands
```bash
# Debian / Ubuntu (.deb)
sudo apt update && sudo apt install python3 python3-pyqt6 xdotool xinput x11-xserver-utils
sudo dpkg -i flitkey_2.4.1_amd64.deb
flitkey

# Windows Silent Install
FlitKey-2.4.1.exe /VERYSILENT /SUPPRESSMSGBOXES
```

## Key Documentation & Links
- [FlitKey Homepage](https://flitkey.org/index.html): Overview, browser demo, and installer downloads.
- [Full Technical AI Documentation](https://flitkey.org/llms-full.txt): Complete technical reference, code samples, API specs, and architecture.
- [Official User Manual & Documentation](https://flitkey.org/docs.html): Setup guides for Debian `.deb`, Windows `.exe`, source code, and Manifest V3 Chrome Extension.
- [Privacy Policy](https://flitkey.org/privacy.html): Zero-telemetry data notice, local storage paths, and clipboard handling.
- [Refund Policy](https://flitkey.org/refund.html): 15-day money-back guarantee terms for FlitKey Pro.
- [Compliance & Security](https://flitkey.org/compliance.html): GDPR, CCPA, HIPAA, and air-gapped endpoint security standards.
- [Changelog & Release Notes](https://flitkey.org/changelog.html): Version release notes and update log.
- [GitHub Repository](https://github.com/swarajnandedkar/FlitKey): Open-source source code and issue tracker.