Learn how to use AELLA effectively.
After installing and starting the app, open your browser to:
- http://localhost:3000 (default)
The main feature of AELLA is looking up German words and getting comprehensive information.
How to use:
- Type a German word in the search box
- Press Enter or click the search button
- View the results including:
- Clean word: The standardized form
- Definitions: In English and Persian
- Pronunciation: Click to hear the word
- Examples: Usage in context
Organize your learning with custom vocabulary lists.
Creating a List:
- Click the "+" button in the sidebar
- Enter a name for your list
- Click Create
Adding Words to a List:
- Search for a word
- Click "Save" to add it to the currently active list
Switching Lists:
- Click on any list in the sidebar to make it active
- The active list is highlighted
Deleting a List:
- Select the list
- Click the delete button
- Confirm deletion
Export your vocabulary to Anki for spaced repetition learning.
How to export:
- Select a vocabulary list
- Click "Export to Anki"
- A
.apkgfile will download - Open Anki and import the file
Card Format:
- Front: German word with pronunciation
- Back: Definitions in English and Persian, examples
Export your vocabulary to Obsidian for knowledge management.
How to export:
- Select a vocabulary list
- Click "Export to Obsidian"
- A
.mdfile will download - Move the file to your Obsidian vault
Note Format:
- Structured with YAML frontmatter
- Includes all word data
- Uses collapsible callouts for organization
- 📚 Vocabulary Lists: All your saved lists
- ➕ Add List: Create new list button
- 🎨 Theme Selector: Switch between visual themes
- 🔍 Search Bar: Enter words to look up
- 📋 Results Panel: View word information
- 💾 Save Button: Add word to current list
- 📤 Export Buttons: Anki and Obsidian export
- 🗑️ Delete: Remove current list
| Shortcut | Action |
|---|---|
Enter |
Search for the entered word |
Esc |
Clear the search box |
AELLA comes with multiple beautiful themes:
| Theme | Description |
|---|---|
| Midnight | Dark theme with purple accents (default) |
| Paper | Light, clean, minimal theme |
| Tokyo Night | Dark theme with blue accents |
| Ayu Mirage | Warm dark theme |
Changing Themes:
- Click the theme selector in the sidebar
- Choose your preferred theme
- Theme is saved automatically
- Start a Session: Create a new list for today's learning
- Explore Words: Look up words you encounter while reading/studying
- Save Important Ones: Add words you want to remember
- Export to Anki: At the end of the session, export to Anki
- Review Daily: Use Anki's spaced repetition
- 📅 By Date: "December 2024 Vocabulary"
- 📖 By Source: "Harry Potter Book 1"
- 🎯 By Topic: "Kitchen Vocabulary"
- 📊 By Level: "A1 Basics", "B2 Advanced"
- Look up a word
- Click the pronunciation button
- Listen carefully
- Repeat out loud
- Click again and compare
The backend server is not running.
Solutions:
- If using Docker: Check that containers are running with
docker ps - If manual: Ensure the backend is running on port 8000
Audio file might not be available.
Solutions:
- Check your browser's volume
- Try a different word
- Some rare words may not have audio
The API may be fetching from external sources.
Solutions:
- First searches are slower (caching happens)
- Subsequent searches for the same word will be faster
- Vocabulary Lists: Stored in the backend database
- Audio Files: Cached locally in
backend/static/audio/ - User Preferences: Stored in browser local storage
- 📦 Having issues? Check the Installation Guide
- 🤝 Want to contribute? Read the Contributing Guidelines
- 🐛 Found a bug? Open an issue