https://github.com/vinayak-mehta/conrad

Track conferences and meetups on your terminal.
https://github.com/vinayak-mehta/conrad

git-scraping

Last synced: about 2 months ago
JSON representation

Track conferences and meetups on your terminal.

• Host: GitHub
• URL: https://github.com/vinayak-mehta/conrad
• Owner: vinayak-mehta
• License: apache-2.0
• Created: 2019-01-08T18:56:08.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-09-15T01:53:10.000Z (almost 2 years ago)
• Last Synced: 2024-03-27T17:08:25.723Z (3 months ago)
• Topics: git-scraping
• Language: Python
• Homepage: https://conference-radar.readthedocs.io
• Size: 1.2 MB
• Stars: 241
• Watchers: 10
• Forks: 58
• Open Issues: 32
• Metadata Files:
  • Readme: README.md
  • Changelog: HISTORY.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Lists

• cli-apps - conrad - Track conferences and meetups. (<a name="science"></a>Science)
• my-awesome-stars - vinayak-mehta/conrad - Track conferences and meetups on your terminal. (Python)
• awesome-cli-apps - conrad - Track conferences and meetups. (<a name="science"></a>Science)

README

        


   



# conrad — Conference Radar

[![Workflow Status](https://github.com/vinayak-mehta/conrad/workflows/Get%20events/badge.svg)](https://github.com/vinayak-mehta/conrad/actions) [![Documentation Status](https://readthedocs.org/projects/conference-radar/badge/?version=latest)](https://conference-radar.readthedocs.io/en/latest/) [![image](https://img.shields.io/pypi/v/conference-radar.svg)](https://pypi.org/project/conference-radar/) [![image](https://img.shields.io/pypi/pyversions/conference-radar.svg)](https://pypi.org/project/conference-radar/) [![image](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)

`conrad` helps you track conferences and meetups on your terminal.

---

Here's how it works:


$ conrad show



![show](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show.png)

## Why conrad?

- 📅 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!

- 🤖 Crawlers update events twice a week! (Monday and Thursday at 00:00 UTC)

## Installation

You can simply use pip to install `conrad`:


$ pip install conference-radar



## Features

### Continuous updates

The event list is maintained in `data/events.json`. This list is continuously updated by the available `crawlers` using GitHub Actions.

Sources:

- https://confs.tech

- https://pydata.org/event-schedule

- https://github.com/python-organizers/conferences

- https://wiki.python.org/moin/PythonEventsCalendar

### Set reminders

You can set CFP reminders so that you never miss a deadline! The color changes based on event proximity; **> 30 days** ![#008000](https://placehold.it/15/008000/000000?text=+), **>10 and < 30 days** ![#ffff00](https://placehold.it/15/ffff00/000000?text=+) and **< 10 days** ![#ff0000](https://placehold.it/15/ff0000/000000?text=+).


$ conrad remind -i 6bb714

$ conrad remind



![remind](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/remind.png)

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

### Query and explore

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



![show-cfp](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-cfp.png)

Look at conferences using a tag:


$ conrad show --tag python



![show-tag](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-tag.png)

Look at conferences using a name:


$ conrad show --name pycon



![show-name](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-name.png)

Look at conferences in a city, state or country:


$ conrad show --location usa



![show-location](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-location.png)

Look at conferences based on when they're happening:


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



![show-date](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/show-date.png)

### Refresh event database

You can get the latest events using:


$ conrad refresh



![refresh](https://raw.githubusercontent.com/vinayak-mehta/conrad/master/docs/_static/refresh.png)

## Contributing

The [Contributor's Guide](https://github.com/vinayak-mehta/conrad/blob/master/CONTRIBUTING.md) has detailed information about guidelines around contributions. You can add new crawlers and events to `conrad`:

- [Adding a crawler](https://conference-radar.readthedocs.io/en/latest/dev/adding-crawlers.html)

- [Adding new events](https://conference-radar.readthedocs.io/en/latest/dev/adding-events.html)

## Versioning

`conrad` uses [Semantic Versioning](https://semver.org/). For the available versions, see the tags on this repository.

## License

This project is licensed under the Apache License, see the [LICENSE](https://github.com/vinayak-mehta/conrad/blob/master/LICENSE) file for details.