unzip *.crx -d puppet/extension_files, or with a GUI tool like GNOME File Roller
puppetdirectory and run
node prep_helper.jsto open the version of Chrome downloaded by Puppeteer, and click on the LINE icon next to the URL bar
puppet/config.json, and set some important settings:
"url"to the UUID found in the previous step
"listen"settings to the socket to use for communication with the bridge (see puppet/README.md for details)
cdto the project root directory and create a Python virtual environment with
python -m venv .venv, and enter it with
pip install -Ur requirements.txtfor base functionality
pip install -Ur optional_requirements.txtfor end-to-bridge encryption and metrics
config.yaml, and update it with the proper settings to connect to your homeserver
puppeteer.connectionsettings to use the socket you chose in
python -m matrix_puppeteer_line -gto generate an appservice registration file, and update your homeserver configuration to accept it
puppetdirectory, launch the Puppeteer module with
python -m matrix_puppeteer_line
Puppeteer cannot be run in headless mode when using Chromium with extensions (including the LINE extension).
As a workaround, it may be run in a background X server. This allows running the Puppeteer module on a GUI-less server.
An easy way to do so is to install
xvfb from your distribution, and run the Puppeteer module with
xvfb-run yarn start.
git pull or
git rebase the latest changes, and rerun any installation commands (
pip install -Ur ...).
To upgrade the LINE extension used by Puppeteer, simply download and extract the latest .crx in the same location as for initial setup.