conrad helps you track conferences and meetups on your terminal!

Here's how it works:

$ conrad show

• 📅 Never miss CFP deadlines again. conrad remind can remind you every time you open a terminal!
• 📊 Query and explore events using tags, names, locations, and dates. conrad show --cfp will tell you about events where the cfp is open!
• 🔄 Run conrad refresh to get the latest events!
• 🤖 (upcoming) The event database updates automatically with events curated by the community.
• ⛏️ You can manually add events using conrad import -f events.json and raise a PR!

You can simply use pip to install conrad:

$ pip install conference-radar

You can set CFP reminders so that you never miss a deadline! The color changes based on event 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 query and explore the event database using various filters.

Look at events 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"

You can get the latest events using:

$ conrad refresh

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

Sources:

• https://www.python.org/events
• https://github.com/python-organizers/conferences

The Contributor's Guide has detailed information about guidelines around contributions.

You can add new events to the list! To do so:

1. 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

2. Fork the project repository. Click on the ‘Fork’ button near the top of the page. This creates a copy of the code under your account on the GitHub. Clone your fork of conrad from your GitHub account:

    $ git clone https://www.github.com/[username]/conrad
    $ cd conrad

3. Create a branch to hold your changes:

    $ git checkout -b add-new-event

4. Import the new events:

    $ conrad import -f ../new_events.json

5. Finally push your changes and raise a PR!

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

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.