Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Lightweight and extremely customizable notifier. Designed to work with Twitter and much more

Project Description

Ciciòl aims to be a simple but extremely customizable and lightweight
notifier. Was designed to work with Twitter but its plugin-based structure
makes it extendible for any kind of service.

Getting Started
* Install from PyPi:
* ``` pip install ciciol ``` or ``` easy_install ciciol ```
* Install from git:
* ```
git clone
* ```
python install
* Install python-notify for libnotify support

* Write your own configuration file
* If you want to use twitter just copy the config file in examples/.
Get access_key and access_secret with:
ciciol --setup twitter
* Launch ciciol

What are handlers?
Handlers are plugins for handling sources of information and extract
interesting notifications from them. For example the Twitter handler looks
for new tweets, filters according to what the user specified in the config
file and sends the notification data to one or more backends.

What are backends?
Backends are plugins for effectively notify the user using various techniques
(desktop notifications, emails, IRC, ...).

Writing a configuration file
First of all have look at the examples in examples/
Basically in the configuration file you've to specify which handlers and
backends you'd like to use plus optional handler specific configuration.


Writing a plugin for Ciciòl is very easy! Start having a look at the existing
Feel free to fork this repo, open issues and send pull requests

Development Status
[![Build Status](](
Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ciciol-0.1.1.tar.gz (6.8 kB) Copy SHA256 Checksum SHA256 Source Mar 26, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting