Skip to main content

PicView

專注於快速載圖與多圖比較的圖片資料夾檢視器,使用 Qt 打造。

English

主要特色

快速載圖

  • 優先載入目前圖片與可見範圍的縮圖,其餘縮圖在背景逐步補上,縮短開啟資料夾的等待時間。
  • 縮圖保留於記憶體,切換標籤與調整版面時可重用,不必反覆解碼,也不另存縮圖檔案。

多圖比較

  • 將標籤或縮圖拖到單圖窗格即可開始比圖,支援不同資料夾,也能在同一資料夾比較不同圖片。
  • 每個比圖窗格可各自選圖、縮放、旋轉、鏡射與捲動,方便檢查細節與差異。

安裝與啟動

桌面版下載

  • 已附加桌面版的版本可從 GitHub Releases 下載,不需要安裝 Python 或 uv。
  • Windows x64:直接執行 PicView-<版本>-windows-x64.exe。
  • macOS Apple Silicon:開啟 PicView-<版本>-macos-arm64.dmg,將 PicView.app 拖曳到 Applications。
  • 桌面版目前沒有 Windows 發行者簽章或 Apple Developer ID 公證,首次開啟時可能會出現系統提示或遭到阻擋。

使用 uv

  • 需要先安裝 uv,並在圖形桌面環境執行。PicView 目前於 Windows 開發與測試。

  • 不永久安裝工具,直接執行:

    uvx picview
    
  • 安裝為命令列工具,再啟動:

    uv tool install picview
    picview
    
  • 更新已安裝的版本:

    uv tool upgrade picview
    
  • 查詢版本:

    picview --version
    # 或不安裝直接查詢:
    uvx picview --version
    

從原始碼啟動

在專案目錄中執行:

uv run picview

macOS 從 Python/uv 啟動時,Dock 使用 PicView 圖示,但選單列名稱仍可能顯示 Python;使用桌面版 PicView.app 可取得完整的應用程式名稱與圖示。

使用方式

視窗與工具列

  • 視窗最小可縮至 260 × 220 px。
  • 主工具列獨立一列:左側為開啟與版面工具,右側為修改時間顯示、語言與配色工具。
  • 資料夾標籤位於縮圖窗格內,與右側的縮圖工具共用一列;切換標籤時會跟隨目前的縮圖窗格。
  • 標籤超出可見範圍時,左右捲動箭頭分別顯示於標籤列兩側;左右箭頭與標籤清單的向下箭頭採細線條樣式。
  • 單圖窗格的符合窗格、最大化窗格與全螢幕工具位於右側縮放比例與滑桿之前;比圖模式的共用工具列也採用相同排列。
  • 將滑鼠停在按鈕或縮放控制上,可從提示查看已設定的快捷鍵;收合選單也會顯示對應按鍵。
  • 淺色與深色配色的縮圖卡片皆採用獨立底色與細邊框,捲動時也能清楚辨識卡片邊界。
  • 符合窗格、同步等狀態按鈕以 hover 底色與主題強調色圖示表示啟用,線條粗細不變。
  • 主工具列、縮圖與單圖工具列放不下的工具會收進 更多工具。
  • 放寬視窗後,收起的工具會自動恢復。
  • 縮圖會優先載入可見範圍,其餘在背景逐步製作。
  • 縮圖使用共用的記憶體快取(上限 64 MiB),不另存縮圖檔案。
  • 調整窗格大小只重新排列縮圖,不會重新解碼所有圖片。
  • 滑桿收起時,可從更多工具選單輸入縮放比例或縮圖大小。
  • 視窗標題會顯示目前版本,例如 PicView v0.1.6。

開啟與拖放圖片

  • 點擊 開啟資料夾,選擇要檢視的資料夾。
  • 將資料夾或圖片檔案拖曳至視窗,也能開啟檢視。
  • 按住縮圖或檔名拖曳,可將原始圖檔拖放至接受檔案的其他應用程式。
  • 旋轉與鏡射只影響檢視畫面,不會修改圖檔。

