{"id":29816966,"url":"https://github.com/metaory/pickr","last_synced_at":"2026-07-14T19:32:13.896Z","repository":{"id":306737029,"uuid":"1026893516","full_name":"metaory/pickr","owner":"metaory","description":"🚧 A modern Chrome extension for interactive element selection and DOM inspection with overlay-based interface and comprehensive action hints","archived":false,"fork":false,"pushed_at":"2025-07-27T13:11:55.000Z","size":521,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-20T06:37:31.024Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/metaory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-26T21:00:27.000Z","updated_at":"2025-10-03T22:37:52.000Z","dependencies_parsed_at":"2025-07-27T10:26:51.548Z","dependency_job_id":"6d38c9da-4f75-4aab-a3a0-068d5886b888","html_url":"https://github.com/metaory/pickr","commit_stats":null,"previous_names":["metaory/pickr"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/metaory/pickr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaory%2Fpickr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaory%2Fpickr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaory%2Fpickr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaory%2Fpickr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/metaory","download_url":"https://codeload.github.com/metaory/pickr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metaory%2Fpickr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35476729,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-14T02:00:06.603Z","response_time":114,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-28T20:11:01.255Z","updated_at":"2026-07-14T19:32:13.876Z","avatar_url":"https://github.com/metaory.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e\n    \u003cimg valign=\"middle\" src=\"res/xpick-256.png\" alt=\"pickr\" height=\"96\" /\u003e\n    ꛠickr\n  \u003c/h1\u003e\n  \u003ch2\u003ePick elements like a pro\u003c/h2\u003e\n  \u003cstrong\u003eA modern Chrome extension for interactive element selection and DOM inspection\u003c/strong\u003e\n  \u003cbr\u003e\n  \u003cstrong\u003ewith overlay-based interface and comprehensive action hints\u003c/strong\u003e\n\u003c/div\u003e\n\n---\n\n`pickr` is a powerful Chrome extension that transforms how you interact with web page elements.\nBuilt with modern functional programming principles,\nit provides intuitive visual element selection through multiple modes - from hover-based mouse selection to precise CSS selector input. \nWith overlay-based interface, comprehensive legend hints, and real-time sidebar previews, pickr makes DOM inspection and element selection effortless and precise.\n\n## Features\n\n### 🎯 **Selection Modes**\n\n#### 1. **Live Interactive Mouse Selector** (`Alt+M`)\n- **Trigger**: Press `Alt+M` to activate\n- **Behavior**: \n  - Opens overlay interface with legend hints\n  - Highlights elements under mouse cursor with enhanced visual feedback\n  - Real-time element detection and highlighting\n  - Comprehensive sidebar with element statistics and previews\n- **Interface**:\n  - Legend overlay showing all available actions and shortcuts\n  - Enhanced sidebar with detailed element information\n  - Visual element highlighting with improved styling\n\n#### 2. **Live Interactive Input Selector** (`Alt+I`)\n- **Trigger**: Press `Alt+I` to activate\n- **Behavior**:\n  - Opens overlay interface with legend hints\n  - Displays enhanced input overlay for CSS selector input\n  - Real-time CSS selector validation with debounced querySelectorAll\n  - Highlights matching elements with improved visual feedback\n- **Interface**:\n  - Legend overlay showing all available actions and shortcuts\n  - Enhanced input overlay with better styling and examples\n  - Comprehensive sidebar with detailed results and samples\n\n### 🎨 **Overlay Interface**\n- **Legend Overlay**: Comprehensive action hints with categorized shortcuts\n- **Enhanced Sidebar**: Detailed element previews with improved styling\n- **Input Overlay**: Modern CSS selector input with examples and validation\n- **Visual Feedback**: Improved highlighting with better contrast and effects\n- **Settings Popup**: Extension configuration with toggle controls\n\n### 🔧 **Element Actions**\n- **Modular Plugin System**: Extensible action framework with clear contracts\n- **Directory-based Architecture**: Each action in its own file for easy maintenance\n- **Keyboard Shortcuts**: Quick access to element operations\n- **Copy Operations**: Text, HTML, CSS selectors, attributes, and URLs\n- **Inspect Operations**: Element details and properties\n- **Modify Operations**: Visual highlighting and element manipulation\n- **Real-time Feedback**: Instant visual and textual feedback\n- **Action Categories**: Organized by functionality (copy, inspect, modify, navigate)\n- **Legend Integration**: All actions displayed in overlay with key bindings\n\n### 📊 **Enhanced Sidebar Features**\n- **Element Statistics**: Comprehensive element properties and attributes\n- **Live Previews**: Enhanced content previews with better formatting\n- **Selector Validation**: Real-time CSS selector testing with error handling\n- **Element Hierarchy**: Parent-child relationships and DOM structure\n- **Action Results**: Detailed operation feedback with formatted output\n- **Visual Design**: Modern styling with improved readability and organization\n\n### ⚙️ **Settings \u0026 Configuration**\n- **Settings Popup**: Extension configuration interface\n- **Toggle Controls**: Enable/disable features like auto-sidebar, help overlay, highlighting\n- **Keyboard Shortcuts**: Display of available shortcuts\n- **Action Settings**: Configure copy behavior and notifications\n- **Persistent Storage**: Settings saved across browser sessions\n\n## Installation\n\n1. Clone this repository\n2. Open Chrome and navigate to `chrome://extensions/`\n3. Enable \"Developer mode\"\n4. Click \"Load unpacked\" and select the extension directory\n5. The extension icon will appear in your toolbar\n\n## Usage\n\n### Keyboard Shortcuts\n- `Alt+M`: Activate mouse selector mode\n- `Alt+I`: Activate input selector mode\n\n### Element Action Shortcuts\n- `y`: Copy element text content\n- `h`: Copy element HTML\n- `s`: Copy CSS selector for element\n- `a`: Copy element attributes as JSON\n- `u`: Copy element URL (href/src)\n- `i`: Inspect element details\n- `l`: Highlight element permanently\n\n### Interface Controls\n- **Compact Help**: Always visible in top-left corner with essential shortcuts\n- **Full Help**: Press `?` to open comprehensive help overlay\n- **Sidebar Toggle**: Press `S` to toggle sidebar\n- **Legend Toggle**: Press `H` to show/hide the compact help\n- **Input Toggle**: Press `I` to show/hide input overlay (Input Mode only)\n- **Pause/Resume**: Press `P` to pause/resume selection\n- **Exit Mode**: Press `ESC` to exit current mode\n\n### Toast Notifications\n- **Action Feedback**: Toast notifications appear for all actions\n- **Interface Feedback**: Toasts confirm interface state changes\n- **Auto-dismiss**: Toasts automatically disappear after 3 seconds\n- **Color-coded**: Success (green), Error (red), Warning (yellow), Info (blue)\n\n### Keyboard Shortcuts\n- `Alt+M`: Activate mouse selector mode\n- `Alt+I`: Activate input selector mode\n\n### Element Action Shortcuts\n- `y`: Copy element text content\n- `h`: Copy element HTML\n- `s`: Copy CSS selector for element\n- `a`: Copy element attributes as JSON\n- `u`: Copy element URL (href/src)\n- `i`: Inspect element details\n- `l`: Highlight element permanently\n\n### Interface Shortcuts\n- `S`: Toggle sidebar visibility\n- `H`: Toggle compact help visibility\n- `?`: Toggle full help overlay\n- `I`: Toggle input overlay (Input Mode only)\n- `P`: Pause/resume selection mode\n- `ESC`: Exit current mode\n\n### Selection Workflow\n1. **Choose Mode**: Use appropriate keyboard shortcut (`Alt+M` or `Alt+I`)\n2. **View Legend**: Check the overlay for available actions and shortcuts\n3. **Select Elements**: \n   - Mouse mode: Hover over elements to highlight\n   - Input mode: Type CSS selectors in the overlay\n4. **View Results**: Check sidebar for comprehensive statistics and samples\n5. **Extract Data**: Use action shortcuts to copy or inspect selected content\n6. **Configure**: Click extension icon to access settings\n\n## Technical Architecture\n\n### Core Components\n- **Service Worker** (`sw.js`): Functional command handling and script injection\n- **Element Selector** (`element-selector.js`): Overlay-based interface with enhanced UI\n- **Action System** (`actions/`): Modular plugin system with individual action files\n- **Settings Popup** (`popup.html/js`): Configuration interface with toggle controls\n- **Enhanced Sidebar**: Comprehensive preview and action results display\n- **Legend Overlay**: Dynamic action hints and keyboard shortcuts\n\n### Modern Patterns\n- **Functional Programming**: Pure functions, composition, and immutability\n- **Proxy-based State**: Reactive state management with listeners\n- **Overlay Architecture**: Non-intrusive UI elements with backdrop blur\n- **Modular Actions**: Plugin-based action system with clear contracts\n- **Settings Persistence**: Chrome storage integration for configuration \n\n### License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetaory%2Fpickr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetaory%2Fpickr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetaory%2Fpickr/lists"}