Skip to content

v2.3.1

Choose a tag to compare

View all tags
@OliverZhaohaibin OliverZhaohaibin released this 07 Dec 15:17
· 2187 commits to main since this release
v2.3.1
813baff
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🌓 iPhoto v2.3.1 — Dark Mode now release！

📸 Seamlessly switch between Light and Dark themes for the perfect photo viewing experience.

We're thrilled to announce iPhoto v2.3.1! 🎉
This release introduces comprehensive Dark Mode support, bringing a refined visual experience that adapts to your preferences and environment.

🖼 Overview

iPhoto v2.3.1 builds upon the powerful folder-native photo management and non-destructive editing features from v2.0.0, now with full theme customization.

Experience your photos in the lighting that suits you best:

  • 🌞 Light Mode — Bright, clean interface for well-lit environments
  • 🌙 Dark Mode — Easy on the eyes for low-light viewing
  • 🔄 System Default — Automatically follows your OS theme preferences

All while maintaining the folder-native, non-destructive philosophy that makes iPhoto unique.

✨ What's New in v2.3.1

🌓 Comprehensive Dark Mode Support

The headline feature of v2.3.1! A fully integrated theming system that transforms the entire application:

Three Theme Options

iPhoto now offers flexible theme control through Settings → Appearance:

  1. 🔄 System Default (Recommended)

    • Automatically detects and follows your operating system's theme preference
    • Seamlessly switches when you change your system settings
    • Perfect for users who adjust their OS theme throughout the day

  2. 🌞 Light Mode

    • Bright, clean interface with high contrast
    • Optimized for well-lit environments and outdoor use
    • Familiar look that matches the original iPhoto design
    • Light gray sidebar (#eef3f6) with subtle blue accent colors

  3. 🌙 Dark Mode

    • Rich dark interface with carefully calibrated colors
    • Reduces eye strain during extended viewing sessions
    • Perfect for photo editing in dim lighting
    • Deep background (#1C1C1E) with warm text tones (#F5F5F7)
image

Intelligent Theme Application

The theme system intelligently adapts the entire UI:

  • 🎨 Window Chrome & Sidebar
    Every interface element — from the title bar to the sidebar navigation — seamlessly transitions between light and dark palettes.

  • 📊 Consistent Color Semantics
    Text colors, borders, hover states, and selection highlights are carefully defined for each theme to maintain readability and visual hierarchy.

  • 🖼 Smart Surface Colors
    The photo viewing area uses optimal background colors for each mode:

    • Light mode: Neutral light gray (#F5F5F5) for comfortable viewing
    • Dark mode: Pure black (#000000) for maximum contrast and true color reproduction

  • 🎛 Edit Mode Override
    When you enter Edit Mode, iPhoto automatically switches to dark theme regardless of your global setting. This ensures optimal contrast for making precise adjustments to exposure, color, and tone. Exiting edit mode restores your preferred theme.

Smooth Transitions

Theme changes are instant and seamless:

  • No restart required — switches happen immediately
  • Animated color transitions for window chrome (when entering/exiting edit mode)
  • All UI elements update synchronously
  • Settings are persisted and restored on next launch

Theme-Aware Components

Every major component has been updated to support theming:

  • Navigation Sidebar: Theme-aware icons and selection highlighting
  • Asset Grid: Adaptive thumbnail borders and spacing
  • Detail Viewer: Smart background colors for optimal photo viewing
  • Info Panel: Readable metadata display in both light and dark modes
  • Edit Panels: Professionally designed control surfaces
  • Context Menus: System-integrated menu styling
  • Dialogs & Alerts: Consistent theming throughout

🎯 Additional Improvements in v2.3.1

Beyond dark mode, this release includes refinements and polish:

Enhanced Edit Mode Experience

  • Edit mode now always uses dark theme for consistent, professional color grading environment
  • Improved contrast in adjustment panels
  • Better visibility of sliders and controls

Refined Color Palette

  • Carefully calibrated accent colors for both themes
  • Improved text contrast ratios for accessibility
  • Semantic color definitions ensure consistency across all UI elements

Performance Optimizations

  • Faster theme switching with optimized palette updates
  • Reduced overhead in color calculations
  • Improved responsiveness during rapid theme changes

Better System Integration

  • Native detection of macOS and Windows system theme preferences
  • Automatic updates when system theme changes (System Default mode)
  • Respects OS-level accessibility settings

🎯 Core Features (Carried Forward from v2.0.0)

All the beloved features from previous versions remain fully supported and now look great in both light and dark themes:

  • 🎥 Full Live Photo Support
    Automatically pairs HEIC/JPG + MOV files by content-ID or timestamp, with a "LIVE" badge and inline playback.

  • 🗺 Interactive Map View
    Reads GPS metadata and displays your photo footprints on an interactive map.

  • 🗂 Folder = Album
    Each folder becomes an album, managed by .iphoto.album.json (or .iphoto.album).

  • 🧠 Smart Albums
    Built-in "Library", "All Photos", "Videos", "Favorites", and "Recently Deleted" views.

  • 🎨 Non-Destructive Photo Editing
    Comprehensive editing suite with Adjust and Crop modes, now with enhanced dark mode support.

  • 🖼 Immersive Detail Viewer
    Elegant photo/video viewer with filmstrip navigation and floating playback controls.

  • ℹ️ Floating Metadata Panel
    Inspect EXIF, camera/lens info, shutter speed, aperture, file size, etc.

  • ⚙️ Rich Desktop Interactions
    Drag-and-drop import, context menus, incremental scanning, async thumbnail loading.

🏁 Getting Started with Themes

Changing the Theme

  1. Open Settings Menu
    Click Settings in the menu bar at the top of the window

  2. Select Appearance
    Navigate to Settings → Appearance

  3. Choose Your Theme

    • System Default — Follow your OS theme (recommended)
    • Light Mode — Always use light theme
    • Dark Mode — Always use dark theme

  4. Instant Application
    The theme changes immediately — no restart needed!

image

Edit Mode Behavior

When you enter Edit Mode by clicking the Edit button:

  • iPhoto automatically switches to Dark Mode for optimal color grading
  • This happens regardless of your global theme setting
  • Provides consistent, professional environment for photo adjustments
  • Exiting Edit Mode restores your preferred theme

System Integration

If you choose System Default:

  • iPhoto automatically detects your OS theme preference
  • On macOS: Follows System Preferences → Appearance
  • On Windows: Follows Settings → Personalization → Colors
  • Updates in real-time when you change your system theme

💬 Feedback

We'd love to hear from you!
If you encounter any issues or have ideas for improvement, please open a ticket on GitHub Issues.
Your feedback helps shape the future of iPhoto. 💙
Thank you for your support!

🇨🇳 iPhoto v2.3.1 — 深色模式正式发布！

我们非常高兴地宣布 iPhoto v2.3.1 正式发布！🎉
此版本引入了 全面的深色模式支持，带来了一个适应您偏好和环境的精致视觉体验。

🖼 核心理念

iPhoto v2.3.1 在 v2.0.0 强大的文件夹原生照片管理和非破坏性编辑功能基础上，现已支持 完整的主题自定义。

以最适合您的光线体验您的照片：

  • 🌞 浅色模式 — 适用于明亮环境的清爽界面
  • 🌙 深色模式 — 低光环境下更舒适的观看体验
  • 🔄 跟随系统 — 自动跟随您的操作系统主题偏好

同时保持了使 iPhoto 独特的文件夹原生、非破坏性理念。

✨ v2.3.1 新增功能

🌓 全面的深色模式支持

v2.3.1 的核心功能！一个完全集成的主题系统，可以转换整个应用程序：

三种主题选项

iPhoto 现在通过 设置 → 外观 提供灵活的主题控制：

  1. 🔄 跟随系统（推荐）

    • 自动检测并跟随您的操作系统主题偏好
    • 当您更改系统设置时无缝切换
    • 适合全天调整操作系统主题的用户

  2. 🌞 浅色模式

    • 明亮、清爽的高对比度界面
    • 针对明亮环境和户外使用优化
    • 符合原始 iPhoto 设计的熟悉外观
    • 浅灰色侧边栏 (#eef3f6)，带有微妙的蓝色强调色

  3. 🌙 深色模式

    • 色彩精心校准的丰富深色界面
    • 减少长时间观看时的眼睛疲劳
    • 非常适合在昏暗光线下进行照片编辑
    • 深色背景 (#1C1C1E)，温暖的文本色调 (#F5F5F7)
image
智能主题应用

主题系统智能地适配整个 UI：

  • 🎨 窗口框架和侧边栏
    从标题栏到侧边栏导航，每个界面元素都在浅色和深色调色板之间无缝过渡。

  • 📊 一致的色彩语义
    为每个主题精心定义了文本颜色、边框、悬停状态和选择高亮，以保持可读性和视觉层次。

  • 🖼 智能表面颜色
    照片查看区域为每种模式使用最佳背景色：

    • 浅色模式：中性浅灰色 (#F5F5F5)，舒适观看
    • 深色模式：纯黑色 (#000000)，最大对比度和真实色彩还原

  • 🎛 编辑模式覆盖
    当您进入 编辑模式 时，iPhoto 会自动切换到深色主题，无论您的全局设置如何。这确保了在进行曝光、色彩和色调的精确调整时获得最佳对比度。退出编辑模式会恢复您首选的主题。

流畅过渡

主题更改即时无缝：

  • 无需重启 — 立即切换
  • 窗口框架的动画颜色过渡（进入/退出编辑模式时）
  • 所有 UI 元素同步更新
  • 设置持久化并在下次启动时恢复
主题感知组件

每个主要组件都已更新以支持主题：

  • 导航侧边栏：主题感知图标和选择高亮
  • 资产网格：自适应缩略图边框和间距
  • 详情查看器：为最佳照片观看提供智能背景色
  • 信息面板：在浅色和深色模式下都可读的元数据显示
  • 编辑面板：专业设计的控制界面
  • 右键菜单：系统集成的菜单样式
  • 对话框和警告：整体一致的主题

🎯 v2.3.0 的其他改进

除了深色模式，此版本还包括优化和润色：

增强的编辑模式体验

  • 编辑模式现在始终使用深色主题，提供一致、专业的色彩分级环境
  • 改进了调整面板中的对比度
  • 更好的滑块和控件可见性

精心优化的调色板

  • 为两个主题精心校准的强调色
  • 提高文本对比度以增强可访问性
  • 语义色彩定义确保所有 UI 元素的一致性

性能优化

  • 通过优化调色板更新实现更快的主题切换
  • 减少色彩计算开销
  • 提高快速主题更改时的响应速度

更好的系统集成

  • 原生检测 macOS 和 Windows 系统主题偏好
  • 系统主题更改时自动更新（跟随系统模式）
  • 尊重操作系统级别的辅助功能设置

🎯 核心功能（继承自 v2.0.0）

之前版本的所有核心功能均得到完整保留，现在在浅色和深色主题下都很美观：

  • 🎥 完整的 Live Photo 支持：自动配对 HEIC/JPG 与 MOV 文件，静态照片带 "LIVE" 徽章，可直接播放动态视频。
  • 🗺 交互式地图视图：自动读取照片与视频的 GPS 信息，聚合显示拍摄地点。
  • 🗂 文件夹即相册：每个文件夹均视为相册，通过 .iphoto.album.json 管理。
  • 🧠 智能相册：内置"图库"、"所有照片"、"视频"、"收藏"、"最近删除"等自动聚合视图。
  • 🎨 非破坏性照片编辑：带有调整和裁剪模式的综合编辑套件，现已增强深色模式支持。
  • 🖼 沉浸式查看器：带胶片条与浮动播放控件的照片/视频查看体验。
  • ℹ️ 浮动信息面板：查看 EXIF、相机/镜头、光圈、快门速度、文件大小等元数据。
  • ⚙️ 桌面级交互体验：支持拖拽导入、右键菜单、异步扫描、增量加载缩略图等。

🏁 主题入门指南

更改主题

  1. 打开设置菜单
    点击窗口顶部菜单栏中的 设置（Settings）

  2. 选择外观
    导航到 设置 → 外观（Appearance）

  3. 选择您的主题

    • 跟随系统（System Default） — 跟随您的操作系统主题（推荐）
    • 浅色模式（Light Mode） — 始终使用浅色主题
    • 深色模式（Dark Mode） — 始终使用深色主题

  4. 立即应用
    主题立即更改 — 无需重启！

image

编辑模式行为

当您通过点击 编辑（Edit） 按钮进入编辑模式时：

  • iPhoto 自动切换到 深色模式，以实现最佳色彩分级
  • 无论您的全局主题设置如何，都会发生这种情况
  • 为照片调整提供一致、专业的环境
  • 退出编辑模式会恢复您首选的主题

系统集成

如果您选择 跟随系统：

  • iPhoto 自动检测您的操作系统主题偏好
  • 在 macOS 上：跟随系统偏好设置 → 外观
  • 在 Windows 上：跟随设置 → 个性化 → 颜色
  • 当您更改系统主题时实时更新

💬 反馈与建议

我们非常期待您的反馈！
如果您在使用中发现问题，或有新的功能建议，欢迎前往 GitHub Issues 提交。
每一条意见都将帮助我们让 iPhoto 变得更好。💙
感谢您的支持！

🔧 Technical Details / 技术细节

Theme Architecture / 主题架构

iPhoto v2.3.1 implements a comprehensive theming system built on Qt's palette mechanism:

iPhoto v2.3.1 实现了一个基于 Qt 调色板机制的综合主题系统：

ThemeManager — Central theme controller / 中央主题控制器

  • Manages three theme modes: system, light, and dark / 管理三种主题模式：system、light 和 dark
  • Detects system theme preferences via QGuiApplication.styleHints().colorScheme() / 通过 QGuiApplication.styleHints().colorScheme() 检测系统主题偏好
  • Emits themeChanged signal when the effective theme changes / 当有效主题更改时发出 themeChanged 信号
  • Supports forced dark mode override for Edit View / 支持编辑视图的强制深色模式覆盖

ThemeColors — Semantic color definitions / 语义色彩定义

Two predefined color schemes with semantic naming:

两个预定义的色彩方案，具有语义命名：

Light Theme Colors:

  • window_background: #F5F5F5 — Main surface color
  • text_primary: #2b2b2b — Primary text
  • sidebar_background: #eef3f6 — Sidebar surface
  • accent_color: Blue — Links and highlights
  • border_color: Semi-transparent black

Dark Theme Colors:

  • window_background: #1C1C1E — Main surface color (iOS-inspired)
  • text_primary: #F5F5F7 — Primary text (warm white)
  • sidebar_background: #2C2C2E — Sidebar surface (lighter than main)
  • accent_color: #0A84FF — iOS-style blue
  • border_color: #323236 — Subtle borders

WindowThemeController — UI synchronization / UI 同步

Coordinates theme updates across all widgets:

协调所有小部件的主题更新：

  • Updates window chrome, sidebar, status bar, and toolbar colors

  • Manages icon tinting for SVG icons

  • Handles edit mode dark theme override

  • Provides smooth animated transitions for window background

  • 更新窗口框架、侧边栏、状态栏和工具栏颜色

  • 管理 SVG 图标的色调

  • 处理编辑模式深色主题覆盖

  • 为窗口背景提供流畅的动画过渡

Settings Schema / 设置架构

Theme preference is stored in the settings file as:

主题偏好存储在设置文件中：

{
  "ui": {
    "theme": "system"  // or "light" or "dark"
  }
}

Default value is "system" which automatically follows OS preferences.
默认值为 "system"，自动跟随操作系统偏好。

Color Accessibility / 色彩可访问性

All theme colors meet WCAG contrast requirements:

所有主题颜色都符合 WCAG 对比度要求：

  • Light Mode: Minimum 4.5:1 contrast ratio for normal text

  • Dark Mode: Minimum 4.5:1 contrast ratio for normal text

  • Disabled text uses reduced opacity for visual hierarchy

  • 浅色模式：正常文本最小对比度 4.5:1

  • 深色模式：正常文本最小对比度 4.5:1

  • 禁用文本使用降低的不透明度以实现视觉层次

📊 Version Comparison / 版本对比

Feature / 功能 v2.1.1 v2.3.1
Folder-native albums / 文件夹原生相册 ✅ ✅
Live Photo support / Live Photo 支持 ✅ ✅
Map view / 地图视图 ✅ ✅
Non-destructive editing / 非破坏性编辑 ✅ ✅
Light adjustments / 光线调整 ✅ ✅
Color adjustments / 色彩调整 ✅ ✅
Crop & Perspective / 裁剪和透视 ✅ ✅
Light Mode / 浅色模式 ✅ (仅支持) ✅
Dark Mode / 深色模式 ❌ ✅
System theme detection / 系统主题检测 ❌ ✅
Theme switching / 主题切换 ❌ ✅
Edit mode dark override / 编辑模式深色覆盖 ❌ ✅
Theme-aware icons / 主题感知图标 ❌ ✅

iPhoto v2.3.1 — View your photos in perfect lighting, every time.
iPhoto v2.3.1 — 每次都以完美的光线查看您的照片。

Assets 3
Loading