Fastshot

Fastshot is a GenAI powered screenshot and annotation tool designed to optimize your workflow. Ideal for students, developers, researchers, and operations professionals, Fastshot enhances multitasking by providing seamless, efficient tools to capture, pin, annotate, and analyze screen content.

With its "pin on top" feature, Fastshot allows users to keep screenshots easily accessible while enabling smooth zooming, moving, annotation, and copying for multi-system comparisons. The built-in OCR tool enables quick extraction of text from any part of the screen, further streamlining your workflow.

Additionally, Fastshot's GenAI-powered assistant offers advanced analysis and summarization of screen content, allowing users to extract information and ask questions with ease, significantly boosting productivity.

The tool also includes a Screen Pen feature, window pinning capabilities, and customizable window opacity adjustments—perfect for managing complex workflows across multiple windows and tasks.

Features
Configuration
Cloud Sync Performance Optimization
Installation
Usage
Shortcuts
Who Can Benefit
Development
Plugin Mechanism
Contributing
License

Features

Screenshot and Annotation

Always on Top: Keep screenshots above all other windows for easy comparison.
Smooth Zoom and Drag: Effortlessly zoom and drag screenshots to focus on details.
Annotation Tools: Hand-drawing and text mode for quick annotations.
Clipboard Export: Easily export screenshots to the clipboard for sharing.
OCR Integration: Extract text from images using the built-in OCR plugin powered by PaddleOCR running locally.
AI Assistant: Ask questions about the screenshot using the integrated GenAI assistant.

Context Menu Options

❌ Close: Close the current window.
💾 Save As...: Save the current screenshot.
🖌️ Paint: Activate paint mode for freehand drawing.
↩️ Undo: Undo the last action.
🚪 Exit Edit: Exit paint or text mode.
📋 Copy: Copy the current screenshot to the clipboard.
🔤 Text: Activate text mode to add text annotations.
🔍 OCR: Perform OCR on the current screenshot and copy the result to the clipboard.

System Window Control

📌 Always on Top: Toggle the window's always-on-top state.
🔍 Window Transparency Adjustment: Adjust transparency of any system window via hotkeys for better multitasking.

Screen Annotation

🖊️ Screen Pen: Activate the screen pen to annotate anywhere on your screen.

GenAI Assistant

Multimodal AI Assistant: Seamlessly integrated AI assistant that can read any content on your screen and answer your questions.

Content Extraction

PowerExtract: AI-powered content extraction from images
LLM Settings: Configurable LLM integration

Quick Cloud Hyder - Advanced File Sync

🔐 Quick Cloud Hyder: Instantly encrypt files/folders and upload to cloud storage
- Press Ctrl+Alt alternately 8 times to activate
- Reads file paths from clipboard
- Encrypts and disguises files as PNG images
- Uploads to secure cloud storage with tracking
📥 Quick Cloud Retriver: Download and decrypt the last hidden file
- Press Ctrl+Win alternately 8 times to activate
- Automatically retrieves last uploaded file
- Decrypts and extracts original content
- Opens output folder and copies path to clipboard
🔒 Security Features: AES-256 encryption, file disguising, secure cleanup
☁️ Cloud Integration: Seamless AWS S3 integration with existing cloud sync
📱 User Experience: Progress feedback, error handling, multi-format support

Session Management & Optimized Cloud Sync

Session Save/Load: Save and restore all floating image windows with metadata
Enhanced Metadata: Add descriptions, tags, colors, and classifications to sessions
High-Performance Cloud Storage: Optimized AWS S3 integration with intelligent caching
- ⚡ Lightning Fast: UI loads in <2 seconds vs previous 3-5 minutes (99%+ faster)
- 🧠 Smart Caching: Lightweight metadata indexes for instant session browsing
- 🔄 Background Sync: Non-blocking operations with real-time progress feedback
- 💾 Memory Efficient: <80MB baseline usage with minimal growth for large datasets
- 🔒 Secure: End-to-end encryption with data disguised in image files
- 🔧 Backward Compatible: 100% compatibility with existing sessions
Advanced File Manager: Comprehensive session manager with filtering, sorting, and pagination
Cross-Platform Sync: Seamlessly synchronize sessions between different devices
Cache Management: Smart synchronization with integrity validation and automatic recovery

Configuration

LLM Settings

Configure your LLM settings in the PowerGenAI section:

[PowerGenAI]
_base_url= "https://api.example.com/v1"
key= "your-api-key"
_model= "model-name"

Cloud Sync Settings

Configure AWS S3 cloud synchronization in the CloudSync section:

[CloudSync]
cloud_sync_enabled = true
aws_access_key = your-aws-access-key
aws_secret_key = your-aws-secret-key
aws_region = us-east-1
s3_bucket_name = your-bucket-name
encryption_key = your-encryption-key
proxy_enabled = false
proxy_url = http://username:password@proxy.com:8080

Note: All session data is encrypted before upload to S3 using the encryption key you provide. The data is also disguised within image files for additional security.