圖片與窗格工具

按鈕 操作
旋轉 旋轉目前圖片
水平鏡射 水平鏡射目前圖片
垂直鏡射 垂直鏡射目前圖片
符合窗格 切換符合窗格與原始大小
最大化窗格 最大化縮圖或單圖窗格
還原窗格 還原窗格布局
全螢幕 開啟目前圖片的全螢幕檢視

縮圖排序、日期與檔案操作

  • 縮圖工具列的排序方式按鈕,在 檔名排序 檔名(自然排序) 與 修改時間排序 修改時間 間切換。
  • 旁邊的排序方向按鈕,在 順向排序 順向 與 逆向排序 逆向 間切換;修改時間順向為舊到新,逆向為新到舊。排序不會切換目前圖片或重設檢視狀態。
  • 主工具列語言按鈕前的 顯示修改日期時間 切換 顯示修改日期時間,立即套用到所有標籤,並保留至下次開啟程式;新開與複製標籤也沿用此全域設定。
  • 縮圖卡片底部預設顯示本機時間的修改日期時間;卡片太窄時,將滑鼠停在日期上可查看完整時間。
  • 各標籤獨立保存排序方式與方向,複製標籤及重開程式時也會保留。新增或修改檔案後,排序與日期會自動更新。
  • 在縮圖卡片按滑鼠右鍵,選 複製 可將原始圖檔複製到剪貼簿,再貼至其他應用程式或資料夾。
  • 右鍵選單的 內容 在 Windows 開啟檔案總管原生內容視窗;其他平台或系統視窗無法開啟時,顯示檔名、類型、位置、大小、修改時間、圖片尺寸,以及可取得的建立時間。
  • 工具列空間不足時,可從對應工具列的 ⋯ 更多工具 操作排序與日期顯示按鈕。

支援格式

  • 點陣圖片:JPEG、PNG、WebP、BMP、GIF、TIFF。
  • 向量圖片:靜態 SVG。
  • SVG 保留透明背景,縮放時會依顯示尺寸重新繪製。
  • SVG 支援比圖、旋轉、鏡射及全螢幕。
  • SVG 動畫目前以靜態畫面顯示。

資料夾監看與自動更新

  • 所有已開啟的資料夾都會自動監看檔案變更。
  • 新增圖檔:自動加入縮圖窗格,保留目前檢視的圖片。
  • 修改圖檔:自動更新縮圖、單圖及全螢幕畫面。
  • 更新時保留縮放、旋轉、鏡射與捲動位置。
  • 檔案尚未寫完時,先保留上一版完整畫面。
  • 目前圖片被刪除:底部顯示通知,並移到排序中的下一張。
  • 最後一張被刪除:回到第一張;資料夾清空時,清除大圖。
  • 背景標籤的圖片被刪除:標籤顯示 ●,切回後顯示通知。
  • 背景標籤的動畫會暫停。

多資料夾標籤

  • 點擊主工具列的 開啟資料夾,在新標籤開啟資料夾。
  • 標籤列最右側的 選取標籤 展開所有標籤的下拉清單,依標籤順序排列,可直接選取要切換的標籤;勾選標記表示目前標籤。
  • 清單顯示完整標籤名稱,將滑鼠停在項目上可查看資料夾完整路徑。
  • 一次拖入多個資料夾,會逐一開啟標籤。
  • 同一資料夾可開啟多個標籤,各自選圖,方便比較不同圖片。
  • 在標籤上按右鍵 → 複製標籤,在原標籤旁建立副本。
  • 副本會保留原標籤的選圖與檢視狀態。
  • 比圖模式中,複製已加入的標籤,副本也會加入比圖。
  • 沿標籤列拖曳可調整順序;將標籤往下拖到單圖窗格可加入比圖。
  • 單擊標籤會在放開滑鼠時切換;拖曳標籤時維持原本檢視的資料夾。
  • 空間不足時先收合次要工具;標籤過多時可水平捲動,長名稱會省略顯示。
  • 選取底線會在左右捲動箭頭前裁切,不會從箭頭下方露出;淺色與深色配色皆適用。
  • 左右捲動箭頭固定在標籤列兩端,統一採用細線角括號樣式,與右側的下拉箭頭一致。
  • 新增、切換或調整視窗大小後,目前標籤會自動保持可見。
  • 點擊標籤的關閉按鈕可關閉;關閉最後一頁後,會保留空白標籤。
  • 各標籤獨立保留選圖、縮放、旋轉、鏡射、捲動、縮圖大小與窗格布局。
  • 語言與配色由所有標籤共用。
  • 重開程式會還原所有標籤、順序與目前標籤。
  • 暫時不存在的資料夾會保留標籤,重新出現後自動恢復。
  • 標籤快捷鍵請見下方「鍵盤快捷鍵」。

