Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ryanprior/meet

Start a meeting quickly from the comfort of your command line. πŸ‘©β€πŸ‘©β€πŸ‘§β€πŸ‘¦οΈπŸ’¨οΈ
https://github.com/ryanprior/meet

cli-app jitsi-meet meetings video-chat

Last synced: 3 months ago
JSON representation

Start a meeting quickly from the comfort of your command line. πŸ‘©β€πŸ‘©β€πŸ‘§β€πŸ‘¦οΈπŸ’¨οΈ

Awesome Lists containing this project

README

        

# Meet

Start a [Jitsi](https://meet.jit.si) meeting quickly with `meet`. It creates a
meeting with a secure ID and prints the meeting URL to `stdout`. It can style,
open, copy, and send the URL for your convenience. No registration required, no
data collected.

### Dependencies

`meet` has no required runtime dependencies.

Jitsi requires a browser like Firefox, the [Jitsi Desktop
app](https://desktop.jitsi.org/), or a telephone to join a meeting.

*Optional* dependencies add more features:
- `xsel` to copy URL to clipboard
- `xdg-open` to open the URL in your browser
- `keybase` to send the URL to a friend

## Usage

```sh-session
$ meet
https://meet.jit.si/A8ul9DAc/Meeting
$ meet -c hack on meet
https://meet.jit.si/iN9SYLvP/HackOnMeet
πŸš€ copied to clipboard!
```

### Configuration

Meet works without any configuration files. Optionally, you can initialize to change defaults:

```sh-session
$ meet --init
Base url (meet.jit.si): my-jitsi-server.local
Add random letters to URL for security? (Y/n): n
πŸ“ wrote config to /home/user/.config/meet/settings.yml
$ ./meet hack on meet
https://my-jitsi-server.local/HackOnMeet
```

Meet respects the `XDG_CONFIG_HOME` environment variable if it's set.

### Options

| feature | short | long | description |
|----------|-----------|--------------------|----------------------------------------------|
| settings | | `--init` | initialize meet settings |
| | `-u URL` | `--use URL` | use URL for this meeting |
| | `-i` | `--insecure` | omit secure random portion of URL |
| | | `--secure` | always include secure random portion |
| style | `-s` | `--snake` | use snake_case for meeting title |
| | `-d` | `--dash` | use dashes for meeting title |
| | `-t` | `--title` | use TitleCase for meeting title (default) |
| | `-S` | `--shout` | use SHOUTπŸ‘οΈCASEπŸ—―οΈ for meeting title |
| | `-3` | `--heart` | use ❣️heart❀️style❣️ for meeting title |
| | `-j TEXT` | `--emoji=TEXT` | put `TEXT` between words of meeting title |
| open | `-o` | `--open` | open url in your browser after a short pause |
| | `-O` | `--open-immediate` | open url in your browser immediately |
| copy | `-c` | `--copy` | copy url to clipboard using `xsel` |
| send | `-k USER` | `--send-kb=USER` | send url to `USER` on Keybase |

## Installation

Go to [releases](https://github.com/ryanprior/meet/releases) and download the
latest archive. Then unpack it somewhere on your PATH, such as:

```sh-session
$ cd ~/Downloads
$ tar xzf meet-1.2.0.tgz
$ sudo install meet /usr/local/bin/meet
```

### Installation from source

To install `meet` from source, you will need these dependencies:
- git
- make
- [crystal](https://crystal-lang.org/)
- coreutils
- readline

Crystal has these transitive dependencies: `gcc`, `pkg-config`, `libpcre3-dev`,
`libevent-dev`.

Follow these steps to install:
```sh-session
$ git clone https://github.com/ryanprior/meet.git
$ cd meet
$ make
$ sudo make install
```