Open Web Calendar

Embed a highly customizable web calendar into your website using ICal source links
Alternatives To Open Web Calendar
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Ical1,057179287 days ago41June 21, 202240mitPHP
iCal-creator for PHP
Gas Ics Sync799
21 days ago69gpl-3.0JavaScript
A Google Apps Script for syncing ICS/ICAL files faster than the current Google Calendar speed
Calendar Links7906320 days ago25June 09, 20223mitPHP
Generate add to calendar links for Google, iCal and other calendar systems
Date Holidays773393711 days ago118July 01, 202218otherJavaScript
worldwide holidays
Lunar Calendar686
6 months ago1bsd-2-clausePython
iCal农历, 节气, 传统节日
Ical Generator6031533411 hours ago174July 06, 20224mitTypeScript
ical-generator is a small piece of code which generates ical calendar files
Ics5325332a month ago79August 27, 202211iscJavaScript
iCalendar (ics) file generator for node.js
Ics Py51083283 months ago15July 06, 202225otherPython
Pythonic and easy iCalendar library (rfc5545)
Add To Calendar Buttons407
3 years ago32JavaScript
Easily add a "add to calendar" button to your websites. This JavaScript library supports Google Calendar, iCal, Outlook and Yahoo Calendar.
Ics Parser40478146 days ago41July 15, 20229mitPHP
Parser for iCalendar Events • PHP 8+, 7 (≥ 7.4), 5 (≥ 5.6)
Alternatives To Open Web Calendar
Select To Compare

Alternative Project Comparisons

Open Web Calendar

Build Status Support on Open Collective build and publish the Docker image

You might want to:

Python: 3.7, 3.8, 3.9, 3.10

There are several commercial solutions which allow embedding of calendars into my website. I only have a link to an ICS file and want to show a nice-looking calendar on my site. Browser-only calendars usually have the problem that many ICS files can not be accessed (such as ownCloud/nextCloud in my case). I also want to be in control over who knows the people who visit the site and not pass everything to Google. This is a solution in my case which I share with the world. You are free to use it or deploy your own, modify or share it. It works offline and in company networks, too.


  • Embedded calendar
  • Choice of time zone
  • ICS link, best multiple
  • month/week as a view
  • name, time of event, link?
  • showing the time span
  • styling of choice (icon, color, font, ...)


There are several ways in which you can help this project:


You can deploy the app using Heroku. There is a free plan.


Heroku uses gunicorn to run the server, see the Procfile.

Environment Variables - Configuration

These environment variables can be used to configure the service:

  • APP_DEBUG default true, values true or false, always false in the Docker container Set the debug flag for the app.
  • PORT default 5000, default 80 in the Docker container
    The port that the service is running on.
  • WORKERS default 4 only for the Docker container
    The number of parallel workers to handle requests.
    Seconds to cache the calendar files that get downloaded to reduce bandwidth and delay.


To build the container yourself type the command

docker build --tag niccokunzmann/open-web-calendar .

You can also use the existing image: niccokunzmann/open-web-calendar.

docker run -d --rm -p 5000:80 niccokunzmann/open-web-calendar

Then, you should see your service running at http://localhost:5000.

Docker Compose

Using pre build dockerhub image with docker-compose

version: '3'
    image: niccokunzmann/open-web-calendar
      - '80:80'
      - WORKERS=4
    restart: unless-stopped

To deploy the open-web-calendar with docker-compose, do the following steps:

  1. Copy the docker-compose.yml file to the directory from where you want to run the container.
  2. If needed change port mapping and environment variables.
  3. Type docker-compose up -d to start the container.
  4. The container will be pulled automatically from dockerhub and then starts.

Important Note: If you use this service, consider setting up log rotation as it is very talkative.

Update prebuild image with Docker Compose

If you want to update your image with the latest version from dockerhub type docker-compose pull

Note: You need to start the container after pulling again in order for the update to apply (docker-compose up -d)


You can create a fork of this repository which automatically deploys to Vercel:


Alternatively you can create a one off deploy by cloning this repository and running npx vercel at the root.




Search Terms

calendar ics service, ics calendar to html, open source calendar view ical, python Ical, calendar viewer website for ics, open source calendar website, embed calendar into website

Software Components


  1. Optional: Install virtualenv and Python3 and create a virtual environment.
    virtualenv -p python3 ENV
    source ENV/bin/activate
  2. Install the packages.
    pip install -r requirements.txt
  3. Start the app.

For the configuration of the app through environment variables, see the app.json file.

Running Tests

To run the tests, we use tox. tox tests all different Python versions which we want to be compatible to.

pip install tox

Run all tests:


Run a specific Python version:

tox -e py39

Updating Dependencies

We use pip-compile to guarantee a tested deployment by fixing all the dependencies to a specific version.

You can update the packages to the latest version:

rm requirements.txt test-requirements.txt
pip install --upgrade pip-tools -r -r
pip-compile -o requirements.txt
pip-compile -o test-requirements.txt

And run the tests:



  • v1.5
  • v1.4
    • add event categories when you click an event, see PR 159.
  • v1.3
    • update translation mistake
    • fix encoding problem for languages other than en/de
    • add ability to remove all controls
    • test with GitHub actions
    • test user interface
  • v1.2
  • v1.1
    • Add Coatian Language by Tomislav Gomerčić
  • v1.0

Related Work

Popular Ical Projects
Popular Calendar Projects
Popular Applications Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.