https://github.com/mkovatsc/Copper

Copper (Cu) CoAP user-agent (JavaScript implementation)
https://github.com/mkovatsc/Copper

Last synced: about 2 months ago
JSON representation

Copper (Cu) CoAP user-agent (JavaScript implementation)

• Host: GitHub
• URL: https://github.com/mkovatsc/Copper
• Owner: mkovatsc
• License: bsd-3-clause
• Created: 2011-03-11T13:32:45.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2018-10-18T17:43:50.000Z (about 6 years ago)
• Last Synced: 2024-08-03T22:14:16.819Z (5 months ago)
• Language: JavaScript
• Homepage: http://people.inf.ethz.ch/mkovatsc/copper.php
• Size: 965 KB
• Stars: 94
• Watchers: 16
• Forks: 43
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-CoAP - Copper - Copper (Cu) CoAP user-agent (JavaScript implementation). (Tools / Browser Plugin)

README

        
Copper (Cu) CoAP user-agent

===========================

Implements [RFC7252](http://tools.ietf.org/html/rfc7252)

Also see [Copper (Cu4Cr)](https://github.com/mkovatsc/Copper4Cr)

## Not supported by Firefox 56+ / WebExtensions API

Mozilla changed their add-on model to the [WebExtensions API](https://developer.mozilla.org/Add-ons/WebExtensions), which does not allow implementing protocol handlers.

**Copper cannot be fixed** to work again unless Mozilla changes the internals of Firefox again -- not to the old one, but a safe one that allows for protocol handler add-ons.

### Alternatives

* [Copper4Cr](https://github.com/mkovatsc/Copper4Cr): Chrome also uses the WebExtensions API, but has a loophole through [discontinued Apps](https://blog.chromium.org/2016/08/from-chrome-apps-to-web.html) installed in developer mode

* [Californium (Cf) Browser](https://github.com/eclipse/californium.tools/tree/master/cf-browser): Java-based tool, yet without the debug options support

* [Firefox 55 Portable](https://sourceforge.net/projects/portableapps/files/Mozilla%20Firefox%2C%20Portable%20Ed./Mozilla%20Firefox%2C%20Portable%20Edition%2055.0.3/): Downgrade, but only use for add-ons, not browsing...

   1. Ensure to start offline (no Internet connection!) and disable auto updates

   2. Open `about:config`

   3. Search `browser.tabs.remote.autostart` and `browser.tabs.remote.autostart.2`

   4. Set both to `false`

## A Firefox add-on to browse the Internet of Things

### How to integrate the Copper sources into Firefox:

1. Get the sources from Github: `clone git://github.com/mkovatsc/Copper.git`

2. Add a text file named `[email protected]` to your extension directory of your profile:

 - Windows: `C:\Users\\AppData\Roaming\Mozilla\Firefox\Profiles\xxxxxxxx.default\extensions\`

 - Linux: `~/.mozilla/firefox/xxxxxxxx.default/extensions/`

 - MacOS: `~/Library/Application Support/Firefox/Profiles/xxxxxxxx.default/extensions/`

3. Write the path to the Copper sources (i.e., the directory that contains `install.rdf` and `chrome.manifest`) with (back)slash at the end to the file (e.g., `D:\Projects\Git\Copper\`).

4. Since Firefox 43 you need to **allow unsigned add-ons** by opening [about:config](about:config) and setting `xpinstall.signatures.required` to false.

5. Restart Firefox.

6. Optionally use [about:config](about:config) with the filter "copper" to clean up old configurations.

Copper should show up in the add-ons list. You can now enter CoAP URIs (e.g., [coap://californium.eclipse.org/](coap://californium.eclipse.org/)) into the address bar and will have a user interface to interact with the CoAP resources on a server. The detailed log output is available through the rectangular button on the top right, next to the preferences button.

### See also:

 - [Setting up Extension Development Environment](https://developer.mozilla.org/en/setting_up_extension_development_environment)

 - [Firefox Profile Manager](https://support.mozilla.org/en-US/kb/profile-manager-create-and-remove-firefox-profiles)