FShot

FShot 是以 Python 實作的桌面截圖工具，主打全域快捷鍵、系統匣常駐、多頁籤編輯與快速複製/存檔。目前支援 Windows 與 macOS；平台權限與驗收方式請閱讀 Cross-Platform Notes。

Current Status

Windows: 主要功能已實作並經手動測試調整。
macOS: 已實作 Quartz 全域快捷鍵、螢幕擷取、焦點視窗、視窗/控制項選取與游標擷取。
Linux: 僅保留基本架構與部分通用能力，尚未作為主要目標平台。

Quick Start

FShot 可從 PyPI 安裝。不需安裝即可使用 uvx 執行最新正式版本：

uvx fshot

第一次執行會從 PyPI 下載套件並建立 uv 快取環境，後續會重用快取。臨時試用建議使用 uvx，若要長期使用則安裝為 uv tool。

使用 uv 從 PyPI 安裝：

uv tool install fshot
fshot

安裝後可直接執行 fshot；更新至 PyPI 最新版本：

uv tool upgrade fshot

使用 uv tool install 安裝時，FShot 啟動後會在背景每日檢查一次 PyPI。系統匣選單可手動「檢查更新…」或停用自動檢查；發現新版時可選擇更新並重新啟動、稍後處理或略過該版本。更新前若有尚未儲存的截圖，FShot 會先要求確認。uvx、原始碼開發環境與其他非 uv tool 安裝方式只會提供手動更新指引，不會自行修改環境。

若要直接從 GitHub 測試 main 的最新開發成果：

uv tool install --force "fshot @ git+https://github.com/codemee/fshot.git@main"

從原始碼啟動開發環境：

uv sync
uv run fshot

程式啟動後會隱藏主視窗並留在系統匣。雙擊系統匣圖示可顯示編輯視窗，右鍵選單可退出。工具列的主題按鈕可單擊循環切換「跟隨系統 → 淺色 → 深色」；預設跟隨作業系統配色，選擇會保留至下次啟動。太陽代表淺色、月亮代表深色，分隔排列的太陽與月亮代表跟隨系統。語言按鈕可單擊循環切換「跟隨系統 → 繁體中文 → English」，並保留使用者選擇；圖示分別為 文/A、中 與 En。工具列按鈕的提示文字會依目前語言顯示，具備快捷鍵的動作也會在提示中列出對應按鍵。工具列的鍵盤圖示可設定四種截圖方式及「重複前一次擷取」的全域快捷鍵。每組可選 Ctrl、Shift、Alt 與 A–Z 字母；Shift 必須搭配 Ctrl 或 Alt。「使用預設」會將面板中的五組欄位恢復為預設值；按 OK 且系統註冊成功後才會套用並保留設定，Cancel 不會變更目前快捷鍵。

圖片也可透過拖放或剪貼簿加入編輯器：拖放圖片會以完整檔名建立頁籤、保留來源路徑並在修改後寫回原檔；直接貼上影像或從檔案管理器複製圖片後貼上，會以截圖時間格式建立新的未存檔頁籤。成功存檔後會記住檔案所在資料夾，其他尚未存檔的頁籤會從該資料夾開啟儲存交談窗。Windows/Linux 使用 Ctrl+V，macOS 使用 Command+V。

Windows Shortcuts

Ctrl+Shift+Q: 重複前一次的截圖方式（矩形區域與選取的視窗／控制項會沿用前次目標，可在設定面板自訂）
Ctrl+Shift+A: 擷取目前焦點視窗
Ctrl+Shift+R: 擷取矩形區域
Ctrl+Shift+F: 擷取全螢幕
Ctrl+Shift+W: 選取視窗或控制項後擷取

macOS 使用相同的 Ctrl+Shift 字母組合。首次執行時，請依系統提示授予「螢幕錄製」與「輔助使用」權限。目前 FShot 是透過 uv／uvx 執行，而非封裝成獨立的 macOS App，因此系統設定中的授權對象通常是啟動指令所在的 App，例如「終端機」、iTerm2 或 IDE。授權後請完全結束並重新開啟該 App，再重新執行 FShot。

編輯工具快捷鍵：

Alt+P: 自由畫筆
Alt+L: 線條
Alt+A: 箭頭
Alt+R: 矩形
Alt+T: 文字
Alt+M: 馬賽克
Alt+C: 線條粗細與顏色
Ctrl++ / Ctrl+=: 放大
Ctrl+-: 縮小
Ctrl+0: 重設縮放
F2: 直接在目前標籤頁重新命名已存檔的檔案（macOS 使用 Return）

已存檔的標籤頁也可直接雙擊名稱進入重新命名；副檔名會保留不變。

Project Docs

PRD: 原始產品需求。
Architecture: 專案結構、主要模組與資料流。
Cross-Platform Notes: Windows/macOS/Linux 差異與 macOS 後續實作重點。

Development

uv sync
uv run pytest -q
uv run python -m compileall src tests

若 FShot 正在執行，compileall 有時會因 __pycache__ 或 executable 被鎖而失敗；先關閉或停止 fshot.exe 後再重跑。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fshot-0.0.11.tar.gz (46.4 kB view details)

Uploaded Aug 16, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fshot-0.0.11-py3-none-any.whl (51.3 kB view details)

Uploaded Aug 16, 2026 Python 3

File details

Details for the file fshot-0.0.11.tar.gz.

File metadata

Download URL: fshot-0.0.11.tar.gz
Upload date: Aug 16, 2026
Size: 46.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fshot-0.0.11.tar.gz
Algorithm	Hash digest
SHA256	`763e7873941398602bd64b36e4d0d89741668f4f71046745efd3e2991578cd3e`
MD5	`0dff6dc6a6cfe631683ffa892adce4be`
BLAKE2b-256	`fb43e5dd1a78c9887aab6e6330b6b63d323adfcf8a8d6f27044ec677552688d5`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fshot-0.0.11.tar.gz:

Publisher: publish-pypi.yml on codemee/fshot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fshot-0.0.11.tar.gz
- Subject digest: 763e7873941398602bd64b36e4d0d89741668f4f71046745efd3e2991578cd3e
- Sigstore transparency entry: 2486854921
- Sigstore integration time: Aug 16, 2026
Source repository:
- Permalink: codemee/fshot@fe7da0fda4a29774cd291e175bcf42fcf3e949be
- Branch / Tag: refs/heads/main
- Owner: https://github.com/codemee
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yml@fe7da0fda4a29774cd291e175bcf42fcf3e949be
- Trigger Event: workflow_dispatch