From b7d530a6dc5a1a09fa114a4a45f56913ee22021e Mon Sep 17 00:00:00 2001
From: kawaiipunk <kawaiipunk@posteo.net>
Date: Thu, 14 May 2026 16:59:45 +0100
Subject: [PATCH] Updated README

---
 README.md | 38 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 42ac286..b4eaa09 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,38 @@
-# flatpak-launcher
+# flatpak-tui 🚀
 
+A compact, keyboard-driven terminal user interface for browsing and launching your installed Flatpak apps. No dependencies, no bloat — just pure Bash.
+
+## Features
+
+- **Search-as-you-type** — Filter apps instantly by typing
+- **Compact interface** — Shows 8 apps at a time with scrolling
+- **Arrow key navigation** — Up/down to select, Enter to launch
+- **ESC to quit** or clear the current search
+- **Zero dependencies** — Works on any system with Bash and Flatpak
+- **Universal ASCII borders** — Renders correctly in any terminal
+
+## Usage
+
+```bash
+./flatpak-tui.sh
+```
+
+### Controls
+
+| Key | Action |
+|-----|--------|
+| Type | Filter apps by name |
+| ↑ / ↓ | Navigate through results |
+| Enter | Launch selected app |
+| Backspace | Delete last character from search |
+| ESC | Quit (or clear search if empty) |
+
+## How it works
+
+The script uses `flatpak list --app --columns=application` to fetch installed app IDs, then extracts a readable name from the last segment of each ID (e.g. `org.gimp.GIMP` → `GIMP`). This avoids the common pitfall of `flatpak list --columns=name` returning developer names instead of app names.
+
+## Requirements
+
+- **Bash** 4.0+
+- **Flatpak** installed and configured
+- At least one Flatpak application installed