Full-Text Search¶
Bambuddy uses SQLite FTS5 (Full-Text Search) for lightning-fast search across all your archives.
Search Features¶
What's Searchable¶
| Field | Example |
|---|---|
| Print name | "benchy" |
| Filename | "calibration_cube.3mf" |
| Tags | "functional" |
| Notes | "great layer adhesion" |
| Designer | "printables username" |
| Filament type | "PLA", "PETG", "ABS" |
| Printer name | "Workshop X1C" |
Search Syntax¶
| Syntax | Description | Example |
|---|---|---|
word | Simple search | benchy |
"phrase" | Exact phrase | "phone stand" |
word* | Prefix match | ben* matches "benchy" |
word1 word2 | Both words | phone stand |
word1 OR word2 | Either word | benchy OR boat |
-word | Exclude word | phone -case |
Performance¶
FTS5 provides near-instant search:
| Archive Count | Search Time |
|---|---|
| 100 | < 1ms |
| 1,000 | < 5ms |
| 10,000 | < 20ms |
| 100,000 | < 100ms |
Why FTS5?¶
- Tokenized index - Pre-processes text for fast lookup
- Ranked results - Most relevant first
- Incremental updates - Index updates automatically
Quick Access¶
Keyboard Shortcuts¶
| Shortcut | Action |
|---|---|
| / | Focus search box |
| Esc | Clear search / close |
| Enter | Execute search |
| Down | Navigate results |
Search Box Location¶
The search box is prominently displayed on the Archives page header.
Combining Search with Filters¶
Search works alongside other filters:
- Enter search term
- Apply additional filters (printer, date, status)
- Results show intersection
Example: Search "benchy" + filter by "Last 7 days" + filter by "Success"
Search History¶
Recent searches are remembered:
- Click the search box to see recent searches
- Click any previous search to reuse it
- Clear history in the search dropdown
Index Management¶
The search index is automatically maintained:
Automatic Updates¶
- New archives are indexed immediately
- Edits update the index
- Deletions remove from index
Manual Rebuild¶
If search results seem incorrect:
- Go to Settings > System
- Click Rebuild Search Index
- Wait for rebuild to complete
When to Rebuild
Index rebuild is rarely needed. Only use if search results are clearly wrong or after database restoration.
API Search¶
Search via the REST API:
Response includes matching archives with relevance ranking.
API Parameters¶
| Parameter | Description |
|---|---|
search | Search query string |
limit | Max results (default: 50) |
offset | Pagination offset |
Search Tips¶
Use Specific Terms
More specific searches yield better results. "voron stealthburner" is better than just "voron".
Quote Phrases
Use quotes for exact phrases: "cable chain" won't match "cable management chain".
Exclude with Minus
Exclude unwanted results: case -phone finds cases that aren't phone cases.
Prefix for Partial Matches
Use asterisk for partial matching: bench* matches "benchy", "benchmark", "bench".
Check Filters
If search returns nothing, check if filters are limiting results.