PHPackages                             timegridio/icalreader - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. timegridio/icalreader

ActiveLibrary

timegridio/icalreader
=====================

iCal reader wrapper for Laravel 5

730.9k↓12.5%6[1 issues](https://github.com/timegridio/icalreader/issues)PHP

Since Aug 2Pushed 3y ago2 watchersCompare

[ Source](https://github.com/timegridio/icalreader)[ Packagist](https://packagist.org/packages/timegridio/icalreader)[ RSS](/packages/timegridio-icalreader/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

icalreader
==========

[](#icalreader)

[![Latest Version on Packagist](https://camo.githubusercontent.com/52156a569c609ac18c992db3d160b50f5a020ec14d055b7fdd2ca277ff99f5d2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74696d6567726964696f2f6963616c7265616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/timegridio/icalreader)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/67bafea5dcca8145b955ee932ab408ae329037e337b0d9c7cef3e2b2a8ac1bc2/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f74696d6567726964696f2f6963616c7265616465722f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/timegridio/icalreader)[![Test Coverage](https://camo.githubusercontent.com/40843868cc9f9590de7ec9e798a2c47f9e91f92583fb24f49f222c2461c51c0a/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f74696d6567726964696f2f6963616c7265616465722f6261646765732f636f7665726167652e7376673f7374796c653d666c61742d737175617265)](https://codeclimate.com/github/timegridio/icalreader/coverage)[![Code Climate](https://camo.githubusercontent.com/735b7ef9167969861eabf4c4f3a8a82083162bc974ec8c3642bac85700ebc549/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f74696d6567726964696f2f6963616c7265616465722f6261646765732f6770612e7376673f7374796c653d666c61742d737175617265)](https://codeclimate.com/github/timegridio/icalreader)[![Coverage Status](https://camo.githubusercontent.com/70af7087dce005cdf41cac6f2cb7ba70b72d5cc0c8975ffcde4af67d9fa261d4/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f74696d6567726964696f2f6963616c7265616465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/timegridio/icalreader/code-structure)[![Quality Score](https://camo.githubusercontent.com/b798293f1b1bdd8e4b00cf80e4618e9af48750e17ab33d7ead1784114a4922e0/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f74696d6567726964696f2f6963616c7265616465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/timegridio/icalreader)[![Total Downloads](https://camo.githubusercontent.com/7597ec6d4ee7d8ee232384f65ca00b0fa26762b16088d3299b317abe62ba6765/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f74696d6567726964696f2f6963616c7265616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/timegridio/icalreader)

License
-------

[](#license)

This ics-parser is under MIT License. You may use it for your own sites for free, but I would like to get a notice when you use it (). If you use it for another software project, please state the information / links to this project in the files.

It is hosted at  and the PEAR coding standard is used.

It was modified by John Grogg to properly handle recurring events (specifically with regards to Microsoft Exchange).

It was later modified by Ariel Vallese to be easily integrated to Laravel with through the Service Provider and support services.

Tests have been written and a code refactor is planned to take place.

Install
-------

[](#install)

Via Composer

```
$ composer require timegridio/icalreader
```

Add the Service Provider:

```
Timegridio\ICalReader\ICalReaderServiceProvider::class,

```

Usage
-----

[](#usage)

```
$icalevents = app()->make('ical');

$icalevents->loadUrl('http://example.org/calendar.ics');

$busy = $this->icalevents->isBusy(Carbon::parse('2016-07-06 10:30'));

// true|false

```

[Checkout the tests](tests/unit/) to find more examples.

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Testing
-------

[](#testing)

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Martin Thoma](https://github.com/MartinThoma)
- [John Grogg](https://github.com/johngrogg)
- [Ariel Vallese](https://github.com/alariva)
- [All Contributors](../../contributors)

License
-------

[](#license-1)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity25

Early-stage or recently created project

 Bus Factor1

Top contributor holds 93.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/d0ae4753838afbfd34e573e3a73c3f69c02a31de0c477cffae908408dc30e590?d=identicon)[alariva](/maintainers/alariva)

---

Top Contributors

[![alariva](https://avatars.githubusercontent.com/u/3021314?v=4)](https://github.com/alariva "alariva (14 commits)")[![sifatistiak](https://avatars.githubusercontent.com/u/26132497?v=4)](https://github.com/sifatistiak "sifatistiak (1 commits)")

### Embed Badge

![Health badge](/badges/timegridio-icalreader/health.svg)

```
[![Health](https://phpackages.com/badges/timegridio-icalreader/health.svg)](https://phpackages.com/packages/timegridio-icalreader)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)