Hyacinth 🦜

Documentation: https://slensky.com/hyacinth

Overview

Hyacinth is a Discord bot which will automatically send you notifications for new listings or postings anywhere on the web, with out-of-the-box support for Craigslist and Facebook Marketplace.

Taking inspiration from the venerable youtube-dl, Hyacinth provides a core interface for filtering listings and sending notifications while allowing new listing sources to be added using a flexible plugin system.

Hyacinth offers a number of advanced features for power-users, including:

• Complex filtering rules, including text-based filtering using arbitrary boolean rules
• Customizable polling intervals, allowing full control over how often the bot checks for new listings
• Search batching, reducing the number of times listing sources are polled for each search and allowing for more searches before hitting anti-bot measures

For more information and the user guide, please head over to the documentation.

Local development

This application is built with Docker, and the recommended local development flow makes use of the Docker integrations available for modern IDEs (such as VS Code Remote Development). To run the local development container in the background, use the following docker-compose command:

docker-compose up -d devbox

Then attach to the container using your favorite IDE.

Getting additional help

If you have a question, bug report, or want to make a general inquiry about the project, please create a new GitHub issue. If you are having a problem with Hyacinth, please make sure to include your operating system, complete logs, and any additional information about your Hyacinth configuration that may be relevant.

Questions directed to any personal accounts outside of GitHub will be ignored.