比較圖片

  • 將標籤或縮圖拖到單圖窗格,會保留原窗格並加入拖入的圖片,立即開始比圖。
  • 繼續拖到任一比圖窗格,可依拖入順序加入更多窗格;各窗格平均分配空間,過小時會停止加入。
  • 再拖入已在比圖中的標籤或縮圖,會建立獨立標籤,方便比較同一資料夾的不同圖片。
  • 上下版面 上下版面:比較圖片左右並排。
  • 左右版面 左右版面:比較圖片上下排列。
  • 切換到各標籤,從縮圖選擇該資料夾要比較的圖片。
  • 比較窗格共用上方工具列。
  • 點擊圖片窗格,會選取該窗格、切換到對應標籤與縮圖,並將共用工具列指向該窗格;選中窗格會顯示重點色外框。
  • 使用方向鍵、Home/End、Page Up/Page Down、Space 或 Backspace 切換圖片時,只操作選中窗格所屬的資料夾。
  • 預設各窗格可獨立縮放、旋轉、鏡射、設定背景色及捲動。
  • 點擊單圖工具列的 同步操作,可同步旋轉、鏡射、縮放、符合窗格、背景色,以及水平與垂直捲動到所有比圖窗格。不同尺寸的圖片會依捲動比例對齊;再次點擊恢復獨立操作。
  • 比較中的背景圖片也會即時更新。
  • 點擊各比圖窗格右上角的關閉按鈕可將該資料夾移出比圖;剩下一個窗格時自動回到一般檢視,並保留各標籤的選圖與操作狀態。

縮放與縮圖大小

  • 圖片未超出窗格時,以原始大小 100% 顯示。
  • 較大的圖片會自動縮放至符合窗格。
  • 點擊 符合窗格,切換符合窗格與原始大小。
  • 拖曳縮放滑桿,或按 + / -,調整顯示比例。
  • 按 0 回到 100%。
  • 全螢幕只將超出螢幕的圖片等比例縮小;小圖維持原尺寸並置中,完整顯示、不裁切。
  • 離開全螢幕後保留原本窗格的縮放、旋轉與鏡射設定。
  • 點擊滑桿左側的數值,輸入精確的縮放百分比或縮圖大小。
  • 在數值輸入視窗按 Enter 套用。
  • 按 Esc 或點擊視窗外部取消。
  • 點擊重設按鈕,還原 100% 縮放或 140 px 縮圖大小。

透明圖片的背景色

  • 點擊單圖工具列的 圖片背景色,展開背景色面板。
  • 選擇 預設(跟隨主題),沿用目前配色主題的圖片背景。
  • 可改選白、黑、灰、淺灰、米、淺藍、淺綠或淺粉色,讓透明圖片的細節更容易辨識。
  • 另提供深灰、灰藍、深藍、深綠、深紫、深紅、深棕與深青色背景,方便檢視淺色圖片。
  • 16 種背景色以四欄色塊排列,顏色名稱以滑鼠提示顯示;「預設」保留文字,底色反映目前主題的預設背景色。
  • 背景色立即套用到單圖與全螢幕,不會修改圖檔或縮圖背景。
  • 各標籤與比圖窗格可獨立設定;複製標籤與重開程式會保留選擇。
  • 工具列空間不足時,可從 ⋯ 更多工具 開啟背景色面板。

