Meety - quickly start online meetings from YAML

Problem. Online meetings provide a useful means to communicate with others. With an increasing number of meetings, however, it can get difficult to remember or pick the right meeting location, user id, password and so on.

Goal. Meety aims to provide a quick and easy way to start the right online meeting from a list of predefined meetings. Meetings are defined in YAML, a clean and simple format that is well readable for humans and machines alike. Thus, you can

• view and edit the meetings with your favourite text editor and
• sensibly share them with other users, even if they don't use Meety. (Think of conferences, lectures, ...)

Features. Meety can can load meetings from one or multiple YAML files. The meetings can be filtered by time preferences and/or keywords. After choosing a meeting, Meety will try to connect to it based on the information the meeting provides.

Out of the box, Meety supports meetings via the browser and via the Zoom app. However, the application can easily be configured to handle other types of meetings too, as described in the documentation.

Meety ships with a graphical user interface (program meety, first screenshot above) and with a command line interface (program cmeety, second screenshot above).

Quick start

Just follow the three steps below.

Step 1/3: Install Meety

• Preferred: If you have Python and PIP installed, simply run one of the following commands in your shell:

  • user only: pip3 install --user meety
  • system-wide: sudo pip3 install meety You may have to take care that the path to the installation directory known to your system.

  If the application doesn't run as expected, please consider updating the required packages via the requirements.txt file in this repository: pip install --upgrade -r requirements.txt

• Alternatively download one of the bundles:

  • Linux
    • Debian package (Ubuntu, ...):
    • RPM package (Fedora, openSUSE, ...):
  • MacOS: Right now, there is unfortunately no alternative.
  • Windows
    1. Install the runtime library from Microsoft: Visual C++ 2010 Redistributable Package (x86)
    2. Download the zip archive that contains
       • the graphical user interface (meety.exe) and
       • the required libraries.
    3. Extract the archive into a suitable place (e.g. to C:\Program Files\meety). Maybe create a shortcut to meety.exe (right click on the program and then select "Send to Desktop").

Shortcuts. For convenient use of the graphical user interface, you might want to create shortcuts on your desktop and/or menu.

• run meety
• click on "info" in the bottom right corner
• switch tab "System" and click on "create"

Note: For technical reasons, this is currently not guaranteed to work in all environments. In particular, it does not work for the Windows bundle. Sorry!

Step 2/3: Add a meetings file

Add a YAML file with meeting specifications to your home directory. You may find it helpful to start with a template: you may, for instance,

• GUI: run meety and, if no meetings are found, click on the button "Create specification from template" (this button can also be found in the "info" dialog, on tab "Files")
• CLI:
  • copy the contents of template, also shown below,
  • or run cmeety --init from the command-line, to create a file named meetings.yaml in your home directory.

Example template

# Example meeting specifications in YAML
# Text after '#' is ignored by the application

# FIRST MEETING (Coffee round with colleagues, every morning)
- name: Coffee
  zoom-url: https://zoom.us/j/123456789
  prefer: Monday to Friday, 9 to 10 o'clock
  # short format for time specifications (also for other languages)

# SECOND MEETING (lecture, each Tuesday and Thursday)
- name: My favourite lecture
  url: https://my-university.edu/my-fav-lecture
  prefer:
    - weekday: Tuesday
      time: 12:00 - 14:00
      date: 2020-10-01 - 2021-03-31
    - weekday: Thursday
      time: 14:00 - 16:00
      date: 2020-10-01 - 2021-03-31
  # explicit format for time specifications (also for other languages)

# THIRD MEETING (without time preferences)
- name: Another meeting
  zoom-id: 987-654-321

Step 3/3: Run Meety

The goal of Meety is to help you to connect to the meeting you're looking for quickly and effortlessly. First, you have to identify a meeting of course. Then, you can try to connect to it.

General notes. Meety rates all meetings and shows meetings sorted by their rating (the best matching first). Meetings with equal ratings are shown in the order they have been loaded. Depending on your options, Meety shows all or only matching meetings.

Meetings can be matching with respect to

• their time preferences and
• keywords, if provided.

Matching keywords contribute more to the rating than matching time preferences by default.

Application usage. Although the idea of meeting ratings and display is the same, usage natuarlly varies with the user interface. Each interface is described on its own:

• Graphical user interface (program meety)
• Command-line interface (program cmeety)

Detailed documentation

In the docs directory, you can find more information on Meety. In particular on the following topics:

• How to specify meetings in YAML;
• Select meeting files to load from;
• Configure Meety, in particular how to
  • support other languages,
  • change the colour scheme
  • set default arguments
  • automatically polish meeting data
  • support new connection types