_           _                ____  
 _ __ __ _(_)_ __   __| |_ __ ___  _ __|___ \ 
| '__/ _` | | '_ \ / _` | '__/ _ \| '_ \ __) |
| | | (_| | | | | | (_| | | | (_) | |_) / __/ 
|_|  \__,_|_|_| |_|\__,_|_|  \___/| .__/_____|
                                  |_|         
SETUP INSTRUCTIONS
INTRO
=====

Welcome to Raindrop2!

The main benefit of this extension is that it runs completely locally on your network - no cloud, no fees, and it's super fast!

Setup prerequisites:
- Python 3 installed
- The Python packages "flask", "zeroconf", and "qrcode"

SETUP
=====

To set this up to work with Firefox, you need to put a specific JSON file in a Firefox folder. This JSON file will link to a Python script, which you must also have installed. I have made two setup scripts (for macOS and Windows) that do this for you:
[ ↓ host.py ][ ↓ install.sh (macOS) ][ ↓ install.bat (Windows) ]
To use either script, please put host.py and the install script in the same folder. Note that host.py will need to stay in that folder, so it's better to put it under Documents or Desktop rather than Downloads.

IMPORTANT: Make sure that the first line in host.py leads to your Python interpreter!

To run this on macOS, open Terminal in that folder, enter "chmod +x install.sh" then "./install.sh". To run this on Windows, simply open the file.

You can also set this up manually. To do so on macOS or Linux, please write the following into a JSON file and edit the path to host.py:

{
  "name": "com.yoavgrinberg.raindrop2",
  "description": "Raindrop2",
  "path": "/ABSOLUTE/PATH/TO/host.py",
  "type": "stdio",
  "allowed_extensions": [ "raindrop2@yoavgrinberg.com" ]
}

This file should be named "com.yoavgrinberg.raindrop2.json" and should be placed in the following folder (create it if it doesn't exist):

macOS: ~/Library/Application Support/Mozilla/NativeMessagingHosts/
Linux: ~/.mozilla/native-messaging-hosts/com.local.filedrop.json

For Windows, create this file anywhere and link to it with the registry key:
"HKEY_CURRENT_USER\Software\Mozilla\NativeMessagingHosts\com.yoavgrinberg.raindrop2"
and set the (Default) string to the absolute path of the JSON file.


-----------------------------------------------------------
[ <- RETURN TO HOMEPAGE ]