Installation Guide

📋 System Requirements

Browser Support

• Chrome (Recommended): Version 88+
• Firefox: Version 90+
• Edge: Version 88+
• Safari: Version 14+

Operating Systems

• Windows: 10/11
• macOS: 10.14+
• Linux: Ubuntu 18.04+, CentOS 8+

Network Requirements

• HTTPS protocol support
• Stable internet connection (for webpage screenshots)

📥 Install Browser Extension

Install from Chrome Web Store (Recommended)

1. Open Chrome Browser

   💡 Tip: Ensure using Chrome 88 or higher for best experience.

2. Visit Chrome Web Store

   • Open Chrome Web Store
   • Search for "FullPageScreenshot"

3. Install Extension

   • Click "Add to Chrome" button
   • Click "Add extension" in confirmation dialog

4. Verify Installation

   • FullPageScreenshot icon 📸 should appear in browser top right
   • Click icon to test if extension works properly

Install from Firefox Add-ons Store

1. Open Firefox Browser

   • Ensure using Firefox 90 or higher

2. Visit Firefox Add-ons Store

   • Open Firefox Add-ons
   • Search for "FullPageScreenshot"

3. Install Extension

   • Click "Add to Firefox" button
   • Click "Add" in confirmation dialog

4. Verify Installation

   • FullPageScreenshot icon should appear in browser toolbar
   • Click icon to test extension functionality

Developer Version Installation

If you want to install developer version for testing:

1. Download Source Code

   git clone https://github.com/your-repo/fullpagescreenshot.git
   cd fullpagescreenshot/browser_extension

2. Install Dependencies

   npm install

3. Build Extension

   npm run build

4. Load Extension

   • Open chrome://extensions/
   • Enable "Developer mode"
   • Click "Load unpacked extension"
   • Select build/chrome-mv3-prod/ folder

🔧 Basic Configuration

First-time Setup

1. Launch Extension

   • Click FullPageScreenshot icon in browser toolbar
   • Welcome interface will appear on first use

2. Set Preferences

   • Select default screenshot mode
   • Configure save location (local folder)
   • Set keyboard shortcuts (optional)

Permission Configuration

FullPageScreenshot requires the following permissions:

• Storage permission: Save screenshots and user settings
• Tab permission: Access current webpage for screenshots
• Script permission: Inject necessary JavaScript code
• Download permission: Save screenshots locally

🔍 Verify Installation

Extension Version Verification

1. Check Extension Status

   • Open chrome://extensions/ (Chrome) or about:addons (Firefox)
   • Find FullPageScreenshot
   • Ensure status is "Enabled"

2. Test Basic Functionality

   • Open any webpage
   • Click extension icon
   • Try visible area screenshot

3. Check Permissions

   • Ensure all necessary permissions are granted
   • Test storage functionality

Functionality Testing

1. Test Different Screenshot Modes

   • Visible area screenshot
   • Full page screenshot
   • Element selection
   • Area selection

2. Test Save Functionality

   • Check if screenshots save to correct location
   • Verify filename format
   • Test different file formats

🚨 Common Installation Issues

Extension Cannot Be Installed

Problem: Browser shows "Extension is invalid"

Solution:

1. Ensure downloading the latest version
2. Check file integrity
3. Try reinstalling from official store

Permission Denied

Problem: Extension cannot get necessary permissions

Solution:

1. Manually enable permissions in extension management page
2. Check browser security settings
3. Check if other security software is blocking

Extension Icon Not Showing

Problem: Icon not showing in toolbar after installation

Solution:

1. Check if extension is enabled
2. Click extension icon in browser menu
3. Pin FullPageScreenshot to toolbar

Screenshot Functionality Abnormal

Problem: Screenshot shows blank or error

Solution:

1. Refresh webpage and retry
2. Check if webpage has special security settings
3. Try different screenshot modes
4. Check browser permission settings

🛠️ Troubleshooting

Basic Troubleshooting Steps

1. Restart Browser

   • Completely close browser
   • Restart browser
   • Test extension functionality

2. Clear Cache

   • Clear browser cache and cookies
   • Retest extension functionality

3. Disable Other Extensions

   • Temporarily disable other extensions
   • Test if it's an extension conflict

4. Update Browser

   • Ensure using latest browser version
   • Retest extension functionality

Debug Mode

If problems persist, you can enable debug mode:

1. Open Developer Tools

   • Press Ctrl+Shift+I (Windows) or Cmd+Opt+I (Mac)
   • Switch to Console tab

2. View Error Messages

   • Operate extension functionality
   • View error messages in console

3. Report Issues

   • Record error messages and reproduction steps
   • Report issues through GitHub Issues

📱 Mobile Device Support

Limitations

FullPageScreenshot currently focuses on desktop browsers, mobile device support is limited:

• Android: Chrome mobile supports some features
• iOS: Safari and Chrome support basic functionality
• Tablet devices: Functionality similar to desktop version

Mobile Device Usage Tips

1. Use Desktop Browser

   • Use desktop browser on mobile devices
   • Request desktop site

2. Screenshot Alternatives

   • Use built-in system screenshot functionality
   • Use other mobile screenshot apps

🎉 Installation Complete

Congratulations! You have successfully installed FullPageScreenshot. Now you can start using powerful screenshot features.

Next Steps:

• Read Quick Start Guide
• Try taking your first screenshot
• Explore different screenshot modes

---

Need help? Please check our troubleshooting guide or get support through GitHub Issues