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

使用方式

視窗與工具列

  • 視窗最小可縮至 260 × 220 px。
  • 主工具列與資料夾標籤共用一列:左側為資料夾標籤,右側集中放置開啟、版面、比圖、語言與配色工具。
  • 選取標籤直接銜接下方窗格,移除原本兩列之間的留白,將空間留給圖片。
  • 比圖、符合窗格等狀態按鈕以 hover 底色與主題強調色圖示表示啟用,線條粗細不變。
  • 主工具列、縮圖與單圖工具列放不下的工具會收進 更多工具。
  • 放寬視窗後,收起的工具會自動恢復。
  • 縮圖會優先載入可見範圍,其餘在背景逐步製作。
  • 縮圖使用共用的記憶體快取(上限 64 MiB),不另存縮圖檔案。
  • 調整窗格大小只重新排列縮圖,不會重新解碼所有圖片。
  • 滑桿收起時,可從更多工具選單輸入縮放比例或縮圖大小。
  • 視窗標題會顯示目前版本,例如 PicView v0.1.0。

開啟與拖放圖片

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

圖片與窗格工具

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

支援格式

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

資料夾監看與自動更新

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

多資料夾標籤

  • 點擊 開啟資料夾 或標籤列的 +,在新標籤開啟資料夾。
  • 一次拖入多個資料夾,會逐一開啟標籤。
  • 同一資料夾可開啟多個標籤,各自選圖,方便比較不同圖片。
  • 在標籤上按右鍵 → 複製標籤,在原標籤旁建立副本。
  • 副本會保留原標籤的選圖與檢視狀態。
  • 比圖模式中,複製已勾選的標籤,副本也會加入比圖。
  • 拖曳標籤可調整順序。
  • 空間不足時先收合次要工具;標籤過多時可水平捲動,長名稱會省略顯示。
  • 新增、切換或調整視窗大小後,目前標籤會自動保持可見。
  • 點擊標籤的關閉按鈕可關閉;關閉最後一頁後,會保留空白標籤。
  • 各標籤獨立保留選圖、縮放、旋轉、鏡射、捲動、縮圖大小與窗格布局。
  • 語言與配色由所有標籤共用。
  • 重開程式會還原所有標籤、順序與目前標籤。
  • 暫時不存在的資料夾會保留標籤,重新出現後自動恢復。
  • 標籤快捷鍵請見下方「鍵盤快捷鍵」。

比較圖片

  • 點擊工具列的 比圖,啟用比較模式。
  • 標籤的資料夾圖示會變成核取方塊,預設勾選目前標籤。
  • 勾選要比較的標籤,單圖區域會依標籤順序等分。
  • 上下版面 上下版面:比較圖片左右並排。
  • 左右版面 左右版面:比較圖片上下排列。
  • 切換到各標籤,從縮圖選擇該資料夾要比較的圖片。
  • 比較窗格共用上方工具列。
  • 點擊圖片窗格,指定工具列的操作目標;該窗格會顯示重點色外框。
  • 各窗格可獨立縮放、旋轉、鏡射及捲動。
  • 比較中的背景圖片也會即時更新。
  • 再次點擊 比圖,回到一般檢視並保留各標籤的選圖與操作狀態。

縮放與縮圖大小

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

透明圖片的背景色

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

鍵盤快捷鍵

操作 快捷鍵
上一張圖片 Left(左方向鍵)、Page Up 或 Backspace
下一張圖片 Right(右方向鍵)、Page Down 或 Space(空白鍵)
上一列/下一列縮圖 Up(上方向鍵)/Down(下方向鍵)
第一張/最後一張圖片 Home / End
開啟全螢幕 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。
  • 前後切換標籤也支援系統預設快捷鍵。

語言

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

配色

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

Metadata

Release files for picview 0.1.0

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.0
File Size Uploaded Provenance Actions
picview-0.1.0.tar.gz 827.8 kB Without provenance Details for picview-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 1.7 MB

Release files / picview-0.1.0.tar.gz

Download URL picview-0.1.0.tar.gz
Size 827.8 kB
Tags Source
SHA-256 checksum
How to use checksums
44611f1653438766b5dbd4c143589bf6b9fc3b0aeac5baa6f10b6c519d752a89
BLAKE2b-256 checksum
How to use checksums
c37d6dcfadd0e34d745b3f120f0ed544091bb93af3ac654e9d5f42cbaf4cf3a5
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.0-py3-none-any.whl

Download URL picview-0.1.0-py3-none-any.whl
Size 829.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9e1bb2916274d1650021f5d95ed36afa94b27cabcfbf888dec6221da0a574ce1
BLAKE2b-256 checksum
How to use checksums
92736a4f6525d8d1650ccd7a610be45890bbe83cbbc3ded1af624a5b20392d9a
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.0

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.0 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