parth-paradkar / ccsearch-browser-extension

Cross-Browser extension to search, filter and use images in the public domain and under Creative Commons licenses.

CC Search Browser Extension

Firefox | Chrome | Opera

A Cross-Browser Extension which lets you search and filter content in the public domain and under Creative Commons licenses.

Install

Firefox addon store	Chrome web store	Opera addon store

Features

Feature	Firefox	Chrome	Opera
Search and filter CC Licensed content.	Yes	Yes	Yes
One click attribution.	Yes	Yes	Yes
Download images (and attribution).	Yes	Yes	Yes
Bookmark images.	Yes	Yes	Yes
Export and import bookmarks.	Yes	Yes	Yes
Sync your custom setting and bookmarks across devices.	Yes	Yes	No
Options-UI for custom settings.	Yes	Yes	Yes
Dark Mode.	Yes	Yes	Yes

Installation from source

You can install the extension directly from the source. Follow the following steps:

1. Clone the repo: git clone https://github.com/creativecommons/ccsearch-browser-extension.git.

2. Run: npm install.

3. Run: npm run dev. This would compile SASS to CSS and bundle JS. The compiled version will be in dist folder.

4. Load the extension to the browser:

   • Mozilla Firefox
     • Navigate to about:debugging.
     • Click on "Load Temporary Add-on" button.
     • From the file explorer, choose ccsearch-browser-extension/dist/firefox/manifest.json.
   • Google Chrome
     • Navigate to chrome://extensions.
     • Click on "Load Unpacked" button (make sure you have enabled the Developer mode).
     • From the file explorer, choose ccsearch-browser-extension/dist/chrome.
   • Opera
     • Navigate to about://extensions.
     • Click on "Load Unpacked" button (make sure you have enabled the Developer mode).
     • From the file explorer, choose ccsearch-browser-extension/dist/opera.

Troubleshooting build failures

1. If you get following error:

'TARGET' is not recognized as an internal or external command

then most likely webpack-cli is not installed on your dev machine.

• Here are the few things you can try:
  • Try deleting the folder node_modules and reinstalling webpack-cli

  npm install --save-dev webpack-cli

• if reinstalling node modules do not solve the issue then run following to install webpack-cli globally.

npm install -g webpack-cli

Contribution

Checkout CONTRIBUTING.md for general guidelines for contributing code to CC Open Source.

For contribution guidelines and development instructions specific to this particular project, please checkout INSTRUCTIONS.md.

License

See LICENSE.