🖼️ PicFlow - Image Slideshow

Turn any webpage images into a beautiful slideshow

Features • Installation • Usage • Shortcuts • Languages

---

✨ Features

• One-Key Start - Press A on any webpage to instantly start a slideshow
• Auto Image Collection - Automatically collects all images from the page, including dynamically loaded ones
• Smart Filtering - Filters out small images (icons, avatars) to show only meaningful content
• Zoom & Pan - Double-click to zoom in, drag to pan around large images
• Blacklist - Remove unwanted images from the slideshow with one key
• Quick Save - Download any image with a single keystroke
• Link Following - Jump to the linked page of the current image
• Customizable - Adjust slideshow interval and play order (sequential/random)
• Multi-language - Supports 10 languages with automatic detection

📦 Installation

From Source (Developer Mode)

1. Clone this repository:

   git clone https://github.com/jsyqrt/PicFlow.git

2. Open Chrome and navigate to chrome://extensions/

3. Enable Developer mode (toggle in the top right corner)

4. Click Load unpacked and select the PicFlow folder

5. The PicFlow icon should now appear in your Chrome toolbar

🚀 Usage

Quick Start

1. Navigate to any webpage with images
2. Press A to start the slideshow
3. Press ESC to exit

Settings

Click the PicFlow icon in your toolbar to:

• Set the slideshow interval (in seconds)
• Choose play order: Sequential or Random
• View and manage blacklisted images

⌨️ Keyboard Shortcuts

Global

Key	Action
A	Start slideshow
ESC	Exit slideshow

Playback Control

Key	Action
←	Previous image
→	Next image
Space	Pause / Play

Image Actions

Key	Action
Enter	Open linked page
S	Save current image
Delete / Backspace	Add to blacklist
Double Click	Zoom in/out

When zoomed in, you can drag to pan around the image.

🌍 Languages

PicFlow automatically detects your browser language and supports:

• 🇺🇸 English
• 🇨🇳 简体中文
• 🇯🇵 日本語
• 🇰🇷 한국어
• 🇷🇺 Русский
• 🇸🇦 العربية
• 🇪🇸 Español
• 🇩🇪 Deutsch
• 🇫🇷 Français
• 🇧🇷 Português

🔧 Technical Details

Permissions

• activeTab - Access the current tab to collect images
• scripting - Inject content scripts for slideshow functionality
• storage - Save user preferences and blacklist
• downloads - Enable image saving feature

Compatibility

• Chrome / Chromium-based browsers
• Manifest V3

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

💡 Acknowledgments

• panzoom - Smooth zoom and pan library