Web UI Guide¶
Welcome to the File Organizer Web Interface! This guide covers all features of the browser-based application for managing, organizing, and analyzing your files.
Overview¶
The File Organizer web interface provides a user-friendly, modern way to:
- Upload & Manage files with drag-and-drop support
- Organize files using PARA, Johnny Decimal, or custom methodologies
- Search & Filter with powerful full-text search and faceted navigation
- Analyze storage usage and detect duplicate files
- Monitor organization jobs in real-time
- Configure settings and preferences
Getting to Know the Interface¶
Main Navigation¶
The web interface has several main sections accessible from the top navigation:
- Dashboard - Overview and recent activity
- Files - Browse and manage your file library
- Organize - Configure and run organization jobs
- Analysis - Analyze storage and detect duplicates
- Search - Search and filter files
- Settings - Configure workspace and user preferences
Dashboard¶
The dashboard provides an at-a-glance view of:
- Storage Summary - Total space used and available
- Recent Activity - Latest file operations
- Quick Stats - Number of files, duplicates detected
- Quick Actions - Links to organize, search, analyze
Navigation Bar¶
The top navigation bar includes:
- Logo - Click to return to dashboard
- Search Bar - Quick search from anywhere
- Notifications - Job status and alerts
- Settings - User menu with preferences
- Help - Link to documentation
Browser Support¶
File Organizer works best on modern browsers:
- Chrome 90+ (recommended)
- Firefox 88+
- Safari 14+
- Edge 90+
Browser Features Required¶
- JavaScript enabled
- WebSocket support (for real-time updates)
- File drag-and-drop support
- LocalStorage for user preferences
Getting Started¶
1. Access the Web Interface¶
Open your browser and navigate to:
(Replace localhost:8000 with your server address if deployed remotely)
2. Initial Setup¶
On first access, you'll see:
- Welcome Screen - Overview and setup instructions
- Configuration - Set workspace path and preferences
- Dashboard - Your home screen
3. Upload Your First Files¶
Click Upload Files or drag files into the interface to get started.
Key Features¶
File Management¶
- Browse file library with thumbnail previews
- View file properties and metadata
- Support for 43+ file formats
- Batch file operations
Read more: File Management Guide
Organization¶
- Choose from multiple methodologies (PARA, Johnny Decimal)
- Preview organization results before applying
- Monitor job progress in real-time
- Undo/redo any operation
Read more: Organization Guide
Analysis & Insights¶
- Storage usage breakdown by file type and folder
- Duplicate detection with similarity matching
- Metadata extraction and analysis
- Export analytics data
Read more: Analysis & Search Guide
Search & Discovery¶
- Full-text search across file contents
- Faceted search with filters
- Save frequently-used searches
- Export search results
Read more: Analysis & Search Guide
Configuration¶
- Customize workspace settings
- Manage user preferences
- Generate API keys
- Configure organization options
Read more: Settings Guide
Tips & Tricks¶
Keyboard Shortcuts¶
- / - Focus search bar
- Ctrl+Upload - Upload multiple files
- Drag & Drop - Upload or organize files
- Ctrl+Z - Undo last operation
- Ctrl+Shift+Z - Redo last operation
Drag & Drop¶
- Drag files from your computer to upload
- Drag files to create organization rules
- Drag files to move between categories
Search Operators¶
Use these in search for precise results:
type:pdf- Find only PDF filessize:>10mb- Find large filesdate:2024- Find files from 2024path:/downloads- Search in specific folder
Saved Searches¶
Save frequently-used searches for quick access:
- Enter search query
- Click "Save Search"
- Give it a name
- Access from sidebar
Workflows¶
Quick Organization¶
- Upload files
- Click Organize
- Select methodology
- Review preview
- Click Apply
Duplicate Cleanup¶
- Click Analysis
- Select Detect Duplicates
- Choose folder to scan
- Review results
- Remove duplicates or merge
Storage Analysis¶
- Click Analysis
- Select Storage Usage
- View breakdown by category
- Click on sections to drill down
- Export report
Backup & Export¶
- Click Search to find files
- Select files to export
- Click Export
- Choose format and location
- Files are packaged for download
Real-Time Updates¶
The web interface uses WebSocket connections for real-time updates:
- Job progress updates appear instantly
- Notifications appear when operations complete
- Search results update as you type
- Storage stats update automatically
Responsive Design¶
The interface adapts to different screen sizes:
- Desktop (1024px+): Full interface with all features
- Tablet (768px-1024px): Optimized layout with collapsible menu
- Mobile (< 768px): Mobile-optimized interface
Performance Tips¶
For Better Performance¶
- Use modern browser (Chrome/Firefox recommended)
- Enable JavaScript and cookies
- Use wired connection for large uploads
- Close unused browser tabs
- Clear browser cache regularly
For Large File Collections¶
- Use search/filters instead of browsing
- Organize files in batches
- Monitor job progress
- Reduce upload file sizes
Accessibility¶
The web interface includes accessibility features:
- Keyboard Navigation - Full keyboard support
- Screen Readers - ARIA labels for accessibility
- High Contrast - Dark mode support
- Responsive Text - Adjustable font sizes
Session Management¶
Login & Logout¶
- Automatic logout after 30 minutes of inactivity
- "Remember me" option for convenience
- Secure cookie-based sessions
API Keys¶
- Generate API keys for programmatic access
- Tokens are secure and revocable
- See API Reference for usage
Getting Help¶
Built-In Help¶
- Help Button (?) in top right opens documentation
- Tooltips hover over interface elements
- Status Messages explain what's happening
External Resources¶
Next Steps¶
Choose a guide based on what you want to do:
- Upload & Manage Files: File Management Guide
- Organize Files: Organization Guide
- Search & Analyze: Analysis & Search Guide
- Customize Settings: Settings Guide
Ready to get started? Jump to File Management!