Proxy and SSL Configuration

For environments using proxy servers, additional SSL configuration may be needed:

[CloudSync]
proxy_enabled = true
proxy_url = http://username:password@proxy.company.com:8080
ssl_verify = false  # Disable SSL verification if proxy causes certificate issues

⚠️ Security Warning: Disabling SSL verification reduces security. Only use this setting in proxy environments where certificate validation fails. See PROXY_SSL_GUIDE.md for detailed troubleshooting.

Cloud Sync Performance Optimization

Fastshot's cloud sync system has been completely optimized for high performance and efficiency:

🚀 Performance Achievements

| Metric | Before Optimization | After Optimization | Improvement | |--------|-------------------|-------------------|-------------| | UI Loading Time | 3-5 minutes | <2 seconds | 99%+ faster | | Memory Usage | Unknown | 52MB baseline | Optimized | | Network Bandwidth | ~200MB initial | <10MB initial | 95% reduction | | User Experience | Blocking operations | Non-blocking | Transformed |

🏗️ Technical Architecture

Two-Tier Metadata System: Lightweight metadata indexes separate from full session files
Smart Local Caching: File-based cache with SHA256 integrity validation
Intelligent Synchronization: Filename-based comparison leveraging immutable session nature
Asynchronous Operations: Non-blocking background operations with progress tracking
Comprehensive Error Recovery: Automatic detection and repair of cache corruption

📁 Cache Structure

~/.fastshot/
├── sessions/                    # Full session files cache
├── meta_cache/
│   ├── meta_indexes/           # Individual lightweight metadata files
│   ├── overall_meta.json       # Master metadata file
│   └── cache_info.json         # Cache state and validation info
└── cache_lock                  # Cross-process synchronization


Full session files cache
C:\Users\~\fastshot_sessions

✅ Quality Assurance

100% Test Coverage: 24/24 tests passed across integration, performance, and compatibility
Backward Compatibility: 100% compatibility with existing sessions
Memory Leak Free: Stable memory usage over extended operations
Production Ready: Comprehensive error handling and recovery mechanisms

Installation

You can install Fastshot from PyPI:

pip install fastshot

Usage

Once installed, you can start Fastshot from the command line:

fastshot

LLM Env Variable (2 way)

OpenAI Standard:

setx OPENAI_TOKEN "sk-kK"
setx OPENAI_MM_URL "https://xxx"
setx OPENAI_CHATGPT_URL "https://xxx"
setx HEAD_TOKEN_KEY "Authorization"

Standalone Token Exchange:

setx OPENAI_TOKEN_URL ""
setx OPENAI_USER_NAME ""
setx OPENAI_PASSWORD ""
setx OPENAI_APPLICATION_ID ""
setx OPENAI_APPLICATION_NAME ""
setx OPENAI_MM_URL "https://xxx"
setx OPENAI_CHATGPT_URL "https://xxx"
setx HEAD_TOKEN_KEY "Authorization"

setx OPENAI_HEALTH_URL ""

Shortcuts

Customize your experience with configurable shortcuts. Most operations require only a single hotkey, minimizing the need for repetitive touch points.

Shortcuts

[Shortcuts]
hotkey_snip = <shift>+a+s
hotkey_paint = <ctrl>+p
hotkey_text = <ctrl>+t

hotkey_screenpen_toggle = <ctrl>+<cmd>+<alt>
hotkey_undo = <ctrl>+z
hotkey_redo = <ctrl>+y
hotkey_screenpen_exit = <esc>
hotkey_screenpen_clear_hide = <ctrl>+<esc>

hotkey_topmost_on = <esc>+`
hotkey_topmost_off = <cmd>+<shift>+\

hotkey_opacity_down = <left>+<right>+<down>
hotkey_opacity_up = <left>+<right>+<up>

hotkey_ask_dialog_key = <ctrl>
hotkey_ask_dialog_count = 4
hotkey_ask_dialog_time_window = 1.0

hotkey_toggle_visibility = <shift>+<f1>     # Toggle visibility of all image windows
hotkey_load_image = <shift>+<f2>            # Load image from file
hotkey_reposition_windows = <shift>+<f3>    # Reposition all image windows to origin
hotkey_save_session = <shift>+<f4>          # Save current session to file
hotkey_load_session = <shift>+<f5>          # Load session from file
hotkey_se

Fastshot

Install / Use

README

Fastshot

Table of Contents

Features

Screenshot and Annotation

Context Menu Options

System Window Control

Screen Annotation

GenAI Assistant

Content Extraction

Quick Cloud Hyder - Advanced File Sync

Session Management & Optimized Cloud Sync

Configuration

LLM Settings

Cloud Sync Settings

Proxy and SSL Configuration

Cloud Sync Performance Optimization

🚀 Performance Achievements

🏗️ Technical Architecture

📁 Cache Structure

✅ Quality Assurance

Installation

Usage

LLM Env Variable (2 way)

OpenAI Standard:

Standalone Token Exchange:

Shortcuts