Skip to content

Reading Plans

Video tutorial: Reading plans and reading progressComing soon Watch the preview video

Reading plans provide a pre-determined schedule of scripture readings. To access reading plans, navigate to the left main menu (☰) and choose Reading Plan.

When first accessing Reading Plan, you will be prompted to select a plan (Choose a Reading Plan). After selecting a plan, you will be shown the Reading Plan screen for the first day of the reading plan’s schedule. Its title shows the plan name, with the day (and date) below it.

Passage references in the Reading Plan screen and the list of days use the chapter and verse numbering of your current Bible. Plans are mapped from the numbering they declare (KJV for built-in plans), so a reading may span different chapters in your Bible. For example, the plan's Joel 3 reading appears as Joel 4 in Bibles with four chapters in Joel; KJV Joel 2 also includes their short Joel 3 chapter.

Clicking the Done button will take you to the next day’s reading schedule. If there is no next day to read (you are up to date, or you marked an earlier day as done), Done takes you to the list of days instead of back to the Bible. Note: The Done button will only be enabled after pressing either the Speak or Passage buttons for each passage that is listed (Speak is available only on platforms that support speaking; there is also an All row with a Speak button for the whole day). Alternatively, you can tap the check next to each passage to enable the Done button (manually checking the check marks can be useful if you’re reading in a paper Bible).

Choose a reading plan Daily readings for one day of a plan List of the days in a plan

Abandon Reading Plan

Press the vertical 3-dot menu from the Reading Plan screen, and click Reset. You can also press and hold a plan in Choose a Reading Plan to reset it. Reset clears the saved start date and completion progress. The next time you select the same Reading Plan, a regular plan starts at day 1, even if you select it again immediately after resetting. A date-based plan opens at today's scheduled reading.

Switch Between Reading Plans

From the Reading Plan screen, tap the plan name in the title. This will open Choose a Reading Plan, where you can select a different reading plan. You can return to the original reading plan and your progress will remain where you left it. Back from the plan you chose returns to Choose a Reading Plan. In other words, it is possible to use several reading plans simultaneously.

Preview Reading Plans or Go To Specific Day

When in the Reading Plan screen, tap the day line (for example Day 3) below the plan name. You will see a list of daily readings. Clicking on a daily reading will bring you to Reading Plan screen for that specific day. Back from that day returns to the list of days. Only when you opened the Reading Plan screen directly from the menu does Back return to the Bible.

Changing Reading Plan Start Date

To set the start date of a reading plan, select the vertical 3-dot menu from the Reading Plan screen and click Set Start Date… to pick a specific start date. This item is not shown for plans that follow the calendar (date-based plans).

Set Specific Reading Plan Day to Today’s Date

This is useful if you started reading on a previous day and have just switched to AndBible. To update the current reading plan day to today’s date:

  1. Open the Reading Plan screen for the reading plan you would like to adjust
  2. Go to the specific day of the reading plan you want to set to today’s date.
  3. Click the top right 3-dot menu
  4. Click Set as current day…. After you confirm, the day you are viewing (for example Day 10) becomes the current day of the plan and all earlier days are marked as read.

Like Set Start Date…, this is not shown for date-based plans.

Custom Reading Plans

It is possible to create your own custom reading plan for use with AndBible.

Note

If you create a reading plan that you think would be useful for other AndBible users, feel free to share it in our Matrix or Telegram chat!

The .zip Reading Plan Format

For a sample reading plan in .zip format, please see this file. This is a complete reading plan file that is ready to be imported into AndBible. It can be imported using the Backup and Restore functionality in the main menu (☰), or from the top right vertical 3-dot menu in the Reading Plan screen.

The compressed zip folder contains two directories:

  • mods.d (Contains the .conf file)
  • modules (Contains the .properties file)

    • Note: The modules` directory often has a longer path of folders
    • leading to the .properties file. See the .conf file DataPath property below for an example.

Once you are done preparing the mods.d and modules folders, compress the 2 folders into a single .zip file. This zip file can then be imported to AndBible.

Hint

Use a simple text editor to create the file e.g. Notepad++ and do not use something like Word.

The .conf file

For a sample .conf file, please see this file.

This is the content of the Ninety days reading plan .conf file:

[NinetyDaysReadingPlan]
DataPath=./modules/texts/ztext/NinetyDaysReadingPlan/
Version=1.0
Description=Through the Bible in 90 days
ShortPromo=Challenge yourself and read through the entire Bible in 90 days
DistributionLicense=Public Domain
Category=And Bible
ModDrv=RawGenBook
Versification=KJV
AndBibleMinimumVersion=535
AndBibleProvidesReadingPlan=NinetyDaysReadingPlan.properties

A few notes about the contents of this file:

  • Category must be And Bible
  • ModDrv must be RawGenBook
  • The default Versification is always KJV, so this only needs to be provided if you want a versification other than KJV. For more about versification, see here.
  • AndBibleMinimumVersion must be 535 because that’s the version of AndBible when the zip format was first supported. Earlier versions of AndBible will use this to determine that this module is not supported.
  • AndBibleProvidesReadingPlan should be set to the file name that exists in the DataPath set at the start of the file.

Note

If your reading plan is date-based you will need to add the following line to the .conf file:

AndBibleReadingPlanDateBased=true

The .properties file

The .properties file is not imported on its own: Import reading plan… accepts only a module .zip as described above, with the .properties file inside it.

You will need to create a .properties file similar to the examples here The name of the file will be the name of the plan. The file extension must be .properties and you must place it a sub-directory under the modules directory. These will be translated to the current language when displayed in AndBible. The file must contain a series of rows in the following format:

1=Gen.1, Matt.1
2=Gen.2, Matt.2
3=Gen.3, Matt.3
4=Ps.119
5=1Cor.1, Jude

It is possible to skip days. For example, if you do not wish to have a reading on the weekend:

1=Gen.1, Matt.1
3=Gen.2, Matt.2

You can also add a date-based reading plan, which includes the month and day number for each day. The date-based plan will always open at today’s date by default (The regular plan opens the current day, which is the last day you haven’take yet completed). For a date-based plan, the .properties file must always begin the readings at 1=, and the date must be in the format of 3 letters for the month, then a dash and then a month day number followed by semicolon (;). For example:

1=Jan-1;Gen.1-2,Ps.1-2,Matt.1-2
2=Jan-2;Gen.3-4,Ps.3-5,Matt.3-4
3=Jan-3;Gen.5-6,Ps.6-8,Matt.5
...
146=May-26;Jos 12,Isa 16,2Tim 2
...
334=Nov-30;Est 7-8,Oba,Heb 3-5

As mentioned in the .conf file section, you must add the following line to the .conf file when using a date-based plan:

AndBibleReadingPlanDateBased=true

Example reading plans can be found here.

Note

OSIS format references and Bible book names must be used in reading plans.

A full list of OSIS book names can be found here.

Cloud Sync

Your reading plans and their progress can be synchronized across devices using cloud sync. Enable the Reading Plans toggle in the cloud sync settings. When a sync finishes, an open Reading Plan screen updates its completion ticks automatically. Resetting a plan on another device also clears it as the current plan on this device; choose a plan again to start reading.