Settings
Beta Status
Phosor is currently in an Internal Beta stage. Features may change before the public release. Performance may occasionally be inconsistent depending on hardware, image formats, and library size. Unexpected bugs may still occur. Feedback from beta testers is highly appreciated.
This page covers the application's UI components and configuration options: the sidebar, toast notifications, and modal dialogs.
Sidebar
The sidebar contains the Source section, Categories section, Metadata section, and Action section. It is resizable and responsive.
Layout
- The sidebar appears on the right side of the main viewer.
- Drag the divider between the viewer and sidebar to resize.
- The sidebar width is constrained between 200px and 40% of the window width.
- On small viewports (below 800px width or 500px height), the sidebar hides automatically.
Behavior
- The sidebar width is remembered across sessions via local storage.
- The sidebar auto-sizes on first load to 80% of the maximum allowed width.
- The resizer is hidden on small screens along with the sidebar.
Sections
| Section | Description |
|---|---|
| Source | Displays the current folder path and allows changing the source |
| Categories | Lists all categories with their names, colors, keybindings, and output folders |
| Metadata | Shows EXIF metadata for the current photo (toggle with ⌘M / Ctrl+M) |
| Action | Contains the "Execute →" button for batch moving |
No manual hide on large screens
The sidebar cannot be manually hidden on large screens. There is no collapse/expand toggle button. See the Roadmap for planned improvements.
Toast Notifications
Phosor shows brief, non-intrusive toast notifications at the bottom of the screen to provide feedback for user actions.
Behavior
- Toasts appear automatically when actions are performed (sorting, toggling modes, opening folders, etc.).
- Each toast displays for 3 seconds, then disappears.
- Only one toast is visible at a time — new toasts replace the current one.
- Toasts are color-coded by type (success, error, warning, info, category, etc.).
Toast Types
| Type | Description |
|---|---|
| Success | Action completed successfully |
| Error | An error occurred |
| Warning | A warning that requires attention |
| Info | General information |
| Category | Category assignment (displays the category color) |
Debug toasts
Debug toasts (prefixed with "[DEBUG]") are only visible in development mode.
Limitations
- There is no toast history or log.
- Toasts cannot be dismissed manually (they must time out).
Modal Dialogs
Phosor uses a modal system for all confirmation, alert, warning, error, and progress dialogs.
Modal Types
| Type | Buttons | Use Case |
|---|---|---|
| Alert | OK | Information that requires acknowledgment |
| Confirm | Cancel + Confirm | Actions that need explicit confirmation |
| Warning | Cancel + Continue | Actions with potential consequences |
| Error | OK (+ Show Details) | Errors with optional expandable details |
| Progress | (spinner) | Long-running operations |
Behavior
- Modals appear automatically when confirmation is needed (e.g., executing a move, deleting a category).
- Press Enter to confirm, Escape to cancel, or click the buttons.
- Tab navigation is trapped within the modal for accessibility.
- Only one modal is visible at a time; additional requests are queued.
- Destructive actions use red styling for the confirm button.
- Progress modals show a spinner, progress bar, percentage, and status text.
Limitations
- Modals cannot be dismissed by clicking outside (except for the shortcut guide).
- There is no modal timeout — they must be explicitly dismissed.