• Tap the + button to add fragrances
• Tap a fragrance row to open details
• Use the search bar to quickly narrow results
• Open the overflow menu (⋮) for sorting, databases, import/export, backups, settings, help, and stats

• Dice (🎲) - Smart seasonal/time-of-day suggestion from your collection
• Filter (🔽) - Filter by rating, season, time, gender, concentration, occasion, longevity, sillage, and projection
• Menu (⋮) - Sort, manage databases, export/import, ZIP backups, stats, settings, help

• Tap a row to open details
• Swipe right (pencil icon) to edit that fragrance
• Swipe left (scent icon) shows a “Coming soon” wear/quick‑action placeholder
• Long‑press a row to enter Select Mode (multi‑select)
• In Select Mode, tap rows to select/unselect; use actions like Copy/Move to Database from the UI when available

ScentLog supports multiple local databases (e.g., Fullsize, Travel, Wishlist). Use the Database menu to:

• Switch the active database
• Create new databases
• Rename databases
• Delete databases (careful—this removes the data for that database)

When multiple databases are selected for searching, results can show a small DB label on each row.

Required: Name + House

Common fields: Volume, Concentration, Gender, Year, Family/Sub‑family, Accords, Notes (Top/Mid/Base), Seasons, Time of Day, Occasion, Rating (supports half‑steps), Longevity, Projection, Sillage, Comments, Inspiration / Dupe‑of

Quick icons on each list row:
• Left “droplet” icon: view accords/family styling
• Star icon: set/view rating quickly

You can paste scraped text from a fragrance page to auto‑fill fields:

• Open a fragrance page on your phone
• Wait for longevity/sillage info to load (if present)
• Press and hold → Select All → Share → Copy
• In ScentLog, tap the clipboard icon and paste
• Tap Parse Data to preview, then Import to fill the form

Imports typically include: name/house, gender, concentration, top/mid/base notes, accords/family, seasons, longevity, sillage, and time‑of‑day (mapped to occasions).

Filters stack together (AND) with your search text:

• Ratings - 5★, 4★, 3★, 2★, 1★, Unrated
• Seasons - Spring, Summer, Fall, Winter
• Time of Day - Day, Night, Anytime
• Gender - Male, Female, Unisex
• Concentration - EF, EDC, EDT, EDP, Parfum, Extrait, Oil
• Occasion - Casual, Work, Formal, Date Night, etc.
• Longevity - Very Weak → Eternal
• Projection - Intimate, Moderate, Strong, Not Set
• Sillage - Intimate → Enormous

Use the menu’s Sort options to order your list by fields like:
Name, House, Date added, Rating, Concentration, Volume, Longevity, Projection, Sillage, and Relevance.

Relevance uses your current search query to score matches (name/house are weighted higher than notes/accords).

Tap the dice icon to get a smart recommendation:

• Automatically detects current season and time of day
• Suggests an appropriate fragrance from your collection
• Toggle the gender preference (♂/♀/⚥) to refine suggestions
• Tap dice again for another suggestion
• Use “View Details” to open the full entry

You can search with simple words, or use a powerful query syntax with fields, boolean logic, phrases, wildcards, and numeric filters.

1) Simple search (implicit AND)
Any terms separated by spaces are treated as AND (all must match):
• rose pear → rose AND pear
• tobacco winter

2) Field filters (field:value)
Target a specific field using field:value:
• house:Creed
• notes:vanilla
• projection:strong
• season:winter

3) Boolean operators
You can write operators in multiple ways:
• AND: AND, ,, &, or just a space (implicit AND)
• OR: OR or |
• NOT: NOT or !

Examples:
• house:Dior OR house:Chanel
• rose, pear (comma = AND)
• rose & pear
• rose | pear
• NOT gender:female (same as !gender:female)

4) Parentheses for grouping
Use parentheses to control evaluation order:
• (house:Afnan OR house:Creed) AND notes:rose
• (vanilla | tonka) !house:Clone

5) Quoted phrases
Quotes keep multi‑word phrases together:
• "black orchid"
• notes:"pink pepper"
• house:"Parfums de Marly"

6) Wildcards (*)
Use * for partial text matching (start, end, or contains):
• rose* (starts with “rose”)
• *wood (ends with “wood”)
• *amber* (contains “amber”)

7) Numeric comparisons
Compare numeric fields using: >, <, >=, <=, =
• rating>7
• year<2020
• vol>50

8) Numeric ranges (..)
Use min..max for inclusive ranges:
• year:2018..2022
• rating:6..10

9) Has: (field present)
Use has: to require a field to be present / filled in:
• has:notes
• has:dupe
• has:rating

Tips
• Operators are case‑insensitive.
• If a query gets complex, add parentheses for clarity.
• Fuzzy Search (≈) can help catch typos while you search.

Use the ⭐ star icon inside the search box to save or remove the current search query.
• Tap ⭐ to save the current query (you’ll be prompted to name it)
• If the star is filled, the current query is already saved—tap again to remove it

Saved searches appear in the dropdown under the search box when the search field is focused. Tap a saved search to apply it, or tap ✕ to delete it.

ScentLog can track wears and search by wear history.

Fields
• worn / wear: wear count (numeric)
• lastworn: last worn date
• wearreset: last reset date
• stale: “not worn in N days” helper

Examples
• worn>5
• worn:3..10
• lastworn:7d (worn in last 7 days)
• lastworn:today, yesterday, thisweek, thismonth
• unworn (shortcut for worn=0)
• stale:30d

There is also a menu action to reset wear counts across a database.

Export Database → JSON
Downloads a JSON backup for the selected database. Options can include:
• Export All (entire database)
• Export Displayed (only what’s currently on screen)
• Export Selected (only selected rows in Select Mode)

Import → JSON
You can import a previously exported JSON file to restore or merge entries (depending on the import flow).

The Backup… menu option exports every database into separate JSON files, then downloads a single .zip containing them all.

• After a successful ZIP backup, ScentLog stores the last backup date and will gently remind you if it has been more than ~5 days.

• Theme: light / dark mode
• Accent color: tap the grape icon (or color control) to cycle accent colors
• Fuzzy Search: toggle in the menu to catch typos/misspellings (≈ indicator may appear while active)
• Default sort: your chosen sort field/direction can persist across launches

Open Statistics from the menu to see collection stats. In Nerd Mode you can also view system/storage info, including saved preferences.

There is also a Storage cleanup option that removes unused localStorage keys.

Open Game… from the menu to play a guessing game based on your collection:

• You’ll see Top/Mid/Base note clues
• Pick the correct fragrance from multiple‑choice options
• Tap Next for a new round