#+title: Pal - Peoply Action Listener
#+author: Aksel Olav Steen

Pal is a simple tool designed to track events posted to [[https://peoply.app][Peoply]], and post
them to a given discord channel.

* Introduction
  Pal is pal.

* Setup
  Echo the webhook to a =.env= file in the root directory.

  #+begin_src sh
  echo "DISCORD_WEBHOOK_URL=<webhook_url>" > .env
  #+end_src

  Make sure =direnv= uses the provided =shell.nix=.

  #+begin_src sh
  echo "use nix" > .envrc && direnv allow
  #+end_src

  Alternatively, use =pip= /yuck/.

  #+begin_src sh
  python3 -m venv .venv
  source .venv/bin/activate
  pip install -r requirements.txt
  echo "export VIRTUAL_ENV='.venv'\nlayout python3" > .envrc && direnv allow
  #+end_src

* Usage
  To start Pal as a "standalone", run the provided =main.py=.

  #+begin_src sh
  python3 main.py
  #+end_src

  To start Pal as a systemd service, do the following.

  #+begin_src sh
  # Start the service
  systemctl --user start pal.service

  # Auto startup
  systemctl --user enable pal.service
  #+end_src

* License
  This project is licensed under the MIT License.