Reorganize assets and bump version to 0.7.3v0.7.3

- Move totalrecall.desktop, install-icon.sh, and config.yaml.example to assets/ directory
- Update all references in README.md and install-icon.sh
- Add file organization guidelines to AGENTS.md
- Clean up root directory structure

🤖 Generated with [opencode](https://opencode.ai)

Co-Authored-By: opencode <noreply@opencode.ai>

3 files changed, 118 insertions, 0 deletions

diff --git a/assets/config.yaml.example b/assets/config.yaml.example
new file mode 100644
index 0000000..3988035
--- /dev/null
+++ b/assets/config.yaml.example
@@ -0,0 +1,39 @@
+# TotalRecalooConfiguration Example
+# Copy this to ~/.totalrecall.yaml or ./.totalrecall.yaml
+
+# Audio configuration
+audio:
+  # Audio is generated using OpenAI TTS
+  # Provider field removed - OpenAI is now the only option
+  
+  # Audio output format
+  format: mp3
+  
+  # OpenAI TTS settings
+  openai_key: ${OPENAI_API_KEY}  # Can also use environment variable
+  openai_model: gpt-4o-mini-tts  # Options: tts-1, tts-1-hd, gpt-4o-mini-tts
+  openai_speed: 0.9               # Range: 0.25 to 4.0 (may be ignored by gpt-4o-mini models)
+  
+  # Voice instructions for gpt-4o-mini-tts model
+  # This allows you to customize how the AI speaks
+  openai_instruction: "You are speaking Bulgarian language (български език). Pronounce the Bulgarian text with authentic Bulgarian phonetics, not Russian. Speak slowly and clearly for language learners."
+  
+  # Alternative instruction examples:
+  # openai_instruction: "Speak in Bulgarian (not Russian!). Use native Bulgarian pronunciation with clear articulation for each syllable."
+  # openai_instruction: "You are a Bulgarian language teacher. Pronounce the Bulgarian words slowly with authentic Bulgarian accent and phonetics."
+  # openai_instruction: "Speak Bulgarian text with proper Bulgarian pronunciation. Avoid Russian accent. Speak clearly at a pace suitable for beginners."
+
+# Image configuration
+image:
+  # Provider: currently only openai is supported
+  provider: openai
+  
+  # OpenAI DALL-E settings
+  openai_model: dall-e-3     # Options: dall-e-2, dall-e-3
+  openai_size: 1024x1024     # Options vary by model
+  openai_quality: standard   # Options: standard, hd (dall-e-3 only)
+  openai_style: natural      # Options: natural, vivid (dall-e-3 only)
+
+# Output configuration
+output:
+  directory: ~/Downloads
diff --git a/assets/install-icon.sh b/assets/install-icon.sh
new file mode 100755
index 0000000..b012067
--- /dev/null
+++ b/assets/install-icon.sh
@@ -0,0 +1,66 @@
+#!/bin/bash
+# Script to install TotalRecall icon for GNOME on Fedora Linux
+# Run with sudo for system-wide installation
+
+set -e
+
+# Check if running as root for system-wide install
+if [[ $EUID -eq 0 ]]; then
+   echo "Installing TotalRecall icon system-wide..."
+   ICON_BASE="/usr/share/icons/hicolor"
+   APP_DIR="/usr/share/applications"
+   BINARY_PATH="/usr/local/bin/totalrecall"
+else
+   echo "Installing TotalRecall icon for current user..."
+   ICON_BASE="$HOME/.local/share/icons/hicolor"
+   APP_DIR="$HOME/.local/share/applications"
+   BINARY_PATH="$HOME/go/bin/totalrecall"
+fi
+
+# Create directories
+mkdir -p "$ICON_BASE"/{16x16,32x32,48x48,64x64,128x128,256x256,512x512}/apps
+mkdir -p "$APP_DIR"
+
+# Copy icons
+cp assets/icons/totalrecall_16.png "$ICON_BASE/16x16/apps/totalrecall.png"
+cp assets/icons/totalrecall_32.png "$ICON_BASE/32x32/apps/totalrecall.png"
+cp assets/icons/totalrecall_48.png "$ICON_BASE/48x48/apps/totalrecall.png"
+cp assets/icons/totalrecall_64.png "$ICON_BASE/64x64/apps/totalrecall.png"
+cp assets/icons/totalrecall_128.png "$ICON_BASE/128x128/apps/totalrecall.png"
+cp assets/icons/totalrecall_256.png "$ICON_BASE/256x256/apps/totalrecall.png"
+cp assets/icons/totalrecall_512.png "$ICON_BASE/512x512/apps/totalrecall.png"
+
+# Copy scalable icon
+mkdir -p "$ICON_BASE/scalable/apps"
+cp assets/icons/totalrecall.svg "$ICON_BASE/scalable/apps/totalrecall.svg"
+
+# Copy and update desktop file with correct binary path
+# First check if totalrecall is in standard locations
+if command -v totalrecall &> /dev/null; then
+    TOTALRECALL_PATH=$(command -v totalrecall)
+elif [[ -x "$HOME/go/bin/totalrecall" ]]; then
+    TOTALRECALL_PATH="$HOME/go/bin/totalrecall"
+elif [[ -x "/usr/local/bin/totalrecall" ]]; then
+    TOTALRECALL_PATH="/usr/local/bin/totalrecall"
+elif [[ -x "/usr/bin/totalrecall" ]]; then
+    TOTALRECALL_PATH="/usr/bin/totalrecall"
+else
+    echo "Warning: totalrecall binary not found in standard locations"
+    echo "Please install totalrecall first with 'task install' or 'go install ./cmd/totalrecall'"
+    TOTALRECALL_PATH="totalrecall"
+fi
+
+# Create desktop file with proper exec path
+sed "s|Exec=totalrecall|Exec=$TOTALRECALL_PATH|g" assets/totalrecall.desktop > "$APP_DIR/totalrecall.desktop"
+
+# Update caches
+if command -v gtk-update-icon-cache &> /dev/null; then
+    gtk-update-icon-cache -f -t "$ICON_BASE" 2>/dev/null || true
+fi
+
+if command -v update-desktop-database &> /dev/null; then
+    update-desktop-database "$APP_DIR" 2>/dev/null || true
+fi
+
+echo "TotalRecall icon installed successfully!"
+echo "You may need to log out and log back in to see the icon in GNOME."
\ No newline at end of file
diff --git a/assets/totalrecall.desktop b/assets/totalrecall.desktop
new file mode 100644
index 0000000..dfd1edf
--- /dev/null
+++ b/assets/totalrecall.desktop
@@ -0,0 +1,13 @@
+[Desktop Entry]
+Version=1.0
+Type=Application
+Name=TotalRecall
+GenericName=Bulgarian Flashcard Generator
+Comment=Generate Anki flashcard materials from Bulgarian words
+Exec=totalrecall
+Icon=totalrecall
+Terminal=false
+Categories=Education;Languages;
+Keywords=bulgarian;flashcards;anki;language;learning;
+StartupNotify=true
+StartupWMClass=totalrecall