feat: add app icon and change default output directory

- Add custom app icon with memory/brain theme
- Icon now displays in GNOME app menu, window title bar, and process list
- Change default output directory to ~/.local/state/totalrecall/
- Make output directory configurable via CLI flag, config file, or env var
- Add desktop entry file for GNOME integration
- Add install script for easy icon installation
- Update README with icon display and default directory information
- Bump version to 0.5.1

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

1 files changed, 49 insertions, 3 deletions

diff --git a/README.md b/README.md
index 24bfbf3..828d991 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,9 @@
 # totalrecall - Bulgarian Anki Flashcard Generator
 
+<p align="center">
+  <img src="assets/icons/totalrecall_512.png" alt="TotalRecall Icon" width="256" height="256">
+</p>
+
 `totalrecall` is a versatile tool for generating Anki flashcard materials from Bulgarian words. It offers both a command-line interface (CLI) and a graphical user interface (GUI) for creating audio pronunciation files and AI-generated images.
 
 It has mainly been vibe coded using Claude Code CLI.
@@ -22,6 +26,7 @@ It has mainly been vibe coded using Claude Code CLI.
 - Anki-compatible CSV export with translations
 - Random voice variants and speech speed
 - Audio caching to save API costs
+- **Default output directory**: `~/.local/state/totalrecall/` (configurable)
 
 ## Installation
 
@@ -42,12 +47,45 @@ cd totalrecall
 go build -o totalrecall ./cmd/totalrecall
 ```
 
-Or install directly:
+### Installing to Go Bin Directory
+
+Using Task (recommended):
+```bash
+cd totalrecall
+task install
+```
+
+Or using go install directly:
+```bash
+cd totalrecall
+go install ./cmd/totalrecall
+```
 
+Or install from remote repository:
 ```bash
 go install codeberg.org/snonux/totalrecall/cmd/totalrecall@latest
 ```
 
+This will install the binary to `~/go/bin/totalrecall`, which should be in your PATH.
+
+### Desktop Icon Installation (GNOME/Fedora)
+
+TotalRecall includes a desktop icon for GNOME integration. To install:
+
+**For current user only:**
+```bash
+cd totalrecall
+./install-icon.sh
+```
+
+**System-wide installation:**
+```bash
+cd totalrecall
+sudo ./install-icon.sh
+```
+
+After installation, you may need to log out and log back in for the icon to appear in GNOME's application menu. The icon will show up as "TotalRecall" in the Education category.
+
 ## Quick Start
 
 **Note:** By default, totalrecall uses OpenAI for both audio and images. Make sure to set your OpenAI API key:
@@ -92,7 +130,13 @@ Launch the interactive graphical interface:
 totalrecall --gui
 ```
 
-Then use keyboard shortcuts or buttons to generate and manage flashcards interactively.
+The GUI is best navigated using keyboard shortcuts for efficient workflow. Press **`h`** at any time to display a complete list of all available keyboard shortcuts.
+
+Key features:
+- Fast keyboard-driven interface
+- Real-time audio playback
+- Batch processing support
+- Visual feedback for all operations
 
 ## Configuration
 
@@ -123,7 +167,7 @@ image:
   openai_style: "natural"    # Style: natural or vivid (dall-e-3 only)
 
 output:
-  directory: ./anki_cards
+  directory: ~/.local/state/totalrecall  # Default location (can be overridden)
   naming: "{word}_{type}"
 ```
 
@@ -174,6 +218,8 @@ When translations are provided, they are used directly without calling the trans
 
 ### Output Files
 
+By default, all files are saved to `~/.local/state/totalrecall/`. You can override this with the `-o` flag or the `output.directory` config option.
+
 For each word, the tool generates:
 - `word.mp3` - Audio pronunciation (random voice)
 - `word_translation.txt` - English translation