{"id":13902333,"url":"https://github.com/tizisdeepan/EventsCalendar","last_synced_at":"2025-07-18T00:31:30.170Z","repository":{"id":46104361,"uuid":"149287531","full_name":"tizisdeepan/EventsCalendar","owner":"tizisdeepan","description":"Events Calendar is a user-friendly library that helps you achieve a cool Calendar UI with events mapping. You can customise every pixel of the calendar as per your wish and still achieve in implementing all the functionalities of the native android calendar in addition with adding dots to the calendar which represents the presence of an event on the respective dates. It can be done easily, you are just a few steps away from implementing your own badass looking Calendar for your very own project!","archived":false,"fork":false,"pushed_at":"2019-11-26T07:25:41.000Z","size":1022,"stargazers_count":228,"open_issues_count":13,"forks_count":42,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-07-11T18:14:32.081Z","etag":null,"topics":["android","calendar","calendar-component","calendar-events","calendar-view","java","kotlin-android"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tizisdeepan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-18T12:50:27.000Z","updated_at":"2024-06-27T13:02:58.000Z","dependencies_parsed_at":"2022-08-12T12:40:37.103Z","dependency_job_id":null,"html_url":"https://github.com/tizisdeepan/EventsCalendar","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tizisdeepan%2FEventsCalendar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tizisdeepan%2FEventsCalendar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tizisdeepan%2FEventsCalendar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tizisdeepan%2FEventsCalendar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tizisdeepan","download_url":"https://codeload.github.com/tizisdeepan/EventsCalendar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":214260227,"owners_count":15707062,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","calendar","calendar-component","calendar-events","calendar-view","java","kotlin-android"],"created_at":"2024-08-06T22:01:06.449Z","updated_at":"2024-08-06T22:03:14.418Z","avatar_url":"https://github.com/tizisdeepan.png","language":"Kotlin","funding_links":[],"categories":["Kotlin"],"sub_categories":[],"readme":"# Events Calendar\n[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg?style=flat-square)](https://www.apache.org/licenses/LICENSE-2.0.html)\n[![](https://jitpack.io/v/tizisdeepan/eventscalendar.svg)](https://jitpack.io/#tizisdeepan/eventscalendar)\n[![](https://jitpack.io/v/tizisdeepan/EventsCalendar/month.svg)](https://jitpack.io/#tizisdeepan/EventsCalendar)\n\n\u003ctable\u003e\n    \u003ctr\u003e\u003ctd align=\"center\"\u003e\u003cimg src=\"https://github.com/tizisdeepan/eventscalendar/blob/master/screenshots/ss1.png\" alt=\"Single Selection Mode\" width=\"100%\"\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"https://github.com/tizisdeepan/eventscalendar/blob/master/screenshots/ss2.png\" alt=\"Range Selection Mode\" width=\"100%\"\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cimg src=\"https://github.com/tizisdeepan/eventscalendar/blob/master/screenshots/ss3.png\" alt=\"Multiple Selection Mode\" width=\"100%\"\u003e\u003c/td\u003e\u003c/tr\u003e\n    \u003ctr\u003e\u003ctd align=\"center\"\u003e\u003cb\u003eSingle Selection Mode\u003c/b\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cb\u003eRange Selection Mode\u003c/b\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cb\u003eMultiple Selection Mode\u003c/b\u003e\u003c/td\u003e\u003c/tr\u003e\n\u003c/table\u003e\n\n## What is Events Calendar?\nEvents Calendar is a user-friendly library that helps you achieve a cool Calendar UI with events mapping. You can customise every pixel of the calendar as per your wish and still achieve in implementing all the functionalities of the native android calendar in addition with adding dots to the calendar which represents the presence of an event on the respective dates. Events Calendar also has multi-lingual support. You are just a few steps away from implementing your own badass looking Calendar for your very own project!\n\n## Implementation\n### [1] In your app module gradle file\n```gradle\ndependencies {\n    implementation 'com.github.tizisdeepan:eventscalendar:1.6.1'\n}\n```\n\n### [2] In your project level gradle file\n```gradle\nallprojects {\n    repositories {\n        maven { url 'https://jitpack.io' }\n    }\n}\n```\n### [3] Use EventsCalendar in your layout.xml\n```xml\n\u003ccom.events.calendar.views.EventsCalendar\n    android:id=\"@+id/eventsCalendar\"\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"wrap_content\"\n    android:background=\"#000000\"\n    android:overScrollMode=\"never\"\n    app:datesTextSize=\"16sp\"\n    app:eventDotColor=\"#ff0000\"\n    app:isBoldTextOnSelectionEnabled=\"true\"\n    app:monthTitleColor=\"#ffffff\"\n    app:monthTitleTextSize=\"16sp\"\n    app:primaryTextColor=\"#c4c4c4\"\n    app:secondaryTextColor=\"#666666\"\n    app:selectedTextColor=\"#000000\"\n    app:selectionColor=\"#ffe600\"\n    app:weekHeaderColor=\"#c6c6c6\"\n    app:rangeSelectionColor=\"#ffe600\"\n    app:rangeSelectionStartColor=\"#c1ae01\"\n    app:rangeSelectionEndColor=\"#c1ae01\"\n    app:weekHeaderTextSize=\"16sp\" /\u003e\n```\n### [4] Implement EventCalendar.Callback on your Activity/ Fragment\n```kotlin\nclass MainActivity : AppCompatActivity(), EventsCalendar.Callback {\n    ...\n    override fun onDayLongPressed(selectedDate: Calendar?) {\n        Log.e(\"LONG\", \"CLICKED\")\n    }\n    \n    override fun onMonthChanged(monthStartDate: Calendar?) {\n        Log.e(\"MON\", \"CHANGED\")\n    }\n\n    override fun onDaySelected(selectedDate: Calendar?) {\n        Log.e(\"SHORT\", \"CLICKED\")\n    }\n}\n```\n### [5] Create instances and set default values for the EventsCalendar in your Activity/ Fragment\n```kotlin\neventsCalendar.setSelectionMode(eventsCalendar.MULTIPLE_SELECTION) //set mode of Calendar\n              .setToday(today) //set today's date [today: Calendar]\n              .setMonthRange(start, end) //set starting month [start: Calendar] and ending month [end: Calendar]\n              .setWeekStartDay(Calendar.SUNDAY, false) //set start day of the week as you wish [startday: Int, doReset: Boolean]\n              .setCurrentSelectedDate(today) //set current date and scrolls the calendar to the corresponding month of the selected date [today: Calendar]\n              .setDatesTypeface(typeface) //set font for dates\n              .setDateTextFontSize(16f) //set font size for dates\n              .setMonthTitleTypeface(typeface) //set font for title of the calendar\n              .setMonthTitleFontSize(16f) //set font size for title of the calendar\n              .setWeekHeaderTypeface(typeface) //set font for week names\n              .setWeekHeaderFontSize(16f) //set font size for week names\n              .setCallback(this) //set the callback for EventsCalendar\n              .addEvent(c) //set events on the EventsCalendar [c: Calendar]\n              .disableDate(dc) //disable a specific day on the EventsCalendar [c: Calendar]\n              .disableDaysInWeek(Calendar.SATURDAY, Calendar.SUNDAY) //disable days in a week on the whole EventsCalendar [varargs days: Int]\n              .build()\n```\n### [6] You can change selection mode of the calendar as you wish\n```kotlin\neventsCalendar.setSelectionMode(eventsCalendar.SINGLE_SELECTION)\n```\n**Available Selection modes are,**\n1. **SINGLE_SELECTION** -\u003e can select single day at a time\n2. **RANGE_SELECTION** -\u003e can select range of days at a time\n2. **MULTIPLE_SELECTION** -\u003e can select multiple days at a time (not necessary that the selected days be consequtive)\n### Documentation\n\n|XML|Kotlin/Java|Description|\n|---|---|---|\n|`app:primaryTextColor`|`setPrimaryTextColor(color: Int)`|**Primary Text** color of the calendar (selectable dates)|\n|`app:secondaryTextColor`|`setSecondaryTextColor(color: Int)`|**Secondary Text** color of the calendar (disabled dates)|\n|`app:selectedTextColor`|`setSelectedTextColor(color: Int)`|Text color of the **Selected** date|\n|`app:selectionColor`|`setSelectionColor(color: Int)`|Color for the **Selection Circle**|\n|`app:rangeSelectionColor`|`setRangeSelectionColor(color: Int)`|Color for the **Selection Background**|\n|`app:rangeSelectionStartColor`|`setRangeSelectionStartColor(color: Int)`|Color for the **Range Start Selection Background**|\n|`app:rangeSelectionEndColor`|`setRangeSelectionEndColor(color: Int)`|Color for the **Range End Selection Background**|\n|`app:weekHeaderColor`|`setWeekHeaderColor(color: Int)`|Text color for the **Week Header** labels|\n|`app:weekHeaderTextSize`|`setWeekHeaderFontSize(size: Float)`|Text size for the **Week Header** labels|\n|`app:datesTextSize`|`setDateTextFontSize(size: Float)`|Text size for the **Date** labels|\n|`app:monthTitleColor`|`setMonthTitleColor(color: Int)`|Text color for the **Month Title** in the calendar view|\n|`app:monthTitleTextSize`|`setMonthTitleFontSize(size: Float)`|Text size for the **Month Title** in the calendar view|\n|`app:eventDotColor`|`setEventDotColor(color: Int)`|Color for the **Event Dots** marked in the calendar view|\n|`app:isBoldTextOnSelectionEnabled`|`setIsBoldTextOnSelectionEnabled(isEnabled: Boolean)`|Sets whether the dates should be **highlighted** or not|\n\nVoila! You have implemented an awesome Events Calendar for your Android Project now!\n\nDeveloped By\n------------\n\n* Deepan Elango - \u003ctizisdeepan@gmail.com\u003e\n\n\u003ca href=\"https://twitter.com/tizisdeepan\"\u003e\n  \u003cimg alt=\"Follow me on Twitter\" src=\"./screenshots/twitter.png\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.linkedin.com/in/tizisdeepan/\"\u003e\n  \u003cimg alt=\"Add me to Linkedin\" src=\"./screenshots/linkedin.png\" /\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftizisdeepan%2FEventsCalendar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftizisdeepan%2FEventsCalendar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftizisdeepan%2FEventsCalendar/lists"}