Breviarium – Liturgy of the Hours for iOS

This project contains the iOS app for Liturgia-hodin-online created by Juraj Vidéky.

The application is available for the following languages:

• Slovak (web version: http://breviar.sk)
• Czech (web version: http://ebreviar.cz)
• Hungarian (web version: http://zsolozsma.katolikus.hu)

Getting started

This repository contains only the iOS sources, so in order to get started you have to fetch the rest of the files from various places.

First, clone this repository:

git clone https://github.com/gyim/breviar-ios.git

This project uses the sources of the web version as a submodule. However, this repository is not public, only some parts of it (unless you join the core team). To obtain the public sources you have to do the following:

# Fetch the public sources
cd breviar-ios
git clone https://github.com/breviar-sk/Liturgia-hodin-online.git breviar-cgi

# Fetch the text from the websites:
cd breviar-cgi
wget -r http://breviar.sk/include -nd -P include
wget -r http://breviar.sk/include_cz -nd -P include_cz
wget -r http://breviar.sk/include_hu -nd -P include_hu

URL Scheme Support

The Breviar app supports custom URL schemes that allow other applications to open specific content within the app.

Supported URL Formats

Basic Navigation

• breviar:// - Opens the app to today's main screen
• breviar://today - Opens the app to today's main screen
• breviar://YYYY-MM-DD - Opens the app to a specific date (e.g., breviar://2025-01-01)

Prayer-Specific Navigation

• breviar://today/PRAYER_NAME - Opens a specific prayer for today
• breviar://YYYY-MM-DD/PRAYER_NAME - Opens a specific prayer for a specific date

Valid Prayer Names

The following prayer names are supported:

• invitatory - Invitatory
• officeofreadings - Office of Readings
• morningprayer - Morning Prayer
• midmorningprayer - Mid-Morning Prayer
• middayprayer - Mid-Day Prayer
• midafternoonprayer - Mid-Afternoon Prayer
• eveningprayer - Evening Prayer
• compline - Compline

Examples

breviar://                          → Today's main screen
breviar://today                     → Today's main screen
breviar://2025-01-01               → January 1, 2025 main screen
breviar://today/morningprayer       → Today's Morning Prayer
breviar://2025-01-01/compline      → Compline for January 1, 2025
breviar://2025-12-25/officeofreadings → Office of Readings for Christmas

Integration

Other applications can open Breviar content using:

iOS (Swift/Objective-C):

if let url = URL(string: "breviar://today/morningprayer") {
    UIApplication.shared.open(url)
}

Web/JavaScript:

window.location.href = "breviar://today/morningprayer";