PicView
專注於快速載圖與多圖比較的圖片資料夾檢視器,使用 Qt 打造。
主要特色
快速載圖
- 優先載入目前圖片與可見範圍的縮圖,其餘縮圖在背景逐步補上,縮短開啟資料夾的等待時間。
- 縮圖保留於記憶體,切換標籤與調整版面時可重用,不必反覆解碼,也不另存縮圖檔案。
多圖比較
- 將標籤或縮圖拖到單圖窗格即可開始比圖,支援不同資料夾,也能在同一資料夾比較不同圖片。
- 每個比圖窗格可各自選圖、縮放、旋轉、鏡射與捲動,方便檢查細節與差異。
安裝與啟動
桌面版下載
- 已附加桌面版的版本可從 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.7。
開啟與拖放圖片
- 點擊
,選擇要檢視的資料夾。 - 將資料夾或圖片檔案拖曳至視窗,也能開啟檢視。
- 按住縮圖或檔名拖曳,可將原始圖檔拖放至接受檔案的其他應用程式。
- 旋轉與鏡射只影響檢視畫面,不會修改圖檔。
檔案總管與 Finder 右鍵選單
- 點擊主工具列語系工具左側的
,直接開啟或關閉 Windows 檔案總管右鍵選單或 macOS Finder「服務」;預設關閉。啟用時按鈕會顯示強調色。 - Windows:在資料夾、資料夾空白處或支援的圖片檔上按右鍵,選擇「使用 PicView 開啟」。Windows 11 可能需要先選「顯示其他選項」。此設定只修改目前使用者的右鍵選單,不會變更預設開圖程式。
macOS 提供兩種不同的開啟方式,皆需使用放在 Applications 的封裝版 PicView.app:
| 方式 | Finder 右鍵選單位置 | 適用對象 | 如何啟用 |
|---|---|---|---|
| 打開檔案的應用程式 | 「打開檔案的應用程式 → PicView」 | 支援的圖檔:JPEG、PNG、WebP、BMP、GIF、TIFF、SVG | 安裝並開啟 App 一次,由 macOS 註冊;不需開啟工具列整合按鈕 |
| Finder 服務 | 「服務 → 使用 PicView 開啟」 | 資料夾與支援的圖檔 | 在 App 內開啟工具列的 Finder 整合按鈕,安裝目前使用者的服務 |
- 關閉 Finder 整合按鈕只會移除「服務」項目;PicView 仍會出現在圖檔的「打開檔案的應用程式」清單。
- 註冊以上項目不會將 PicView 設為預設開圖程式。圖檔也可拖到 PicView 的 Dock 圖示開啟。
- 從 Python/uv 啟動無法註冊 App 的「打開檔案的應用程式」項目,也無法安裝內附的 Finder 服務。
- 從圖片啟動時,PicView 會開啟該圖片所在資料夾並選取該圖片;從資料夾啟動時會直接檢視資料夾。也可用
picview "<資料夾或圖片路徑>"從命令列開啟。 - 若已有 PicView 視窗,從右鍵選單或命令列開啟路徑會交給該視窗,在新標籤檢視;沒有執行中的視窗時才啟動新視窗。
圖片與窗格工具
| 按鈕 | 操作 |
|---|---|
| 旋轉目前圖片 | |
| 水平鏡射目前圖片 | |
| 垂直鏡射目前圖片 | |
| 切換符合窗格與原始大小 | |
| 最大化縮圖或單圖窗格 | |
| 還原窗格布局 | |
| 開啟目前圖片的全螢幕檢視 |
縮圖排序、日期與檔案操作
- 縮圖工具列的排序方式按鈕,在
檔名(自然排序) 與 修改時間 間切換。 - 旁邊的排序方向按鈕,在
順向 與 逆向 間切換;修改時間順向為舊到新,逆向為新到舊。排序不會切換目前圖片或重設檢視狀態。 - 主工具列語言按鈕前的
切換 顯示修改日期時間,立即套用到所有標籤,並保留至下次開啟程式;新開與複製標籤也沿用此全域設定。 - 縮圖卡片底部預設顯示本機時間的修改日期時間;卡片太窄時,將滑鼠停在日期上可查看完整時間。
- 各標籤獨立保存排序方式與方向,複製標籤及重開程式時也會保留。新增或修改檔案後,排序與日期會自動更新。
- 在縮圖卡片按滑鼠右鍵,選 複製 可將原始圖檔複製到剪貼簿,再貼至其他應用程式或資料夾。
- 右鍵選單的 內容 在 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.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| picview-0.1.7.tar.gz | 926.0 kB | Without provenance | Details for picview-0.1.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| picview-0.1.7-py3-none-any.whl | Python 3 | none | any | Details for picview-0.1.7-py3-none-any.whl |
Total release size: 1.8 MB
Release files / picview-0.1.7.tar.gz
| Download URL | picview-0.1.7.tar.gz |
|---|---|
| Size | 926.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8834ce1f5d8796737dfd80e177559f539d28e9b5afe8d1a010e1fe3b52ea6c4f
|
|
BLAKE2b-256 checksum How to use checksums |
e9a00aa4d6fa6ebbb7e7e774b97345aca3d20c84c5ebeb6d2100f6f6cfbc183b
|
| 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.7-py3-none-any.whl
| Download URL | picview-0.1.7-py3-none-any.whl |
|---|---|
| Size | 922.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aba904a099d6cd12c1afb768663e28b55158962e34fb57f32dfa52be3c4c61f4
|
|
BLAKE2b-256 checksum How to use checksums |
f3a473b0e5c568aabdf7a108399667ce9952d042681dcc9891bd6e7804341e29
|
| 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.7
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.