margi / fedocal

Forked from fedocal 5 years ago

margi / fedocal

Forked from fedocal 5 years ago
A web-based calendar for Fedora
Members 1
Pierre-Yves Chibon committed 5 years ago


Author: Pierre-Yves Chibon <>

fedocal is a web based calendar application.

Get this project:

Source: Mirror on github: (Please use Pagure as the main repository and make sure you run your patch against it)



This project is a Flask application. The calendars and meetings are stored into a relational database using SQLAlchemy as Object Relational Mapper (ORM) and alembic to handle database scheme changes. fedocal provides an iCal feed for each calendar and relies on python-vobject for this. Finally, pytz is used to handle the timezone changes and dateutil to allow date manipulation over months/years.

The dependency list is therefore:

Running a development instance:

Clone the source:

git clone

Copy the configuration files:

cp fedocal.cfg.sample fedocal.cfg
cp alembic.ini.sample alembic.ini

Adjust the configuration file (secret key, database URL, admin group...)

Create the database scheme:

FEDOCAL_CONFIG=fedocal.cfg sh createdb

Run the server:

FEDOCAL_CONFIG=`pwd`/fedocal.cfg python

You should be able to access the server at http://localhost:5000


the part FEDOCAL_CONFIG=fedocal.cfg is only really needed if you run fedocal on a dedicated database instead of the default sqlite one.


This project contains unit-tests allowing you to check if your server has all the dependencies correctly set.

To run them:



To stop the test at the first error or failure you can try:

./ -x

Reporting issues:

For any issue you may encounter please file a ticket and submit it to:

Fedocal Pagure:

Contributors can use the same tracker to find existing bugs to work on. You need to login with your FAS account to submit or modify a ticket.


This project is licensed GPLv3+.