鍵盤快捷鍵

操作 快捷鍵
上一張圖片 Left(左方向鍵)、Page Up 或 Backspace
下一張圖片 Right(右方向鍵)、Page Down 或 Space(空白鍵)
上一列/下一列縮圖 Up(上方向鍵)/Down(下方向鍵)
第一張/最後一張圖片 Home / End
切換符合窗格(Fit) Alt+F
順時針旋轉 Alt+C
上下/左右鏡射 Alt+V / Alt+H
上下/左右版面 Alt+Shift+V / Alt+Shift+H
開啟全螢幕 F11
關閉全螢幕 Esc
開啟資料夾 系統的「開啟」快捷鍵
在新標籤開啟資料夾 Ctrl+T
關閉目前標籤 Ctrl+W
下一個/上一個標籤(循環切換) Ctrl+Tab / Ctrl+Shift+Tab,或 Ctrl+Page Down / Ctrl+Page Up
切換到第 1~8 個標籤 Ctrl+1~Ctrl+8
切換到最後一個標籤 Ctrl+9
重新開啟剛關閉的標籤 Ctrl+Shift+T(還原位置與檢視狀態,保留最近 20 筆,限本次執行)
將選取的圖片檔案複製到剪貼簿 Ctrl+C(Windows / Linux)、Command+C(macOS)
  • macOS 的新增、關閉、數字切換與重新開啟標籤:使用 Command 取代 Ctrl。
  • 前後切換標籤也支援系統預設快捷鍵。

語言

  • 點擊語言按鈕,依序切換 跟隨系統 → 中文 → 英文。
  • 圖示依序為 語言跟隨系統 → 中文 → 英文。
  • 預設跟隨系統:中文系統顯示中文,其餘顯示英文。
  • 重開程式會保留語言選擇。

配色

  • 點擊配色按鈕,依序切換 跟隨系統 → 淺色 → 深色。
  • 圖示依序為 配色跟隨系統 → 淺色 → 深色。
  • 預設為 跟隨系統。
  • 深色介面採初號機風格:深紫色窗格、螢光綠選取提示與滑桿,以及少量橘色工具點綴。
  • 圖片本身的顏色不會改變。

授權

PicView 採用 GNU General Public License 第 3 版或更新版本(GPL-3.0-or-later)授權。完整條款見 LICENSE。

  • Windows:點擊標題列左上角的應用程式圖示,或按 Alt+Space 開啟系統功能表,再選 關於 PicView。
  • macOS:從螢幕頂端的 PicView → 關於 PicView 應用程式選單開啟。
  • 「關於」顯示目前版本、授權全文與專案/下載連結,也列出 Qt 版本及目前介面樣式,方便確認不同執行環境的外觀差異。

Metadata

Release files for picview 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for picview 0.1.6
File Size Uploaded Provenance Actions
picview-0.1.6.tar.gz 860.5 kB Without provenance Details for picview-0.1.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for picview 0.1.6
File Interpreter ABI Platform Actions
picview-0.1.6-py3-none-any.whl Python 3 none any Details for picview-0.1.6-py3-none-any.whl

Total release size: 1.7 MB

Release files / picview-0.1.6.tar.gz

Download URL picview-0.1.6.tar.gz
Size 860.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a5c48487e01c42664a783af95be1075769e158370032a8fa8d5cd53c9d8cdfd3
BLAKE2b-256 checksum
How to use checksums
3bd2930167e64c5ecbc60cb209395101dd589c2b4abd57c06ca1d47aa792e387
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / picview-0.1.6-py3-none-any.whl

Download URL picview-0.1.6-py3-none-any.whl
Size 856.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b36bba025bb72e18e8766f44541baee93773cbe009393b6e14c490af5aa0262e
BLAKE2b-256 checksum
How to use checksums
336bbcca5f19baf80cf426208437789a037ce10fbbbaf07822a163401562c694
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for picview 0.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.6 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page