Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Implementing Matrix commands #40

Draft
wants to merge 10 commits into
base: main
Choose a base branch
from
15 changes: 15 additions & 0 deletions .env.example
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Solid configuration
# Only needed when saving to Solid as opposed to your local filesystem
SOLID_IDP=https://storage.inrupt.com
SOLID_USERNAME=yourusername
SOLID_PASSWORD=

# Matrix configuration
# Only needed when the Matrix API will be used
MATRIX_USER_ID=@your:matrixid.org
MATRIX_ACCESS_TOKEN=syt_YoUr_MatrIx_Access_TokeN
MATRIX_BASE_URL=http://matrix.org

# Gitter configuration
# Only needed when the (deprecated) Gitter API will be uesd
GITTER_TOKEN=
11 changes: 10 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,16 @@ analysis tools on top of your gitter chat data? Maybe you should be using this s


## Usage
The variables referenced in this section can be configured through any of the following:
- (When using the terminal script) providing them when prompted
- Using `export` directly in your shell
- Creating a .env file (see [.env.example](.env.example))

### Solid access

If you will be storing your chats on the local filesystem, you don't need Solid access.

If you will be storing your chats on a Solid Pod (either local or remote), you will need to provide login credentials to give your script write access. You can export enviornoment variables (SOLID_IDP, SOLID_USERNAME, SOLID_PASSWORD) or let the script prompt you for the values if the environment variables are not found.
If you will be storing your chats on a Solid Pod (either local or remote), you will need to provide login credentials to give your script write access. You can export environment variables (SOLID_IDP, SOLID_USERNAME, SOLID_PASSWORD) or let the script prompt you for the values if the environment variables are not found.

### Gitter access

Expand All @@ -36,6 +41,10 @@ node gitter-solid.js list
Once you have set your shell session up with the gitter token,
you can use gitter-solid repeatedly.

### Matrix Access

To access Matrix (or Gitter using the Matrix API), you can optionally configure MATRIX_USER_ID, MATRIX_ACCESS_TOKEN & MATRIX_BASE_URL (defaults to http://matrix.org). To get an access token, you can follow the [instructions here](https://t2bot.io/docs/access_tokens/).

## Gitter rooms

In gitter, the concept of a room includes public rooms, private rooms, and private 1-1 conversations, some call *direct messaging*.
Expand Down
Loading