Feature List
This document lists the complete feature set of TrailSnap, helping you quickly understand all its capabilities.
Reading feature status
The list below describes current project capabilities. Features that need the AI service, an external model, or more hardware are called out; roadmap items should not be treated as a promise for the current release.
Current capabilities and requirements
| Capability | Status | Requirements / notes |
|---|---|---|
| Photo browsing, albums, timeline, metadata | Available | Import or scan photos first |
| Faces, OCR, scene classification, similar/duplicate detection | Available | Requires the AI service; duration depends on library size and hardware |
| Maps, footprints, 5A scenic spots | Available | Depends on photo location metadata and map configuration |
| Train, flight, and other ticket features | Available | Recognition quality depends on photo clarity and ticket type |
| AI assistant, external models, Agent CLI | Optional | Requires model or token configuration; external models may transmit data to their provider |
| Auto Vlogs and smart retouching | Planned | Not a current release capability |
1. Album Management
1.1 Basics
| Feature | Description |
|---|---|
| Photo upload | Multi-file upload with automatic thumbnail generation |
| Photo browsing | Waterfall/grid view with filtering and sorting |
| Photo lightbox | Full-screen photo viewer with navigation |
| Photo metadata | EXIF data extraction and display |
| Live Photo | Supports iPhone, Vivo, OPPO, Xiaomi and more |
| Recycle bin | Soft delete with photo recovery |
1.2 Smart Classification
| Feature | Description |
|---|---|
| Face recognition | InsightFace-based person identification and clustering |
| Scene classification | Auto-classify into night view, pets, food, selfie, etc. |
| OCR | Extract text from photos |
| Similar photo detection | Find visually similar photos |
| Duplicate photo cleanup | Hash-based duplicate detection and cleanup |
| AI photo analysis | AI-generated photo descriptions and scores |
2. AI Capabilities
| Feature | Description |
|---|---|
| AI assistant chat | Chat with LLMs to intelligently search album content |
| Smart album generation | Auto-generate albums from descriptions (e.g. "my selfies at the beach") |
| On This Day | AI recommends the most memorable photos from past years |
| Smart search | Search by person, content, time, location, and more |
| Built-in AI connection | Out-of-the-box multimodal model (MiniCPM-V-4_6), no extra configuration needed |
| Local LLM hosting | Host custom models via llama.cpp — data never leaves your machine |
| Multi-model support | Connect to multiple LLMs (OpenAI, Ollama, etc.) |
3. Footprints & Maps
| Feature | Description |
|---|---|
| Footprint map | View all photos on an interactive map |
| Lit-up cities | Track visited cities at province/city/district level |
| Visited scenic spots | Track visited 5A scenic spots; supports custom spots |
| Footprint timeline | Browse photos by time across different locations |
| Trajectory view | Connect locations across a time range to show travel routes |
| Offline maps | Download offline map data for multiple countries |
4. Itinerary Tickets
4.1 Train Tickets
| Feature | Description |
|---|---|
| Ticket recognition | OCR auto-recognition of train ticket info from photos |
| Ticket management | CRUD for train ticket records |
| Paper-style tickets | Simulated train ticket display (red/blue styles) |
| Ticket export | Export as PNG, CSV, or JSON |
4.2 Flight Tickets
| Feature | Description |
|---|---|
| Ticket recognition | Recognize itinerary screenshots from photos |
| Ticket management | CRUD for flight ticket records |
| Flight statistics | Statistics by city, distance, duration, etc. |
4.3 Ticket Statistics
| Feature | Description |
|---|---|
| Annual ticket report | Travel statistics summary |
| City statistics | Visited cities and photo counts |
| Distance statistics | Total travel mileage |
| Passenger filtering | Filter tickets by passenger |
5. Album Types
| Album Type | Description |
|---|---|
| Standard album | Traditional album organized by timeline |
| Smart album | AI auto-generated from descriptions |
| People album | Person-grouped photo collection from face recognition |
| Location album | Photos organized by geographic location |
| Scene album | Photos classified by scene type (night view, food, etc.) |
| Conditional album | Auto-generated by filtering on tags, scenes, people, locations, etc. |
6. Annual Report
| Feature | Description |
|---|---|
| Photo wall | Yearly photo collage display |
| Photo calendar | Browse photos by date |
| City rankings | Top visited cities |
| Scenic spot rankings | Top visited scenic spots |
| Travel timeline | Yearly travel timeline |
| Route mileage | Travel routes and total mileage |
| Seasonal analysis | Photo stats across spring/summer/fall/winter |
| Spending stats | Flight and train ticket spending |
| Best photos | Top AI-scored photos of the year |
7. Toolbox
| Feature | Description |
|---|---|
| Batch photo transfer | Move or copy photos to a specified directory in bulk |
| Auto-organize photos | Organize by time (year/month/day), person, category, or location; flat or recursive directory structure |
| Modify photo metadata | Set capture time from filename |
| Similar photo cleanup | Find and clean visually similar photos |
| Duplicate photo cleanup | Clean exact duplicate photos |
| Quality cleanup | Clean low-quality photos based on AI scores |
8. User Management
| Feature | Description |
|---|---|
| User authentication | Login, registration, password reset |
| Multi-user support | Data isolation between users |
| External libraries | Add external folders as data sources |
| Token management | API token configuration for login-free access |
| Task management | Background task monitoring and management |
9. System Features
| Feature | Description |
|---|---|
| Sidebar navigation | Collapsible sidebar with global search |
| Theme customization | 5 brand colors (Sky, Emerald, Violet, Rose, Amber) that apply globally with one click |
| Dark mode | Light/dark mode toggle |
| Responsive design | Mobile-friendly interface |
| Docker deployment | One-click deployment of frontend, backend, database, and AI services |
| SKILL support | Integrate with OpenClaw, Claude Code, Hermes Agent, and more |
| ONNX Runtime | All AI services migrated to ONNX Runtime with redundant dependencies removed |
10. Planned Features
| Feature | Description |
|---|---|
| Image editing | Crop, rotate, add text, add tags, etc. |
| Auto travel journal | Auto-generate travel records from photos |
| Social media 9-grid | Auto-generate shareable 9-grid images with captions |
| MCP protocol support | MCP protocol communication |