8000 GitHub - agamenmon/textcatcher: TextCatcher is a lightweight, user-friendly Chrome extension that helps you collect and organize text snippets from anywhere on the web.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

TextCatcher is a lightweight, user-friendly Chrome extension that helps you collect and organize text snippets from anywhere on the web.

License

Notifications You must be signed in to change notification settings

agamenmon/textcatcher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TextCatcher Chrome Extension

A powerful Chrome extension that allows you to save selected text from any webpage with customizable keyboard shortcuts.

Features

  • Quick Text Capture: Select any text on a webpage and save it with a customizable keyboard shortcut (default: Ctrl+Shift+C or Command+Shift+C on Mac).
  • Organized Storage: Saved text snippets are organized chronologically with timestamps and source URLs.
  • Easy Access: View all your saved snippets through the popup interface.
  • Search Functionality: Quickly find specific text entries with the built-in search feature.
  • Categories: Organize your text snippets with customizable categories (Work, Personal, Important, Reference).
  • Category Filters: Filter your entries by category to quickly find what you need.
  • Dark Mode Support: Choose between light and dark themes based on your preference.
  • Export/Import: Export your collection of text snippets as JSON files and import them later or on another device.
  • Customizable Settings: Configure storage limits and keyboard shortcuts to tailor the extension to your needs.
  • Cross-platform Compatibility: Works on Windows, Mac, and Linux versions of Chrome.

Installation

From Chrome Web Store (Recommended)

  1. Navigate to the TextCatcher Chrome Web Store page (search for "TextCatcher").
  2. Click "Add to Chrome" and confirm the installation.
  3. The TextCatcher icon will appear in your Chrome toolbar.

Manual Installation (Developer Mode)

  1. Download or clone this repository to your local machine.
  2. Open Chrome and navigate to chrome://extensions/.
  3. Enable "Developer mode" by toggling the switch in the top-right corner.
  4. Click on "Load unpacked" and select the directory containing the TextCatcher files.
  5. The TextCatcher icon will appear in your Chrome toolbar.

Usage

Capturing Text

  1. Select any text on a webpage.
  2. Press the keyboard shortcut (default: Ctrl+Shift+C or Command+Shift+C on Mac).
  3. The selected text will be saved to TextCatcher's storage.
  4. A badge counter on the TextCatcher icon will show the number of saved entries.

Viewing Saved Text

  1. Click on the TextCatcher icon in your Chrome toolbar.
  2. A popup will open showing all your saved text entries.
  3. Entries are displayed in reverse chronological order (newest first).
  4. Each entry shows the text, capture date/time, and source URL.

Managing Entries

From the popup, you can:

  • Search for specific text using the search bar at the top.
  • Filter entries by category using the filter buttons.
  • Categorize entries by selecting a category from the dropdown for each entry.
  • Copy an entry back to your clipboard by clicking the "Copy" button.
  • Delete an individual entry by clicking the "Delete" button.
  • Clear All entries by clicking the "Clear All" button at the top.
  • Export all entries to a JSON file by clicking "Export".

Customizing Settings

  1. Click on the TextCatcher icon in your Chrome toolbar.
  2. Click the "Settings" button.
  3. In the settings page, you can:
    • Change the keyboard shortcut for capturing text.
    • Toggle dark mode on/off to match your preference.
    • Adjust the maximum number of entries to store (10-500).
    • Import or export your data.
    • Clear all saved data.

Privacy Policy

TextCatcher respects your privacy:

  • Local Storage Only: All data is stored locally in your browser using Chrome's storage API.
  • No Data Collection: We do not collect, transmit, or share any of your personal data or saved text entries.
  • No External Servers: No data is sent to external servers or third parties.
  • Minimal Permissions: The extension only requests permissions necessary for its core functionality.

Data Usage

  • Text selections you save are stored only in your browser's local storage.
  • Source URLs are saved with your text selections to help you identify where the text came from.
  • You can export your data at any time in JSON format, which is under your complete control.
  • You can delete individual entries or all data at any time through the extension interface.

Permissions Explanation

  • storage: To save your text entries locally in your browser's storage.
  • contextMenus: To provide right-click functionality for text selection.
  • tabs: To access tab information for capturing the source URL of selected text.
  • clipboardWrite: To copy text to your clipboard when using the Copy feature.
  • commands: To support keyboard shortcuts for quick text capture.
  • activeTab and scripting: To access the selected text on the current webpage.

Troubleshooting

  • Keyboard shortcut not working: Make sure no other extension or application is using the same shortcut. You can change the shortcut in the extension settings.
  • No text being captured: Ensure TextCatcher has permission to access the webpage content. Some websites may restrict content selection.
  • Extension icon not showing badge count: Restart Chrome and try again. If the issue persists, check if you have other extensions that might interfere.
  • Text formatting is lost: TextCatcher currently saves plain text only, so formatting (bold, italic, etc.) is not preserved.

Support and Feedback

If you have questions, suggestions, or issues with TextCatcher, please:

License

MIT License - Feel free to use, modify, and distribute this extension according to the terms of the license.

Development

TextCatcher is built using vanilla JavaScript with Chrome's Extension API. The codebase is organized as follows:

  • manifest.json: Extension configuration and permissions.
  • background.js: Background service worker handling main functionality.
  • content.js: Content script injected into webpages to access selected text.
  • popup/: Contains the popup UI files (HTML, CSS, JS).
  • options/: Contains the settings page files (HTML, CSS, JS).
  • icons/: Contains extension icons in various sizes.

To contribute to TextCatcher:

  1. Fork the repository.
  2. Make your changes.
  3. Test thoroughly using Chrome's developer mode.
  4. Submit a pull request with a clear description of your changes.

About

TextCatcher is a lightweight, user-friendly Chrome extension that helps you collect and organize text snippets from anywhere on the web.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
0