installation.md

Installation

The recommended setup is to install both the:

1. Browser extension, and
2. Host application.

Installing the browser extension alone can save text files to the Downloads folder.

While installing both the browser extension and host application, text files can be saved anywhere on the computer.

Table of Contents

• Prerequisites
• Download the Host Application
• Install Host Application
  • Windows
  • Mac
  • Linux

Prerequisites

Ensurue Python is installed and available on PATH.

• Python

Download the Host Application

Download this repository as a .zip file, from here.

Copy app/ directory and paste it to your computer, example: C:\app\ or /Users/Robert/app/.

Then rename it to savetexttofile, example: C:\savetexttofile\ or /Users/Robert/savetexttofile/.

Install Host Application

Finally, follow the platform specific steps below.

Windows

Assuming you saved app/ to C:\savetexttofile\ on your computer.

• Navigate to C:\savetexttofile\
• Right click on install_host.bat
• Select Run as administrator, and confirm any prompt.

The host application should now be installed.

Mac

Modify savetexttofile.json, changing the path value to the location used previously:

"path": "/path/to/savetexttofile.py"

->

"path": "/Users/Robert/savetexttofile/savetexttofile.py"

Then copy the manifest to this location under the user's home directory:

~/Library/Application Support/Mozilla/NativeMessagingHosts/savetexttofile.json

Ensure /Users/Robert/savetexttofile/savetexttofile.py is executable:

chmod +x /Users/Robert/savetexttofile/savetexttofile.py

Restart browser, and check the browser extension's options.

Save Text to File's options page should indicate the host application has been successfully configured.

Linux

Modify savetexttofile.json, changing the path value to the location used previously:

"path": "/path/to/savetexttofile.py"

->

"path": "/home/Robert/savetexttofile/savetexttofile.py"

Then copy the manifest to these locations under the user's home directory:

~/.mozilla/native-messaging-hosts/savetexttofile.json
~/.mozilla/managed-storage/savetexttofile.json
~/.mozilla/pkcs11-modules/savetexttofile.json

Ensure /Users/Robert/savetexttofile/savetexttofile.py is executable:

chmod +x /Users/Robert/savetexttofile/savetexttofile.py

Restart browser, and check the browser extension's options.

Save Text to File's options page should indicate the host application has been successfully configured.