User Guide
Table of Contents
Getting Started
First Access
- Navigate to the indexer URL
https://yourdomain.com/path/to/indexer/
- Interface loads automatically
- No login required (unless configured by administrator)
- Directory contents display immediately
- All features available based on configuration
What You'll See
The indexer displays:
- Files and folders in the current directory
- File information (size, modification date, type)
- Navigation tools (breadcrumbs, sorting options)
- Action buttons (download, view, depending on configuration)
Interface Overview
Header Section
Index of /current/directory/path
content / documents / projects
- Title: Shows current directory path
- Breadcrumbs: Clickable navigation trail
- Quick navigation to any parent directory
File Listing
Each item shows:
| Element | Description |
|---|
| Icon | Visual indicator of file type or folder |
| Name | Clickable file/folder name |
| Size | File size or calculated directory size |
| Modified | Last modification date and time |
| Actions | Download/view buttons (if enabled) |
Sort Controls
- Options menu (⋯): Access all sorting options
- Column headers: Click to sort by that column
- Sort indicators: Arrows show current sort direction
Navigation
Directory Navigation
Using Breadcrumbs
Click any part of the path to jump to that directory:
content / documents / projects
↑ ↑ ↑
Root Documents Current
Using Folder Links
- Single-click folder names to enter directories
- Blue folder icons indicate navigable directories
- Parent directory (..) link goes up one level
Browser Navigation
- Back button: Return to previous directory
- Forward button: Return after going back
- Bookmark: Save frequently accessed directories
Path Information
Current location is always shown in:
- Page title:
Index of /path/to/directory
- Breadcrumb trail: Interactive navigation
- Browser address bar: Direct URL access
File Operations
Viewing Files
Files display differently based on administrator configuration:
Browser Viewable Files
Open directly in browser:
- Text files:
.txt, .md, .json, .xml
- Source code:
.php, .js, .py, .html, .css
- Images:
.png, .jpg, .gif, .svg
- Videos:
.mp4, .webm (browser-supported)
- Audio:
.mp3, .ogg, .aac
- Documents:
.pdf
How to view:
- Click file name
- Opens in new tab/window
- Uses appropriate browser viewer
Download-Only Files
Trigger immediate download:
- Executables:
.exe, .dll, .app
- Archives:
.zip, .rar, .7z
- Binary files: Various system files
- Security files: Keys, certificates
Downloading Files
Individual Files
- Click "DL" button next to file name
- File downloads to your default download location
- Original filename is preserved
- No size limits (depends on server configuration)
Folder Downloads
- Click "ZIP" button next to folder name
- ZIP archive created with folder contents
- Directory structure preserved within archive
- Automatic cleanup of temporary files
Download Availability
Download buttons may be missing if:
- Administrator disabled downloads
- File type restricted for security
- Insufficient server permissions
File Information
File Sizes
- Bytes (B): Small files under 1KB
- Kilobytes (KB): Files 1KB - 1MB
- Megabytes (MB): Files 1MB - 1GB
- Gigabytes (GB): Files over 1GB
Directory Sizes
- Calculated recursively: Includes all subdirectory contents
- Real-time calculation: May take time for large directories
- Cached results: Faster on subsequent visits
Modification Dates
- Format:
YYYY-MM-DD HH:MM
- Server timezone: Based on server location
- Sort capability: Click column to sort by date
Sorting & Organization
Quick Sort Options
Click column headers for immediate sorting:
- Name: Alphabetical A-Z ↔ Z-A
- Size: Small-to-large ↔ Large-to-small
- Modified: Oldest ↔ Newest
Active sort shown with arrow indicators (↑ ↓)
Advanced Sort Menu
Click options (⋯) for full menu:
By Name
- A-Z: Standard alphabetical order
- Z-A: Reverse alphabetical order
By Size
- Small to Large: Smallest files first
- Large to Small: Largest files first
By Date
- Oldest First: Earliest modifications first
- Newest First: Most recent modifications first
By Type
- A-Z: File extensions alphabetically
- Z-A: File extensions reverse alphabetically
Organization Features
Folders First
- Directories always appear before files
- Parent directory (..) appears first when present
- Consistent organization regardless of sort type
Mixed Content Handling
- Files and folders sorted separately
- Logical grouping by type and purpose
- Visual distinction with icons and formatting
Mobile Usage
Mobile Interface Features
Responsive design adapts to mobile screens:
- Touch-friendly buttons and links
- Optimized layout for narrow screens
- Simplified interface on small displays
- Gesture support follows browser standards
Mobile Navigation
Touch Controls
- Tap folder names to navigate
- Tap file names to view or download
- Pinch to zoom for detailed viewing
- Swipe gestures for browser navigation
Mobile-Specific Features
- Larger touch targets for easier interaction
- Simplified sort menu with essential options
- Optimized file display for mobile viewing
- Reduced visual clutter on small screens
Mobile Limitations
Viewing Limitations
- Limited file type support in mobile browsers
- Video playback may vary by device
- PDF viewing depends on browser capabilities
- Large files may cause performance issues
Download Considerations
- Storage space limitations on mobile devices
- Network speed affects download performance
- File management more complex on mobile
- ZIP extraction requires additional apps
Tips & Best Practices
Efficient Navigation
Quick Access
- Bookmark frequently used directories in your browser
- Use breadcrumbs for fast parent directory access
- Copy directory URLs for direct access
- Use browser history for recently visited directories
Finding Files
- Sort by modification date to find recent changes
- Sort by name for alphabetical browsing
- Sort by size to identify large files
- Use browser search (Ctrl+F) to find specific filenames
File Management
Before Downloading
- Check file sizes to estimate download time
- Verify file types to ensure compatibility
- Consider ZIP downloads for multiple files
- Check available storage space
Viewing Files
- Try viewing before downloading when possible
- Use browser back button to return to directory
- Right-click links to copy URLs for sharing
- Open in new tabs to keep directory listing open
Performance Tips
For Large Directories
- Allow time for initial loading - subsequent visits are faster with caching
- Use specific directory URLs instead of browsing from root
- Close unnecessary browser tabs to free memory
- Clear browser cache if experiencing display issues
For Slow Connections
- Avoid large file downloads on slow connections
- Use text file viewing instead of downloading
- Consider ZIP downloads for multiple small files
- Be patient with large directory listings
Troubleshooting
Common Issues
Files not appearing:
- Administrator may have filtered certain file types
- Hidden files require special configuration
- Check with administrator about access policies
Cannot download files:
- Downloads may be disabled by administrator
- Check browser popup blockers
- Verify sufficient disk space
- Try different browser if issues persist
Slow performance:
- Large directories take time to load initially
- Network speed affects all operations
- Clear browser cache and cookies
- Try different browser or device
Display issues:
- Icons may not load if not configured locally
- Interface adapts to different screen sizes
- Try refreshing the page or clearing cache
Browser Compatibility
Best experience with:
- Chrome/Chromium (latest versions)
- Firefox (latest versions)
- Safari (latest versions)
- Edge (latest versions)
Limited support:
- Internet Explorer (outdated, not recommended)
- Older mobile browsers (reduced functionality)
Getting Help
If you encounter issues:
- Refresh the page (F5 or Ctrl+R)
- Clear browser cache and cookies
- Try a different browser
- Contact the server administrator
- Check browser console for error messages (F12)
Remember that specific functionality may vary based on administrator configuration and server environment.
Configuration Notes for Users
Feature Availability
Available features depend on administrator settings and manual configuration:
- File downloads may be enabled or disabled
- Folder ZIP downloads may be available
- File viewing capabilities may vary
- Sorting and display options may be customized
- Icon display depends on local icon configuration
Visual Elements
The indexer operates entirely offline with:
- Local icons - All icons served from the server itself
- No external resources - Fully self-contained operation
- Consistent performance - No dependency on external services
- Privacy-focused - No external connections or tracking
Customization
The appearance and behavior may vary based on:
- Administrator configuration settings
- Security policies in place
- Network and server environment
- Organizational requirements
- Manual configuration choices
This user guide covers the standard features available in 5q12's Indexer. All functionality is now locally provided with no external dependencies.