conrad helps you track conferences and meetups on your terminal!

Here's how it works:

$ conrad show

You can set CFP reminders so that you never miss a deadline! The color changes based on date proximity; > 30 days , >10 and < 30 days and < 10 days .

$ conrad remind -i 6bb714
$ conrad remind

Protip: Add conrad remind to your shell startup file so that you get a reminder every time you open a new terminal!

You can explore the conference database using various filters.

Look at conferences which have an open call for proposals (cfp):

$ conrad show --cfp

Look at conferences using a tag:

$ conrad show --tag python

Look at conferences using a name:

$ conrad show --name pycon

Look at conferences in a city, state or country:

$ conrad show --location usa

Look at conferences based on when they're happening:

$ conrad show --date ">= 2019-10-01" --date "<= 2020-01-01"

The event list is maintained in data/events.json. This list is continuously updated using the available scrapers.

You can get the latest events using:

$ conrad refresh

You can add new events to the list! The Contributor's Guide has detailed information about contributions.

To do so, create a new_events.json file containing the list of events you want to add, with the following fields:

[
    {
        "name": "PyCon US",
        "url": "https://us.pycon.org",
        "city": "Pittsburgh",
        "state": "Pennsylvania",
        "country": "USA",
        "cfp_open": true,
        "cfp_start_date": "2019-09-12",
        "cfp_end_date": "2019-12-20",
        "start_date": "2020-04-15",
        "end_date": "2020-04-23",
        "source": "https://www.python.org/events/",
        "tags": "['python']",
        "kind": "conference"
    }
]
"new_events.json" 17L, 436C

After that, clone this repository and create a new branch:

$ git clone https://www.github.com/vinayak-mehta/conrad
$ cd conrad
$ git checkout -b add-new-event

Then import the new events:

$ conrad import -f ../new_events.json

And finally push your changes and raise a PR!

$ git add .
$ git commit -m "Add new events"
$ git push origin add-new-event

You can simply use pip to install conrad:

$ pip install conference-radar

Or you can clone the repo:

$ git clone https://www.github.com/vinayak-mehta/conrad

And install conrad:

$ cd conrad
$ pip install .

conrad uses Semantic Versioning. For the available versions, see the tags on this repository.

This project is licensed under the Apache License, see the LICENSE file for details.