PHPackages                             salinapl/aag-rooms - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. salinapl/aag-rooms

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

salinapl/aag-rooms
==================

A Simple and flexible room reservation status display for e-paper or other non-touch displays.

1.0.1(1mo ago)00[1 issues](https://github.com/salinapl/aag-rooms/issues)MITPHPPHP ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0

Since Jul 5Pushed 1mo agoCompare

[ Source](https://github.com/salinapl/aag-rooms)[ Packagist](https://packagist.org/packages/salinapl/aag-rooms)[ RSS](/packages/salinapl-aag-rooms/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (2)Versions (5)Used By (0)

aag-rooms - At-A-Glance Library Room Reservation status display using Kirby
===========================================================================

[](#aag-rooms---at-a-glance-library-room-reservation-status-display-using-kirby)

A Simple and flexible room reservation status display for e-ink or other non-touch displays using [Kirby](https://getkirby.com)

[![](https://github.com/salinapl/aag-rooms/raw/main/.github/images/example.png)](https://github.com/salinapl/aag-rooms/blob/main/.github/images/example.png) [![](https://github.com/salinapl/aag-rooms/raw/main/.github/images/photo1.jpg)](https://github.com/salinapl/aag-rooms/blob/main/.github/images/photo1.jpg) [![](https://github.com/salinapl/aag-rooms/raw/main/.github/images/example02.png)](https://github.com/salinapl/aag-rooms/blob/main/.github/images/example02.png) [![](https://github.com/salinapl/aag-rooms/raw/main/.github/images/example03.png)](https://github.com/salinapl/aag-rooms/blob/main/.github/images/example03.png) [![](https://github.com/salinapl/aag-rooms/raw/main/.github/images/example04.png)](https://github.com/salinapl/aag-rooms/blob/main/.github/images/example04.png)

Features
--------

[](#features)

- Closing Hour Override per-room
- Per-room toggleable notice text display
- Per-room QR code display dynamically generated through KirbyCMS
- Per-Room description that displays when no upcoming events in timeline
- Ships with integration of LibraryMarket's LibraryCalendar App
- Can use any event calendar app that has JSON event API with some tweaking
- Timeline of upcoming events, hides private event titles but keeps event ID for refrence
- Overflowed events past timeline window are shown at bottom
- Alternative schedule view that shows all events for the day in a static schedule
- Per-Room Color or 2-bit grayscale CSS
- Color picking for color settings for various elements
- Touchscreen option that replaces QR code with reservation button
- Dynamic page scaling tested to work down to **480x360**
- Ships with e-paper friendly fonts and CSS configs
- Originally designed to work on a [TRMNL](https://usetrmnl.com/) device.

Download and Install
--------------------

[](#download-and-install)

This repository only contains the content pages of the site, you will need to download the latest Kirby plainkit seprately.

1. Before Starting, please check that your webserver meets Kirbys minimum requirements **[listed here](https://getkirby.com/docs/guide/quickstart#requirements)** and read the provided getting started documentation.
2. Download the latest release of **[Kirby Plainkit](https://github.com/getkirby/plainkit)**
3. Extract the plainkit to your Website Folder
4. Download the latest release of LibSignTool from the **[releases page](https://github.com/salinapl/LibSignTool/releases)**
5. Extract LibSignTool into the plainkit-main folder
6. Some files may ask to be overwritten, approve all overwrites.
7. Make sure hidden files such as .htaccess copied over, as these are required for the site to operate correctly.
8. Start your webserver and navigate to **yourdomain.example.com/location-of-kirbycms-install/panel** and you will be asked to create an account.
9. After creating the account, you will be able to log in and start adding images to create a campaign. The download includes example pages to get started, but you can edit or remove these pages as long as you replace them with ones using the same or similar templates. Doing more than that will require knowledge of how Kirby works. Examples of what templates do what will be provided later in this document.

### Plugins

[](#plugins)

aag-rooms uses a plugin to keep private API access information safe, to make it work you will either need to remove the code using this plugin, or install this plugin as well (reccomended)

- [DotEnv](https://plugins.getkirby.com/bnomei/dotenv)

Backing up and Installing new Versions
--------------------------------------

[](#backing-up-and-installing-new-versions)

### Kirby

[](#kirby)

Kirby is a Flat-file CMS and does not require a database, which makes it very easy to install and backup. Just copy the folder you installed Kirby and aag-rooms to into your backup location to back it up.

To upgrade Kirby, simply download the newest version of the plainkit, Delete the "kirby" and "media" folders from your install folder, and copy the new versions from the plainkit into the folder. Always refer to the offical Kirby documentation for upgrade instructions as these are subject to change between releases.

aag-rooms is built on Kirby 5. Staying within the same generation of releases should be fine, but wait for offical word before upgrading to possible future KirbyCMS generations such as Kirby 6

#### Kirby 5

[](#kirby-5)

Kirby 5 is now fully supported, Kirby 4 has only been tested up to v4.8.0

Licenses
--------

[](#licenses)

While aag-rooms is provided free under the MIT License, other things in this repository are licensed differently.

### Fonts

[](#fonts)

- [Merriweather Sans by SorkinType](https://github.com/SorkinType/Merriweather-Sans) is licensed under the [SIL OPEN FONT LICENSE Version 1.1](https://openfontlicense.org/documents/OFL.txt)
- [Prompt by Cadson Demak ](https://github.com/cadsondemak/prompt) is licensed under the [SIL OPEN FONT LICENSE Version 1.1](https://openfontlicense.org/documents/OFL.txt)

### Kirby

[](#kirby-1)

You can try Kirby on your local machine or on a test server as long as you need to make sure it is the right tool for your next project.

However Production use requires a License Key.

### Buying a license

[](#buying-a-license)

You can purchase your Kirby license at

A Kirby license is valid for a single domain. You can find Kirby's license agreement here:

You can learn more about Kirby at [getkirby.com](https://getkirby.com).

### Kirby Documentation

[](#kirby-documentation)

### Kirby Support

[](#kirby-support)

Issues
------

[](#issues)

We do not develop for Kirby, for issues getting Kirby up and running, please contact that project. We only provide the website content files to host on Kirby to use as a Digital Signage Platform.

If you have a Github account, please report issues directly on Github:

Or you can email the maintainers directly at

###  Health Score

41

—

FairBetter than 89% of packages

Maintenance91

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.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.

###  Release Activity

Cadence

Every ~132 days

Total

3

Last Release

46d ago

Major Versions

0.9.0 → 1.0.02026-03-26

### Community

Maintainers

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

---

Top Contributors

[![Swizzler121](https://avatars.githubusercontent.com/u/36831696?v=4)](https://github.com/Swizzler121 "Swizzler121 (78 commits)")[![nkitchen86](https://avatars.githubusercontent.com/u/59396550?v=4)](https://github.com/nkitchen86 "nkitchen86 (3 commits)")

### Embed Badge

![Health badge](/badges/salinapl-aag-rooms/health.svg)

```
[![Health](https://phpackages.com/badges/salinapl-aag-rooms/health.svg)](https://phpackages.com/packages/salinapl-aag-rooms)
```

###  Alternatives

[oblik/kirby-link-field

Kirby 4 field for all types of links.

7650.6k2](/packages/oblik-kirby-link-field)[belugadigital/kirby-navigation

Kirby 5 field for hierarchical menus with drag &amp; drop level indentation.

8713.4k](/packages/belugadigital-kirby-navigation)[rasteiner/k3-whenquery

Conditionally show fields and sections. Better.

6717.8k](/packages/rasteiner-k3-whenquery)[bogdancondorachi/kirby-table-field

Table field plugin for Kirby CMS

5317.7k](/packages/bogdancondorachi-kirby-table-field)[floriankarsten/kirby-plausible

Simple plugin providing Plausible tracking and iframe panel view to Kirby panel.

234.5k](/packages/floriankarsten-kirby-plausible)[swiegmann/kirby-menu

This Kirby CMS-Plugin lets you build and render structured menues with a variety of features.

141.4k](/packages/swiegmann-kirby-menu)

PHPackages © 2026

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