Photos View

Overview

The Photos View is a comprehensive file manager for browsing, organizing, and managing captured images and directories.

Features

• Hierarchical directory navigation with breadcrumbs
• Multiple view modes (list and thumbnail)
• File operations (create, rename, delete)
• Batch selection and operations
• Sorting options (name, date, size)
• Directory creation
• Full-screen image preview modal
• FITS and DNG specialized viewers in modal
• RGB histogram overlay for standard image previews
• Histogram control embedded in the lower-right of the overlay (click "Hist" to collapse/expand)

Navigation

Access the Photos View at /photos.

View Modes

List View (≡)

• Tabular display with columns:
  • Checkbox for selection
  • Name (files and folders)
  • Size (formatted)
  • Modified date
• Sortable by clicking column headers
• Efficient for large file sets

Thumbnail View (⊞)

• Grid of image thumbnails
• Visual preview of photos
• Quick browsing
• Click to select/view
• Timelapse folders can be browsed into directly and rendered as thumbnail grids

File Operations

Navigate Directories

• Click breadcrumb segments to navigate up
• Click folder names to navigate down
• Breadcrumbs show current path

Create New Folder

1. Click "+ New Folder" button
2. Enter folder name in dialog
3. Folder appears in current directory

Rename File/Folder

1. Select single item (checkbox)
2. Click "Rename" button
3. Enter new name
4. Item updates immediately

Delete Files/Folders

1. Select one or more items (checkboxes)
2. Click "Delete (n)" button showing count
3. Confirm deletion
4. Items removed permanently

Batch Operations

• Select multiple files using checkboxes
• Use "Select All" checkbox in header
• Delete button shows selection count
• Operations apply to all selected items

Sorting Options

Sort By

• Name: Alphabetical order
• Date: Modification time
• Size: File size

Sort Order

• Ascending: A-Z, oldest first, smallest first
• Descending: Z-A, newest first, largest first

File Display

• Files show size in human-readable format (KB, MB, GB)
• Folders show as directories
• Modified date and time displayed
• Visual indication of file types
• Opening a standard image in the viewer shows the full image and its histogram overlay when a sidecar histogram file exists

Selection

• Individual checkboxes for each item
• "Select All" checkbox in list header
• Selected items highlighted
• Selection count displayed

Empty State

When a directory is empty:

• "This directory is empty" message displays
• Create folder button available
• Navigate up via breadcrumbs

Error Handling

• Success messages for completed operations
• Error messages for failed operations
• Loading indicator during operations
• Validation for file/folder names

Technical Details

• Uses /api/files endpoints for operations
• Supports query parameters for path navigation
• Dynamic loading based on current path
• Efficient rendering for large directories
• Thumbnail view prefers generated sidecar thumbnails (.thumb-152.jpg) with fallback to original images
• Histogram overlay reads sidecar histogram files (.histogram_table.txt) when available