Alimentor User Guide

Learn how to use Alimentor, the best child custody calendar app for iPhone, iPad and Mac.


If you have any questions about Alimentor, or want to learn how to achieve specific results, please email us at:

Let us know immediately when you experience difficulties of any kind or have an idea for improvement. We strongly rely on your feedback, so please contact us without delay and we will be happy to assist you.

Usage Tips

  • You can create 4 types of records: parenting time, calls, expenses and memos. Use the event type selector located above the calendar to choose what type of events you want to add or edit at the moment.
  • Use the “+” button or tap any day on the calendar to add a new record.
  • Each parenting time record can simultaneously store information about both the planned parenting time (custody schedule) and the actual time when your child was with you or another caregiver.
  • Minimize data entry effort by tracking visitation time only for one of the parents. There is no need to simultaneously track both parents time unless you want to be very precise and, for example, exclude from your calculations the time when your kids are at school. Generating parenting time report for one parent only should be sufficient in most cases when communicating with the other parent or your lawyer or court.
  • If you have more than one child with the same visitation schedule, create separate recurring records for each child to make it easy to enter exceptions. Otherwise, to log an exception for a single child, you would need to create a new record for that child and deassign that child from the occurrence of a recurring event.
  • To learn how you can prepare to plan your time with kids read this article ▶
  • Use the Setup button located in the Report View to set your reporting preferences. For everyday use, a short reporting period, usually a monthly or a 4-week period, is recommended.
  • You can exchange data with the other parent using built-in iCloud Sync sharing features.

Historical Data

  • Consider recreating your historical visitation schedule by defining recurring events that start in the past. Use the calendar view or the reminders list to switch the status of each historical event from „Planned” to „Actual”, at the same time adjusting the dates to reflect any deviations.
  • To import a visitation stored in your device calendar to Alimentor, open it using the calendar view in Alimentor and then select Import as Parenting Time.

Event Statuses

Depending on their status, events are shown in the two different views:

  • Planned events are shown in Reminders.
  • Actual and canceled events are shown in Diary.

Set the status of the event to canceled in order to log: no‑shows, withheld visitations, missed payments.


Bar Colors

Calendar bars can use colors assigned to caregivers or beneficiaries.
To choose your preferred setting:

  •  Mac   iPad  Use the Bar Colors setting located in Filters.
  • To change colors used in the report calendar modify the Breakdown by setting.
  •  iPhone  Calendar uses colors assigned to children/beneficiaries if you choose to display data for a caregiver. Likewise, when you choose to display data for a child, then color shown in the calendar will be read from the caregiver’s profile.

Integration With System Calendar

Alimentor calendar can display up-to-date content of your device calendar, showing daily events, holidays and visitations together.

To turn on access to system calendars in Alimentor:

  •  iOS  Turn on the Device Calendar switch displayed under the calendar.
  •  Mac  Click the System Calendars... button displayed on the left side of the main window.

Enabling access to system calendars does not affect any data stored in Alimentor database.

Custody Schedules

If you have recently separated from your spouse, consider reading the article about planning your time with kids ▶

To include an event in your custody schedule set its Scheduled attribute. This property is set automatically for planned, canceled and recurring events. In case of nonrecurring events:

  • clear the Scheduled attribute when logging unplanned parenting time,
  • set the Scheduled attribute for events that are part of your agreed schedule.
Scheduled Parenting Time

All scheduled events in the status Planned are displayed in Reminders.

Regular Schedule

You can create recurring events that repeat themselves:
  • weekly,
  • monthly,
  • yearly,
  • daily,
  • on selected weeks of the month.

You can create complex visitation schedules by using multiple recurring events.

For example, to define a 3-2-2 parenting plan, create 3 events, each repeating biweekly:

  1. Friday-Monday (3 n),
  2. Wednesday-Friday (2 n),
  3. Monday-Wednesday (2 n).
3-2-2 Visitation Schedule


To let you flexibly define holiday visitation schedule:

  • Parenting time records representing your regular schedule and holiday schedule can freely overlap. Timeshare and totals calculation algorithm takes it into account. This minimizes the need to alter your regular visitation schedule.
  • You can freely change the scheduled dates of individual occurrences of a recurring event and delete unwanted occurrences. Adjusting a single occurrence does not affect the remaining occurrences.

For holidays that occur on fixed dates you can consider creating recurring events that repeat every two years (minor adjustments might be necessary for observed holidays). For other holidays you can manually create the required parenting time records for one or two years ahead.

Schedule Adjustments

  • To enter individual deviations from your basic schedule (e.g. school holidays or vacations), use the calendar or navigate to Reminders and edit or delete chosen entries.
  • Changing the scheduled dates for a single occurrence of a recurring event does not affect the other occurrences. In addition to changing the planned dates, you can also edit the title and add notes e.g. containing an email confirming the agreed schedule change.
  • When you need to make permanent changes to your schedule, you can delimit existing recurring events and create new ones.
  • To quickly navigate to the initial instance of a recurring event in order to edit the repetition rule, e.g. to change the date when the repetition ends or to delete the rule altogether:
    •  iOS  Open any occurrence of the recurring event and tap the "i" button located in the Repeat row. Choose Edit Recurring Event when prompted. Tap the Repeat row and make any required changes.
    •  Mac  Open any occurrence of the recurring event and click the Tools toolbar button, select Show Recurring Event.

Actual Visitation Time vs. Schedule

Each parenting time record can simultaneously store information about both the planned parenting time (custody schedule) and the actual time when your child was with you or another caregiver. This allows Alimentor to detect and report deviations from your agreed schedule.

To store both time pairs (planned and actual), set the record status to Actual and make sure that the Scheduled switch is turned on.

For example, if a particular visitation was supposed to take place from March 25th to 27th (planned), but it was actually longer: 23rd - 28th, then it should be logged as follows:

Editing Visitation Record

Parenting Timeshare

The visitation timeshare (the percentage of time each parent has the child) is calculated as: Custody time duration / Reporting period duration * 100%.

You can change your reporting settings in order to calculate parenting timeshare for a custom period of time. To set your reporting preferences, including custom reporting period, use the Setup button located in the upper left corner of the Report View.


When tracking expenses, use the first field to indicate the payer and the second field (where you can select multiple persons) to enter beneficiaries (payees). If you track your own expenses, put your name in both fields.

You have three options for tracking reimbursements:

  • Track payments between parents: enter one parent as payer and the other one as payee.
  • Create two expense records - one for each parent (as payer).
  • Ask the other parent to use Alimentor and share his or her expense records with you.

In order to log unpaid, scheduled (agreed) expenses, use the status Canceled.

You can export all Alimentor data records to a spreadsheet file in order to perform some advanced calculations or to create charts. To generate a file in .xlsx format:

  •  iOS  Navigate to Settings and tap Export to Spreadsheet.
  •  Mac  Choose File > Export as Spreadsheet... from the menu bar in Alimentor.

Call History

Use record type Call for logging parent‑child call history (date, time, duration).

The title field can be used to store the call type, for example: FaceTime, Phone Call.

 iOS  If you add contact details to your child’s profile, they will be displayed in the event editor (for call records) to let you quickly initiate a call. When the call is ended, the call date and duration fields will be automatically updated.

Documenting Conversations

 Mac  To copy iMessage or SMS conversations to Alimentor using your Mac, make sure to enable Messages in iCloud, launch Messages and display the conversion that you want to copy, then use one of the following options:

  • Copying as text: Press and hold ⇧Shift, then click on the first and the last message that you want to copy. Next choose Edit > Copy from the menu bar in Messages (⌘+C). Switch to Alimentor, start editing the selected event and navigate to the notes field. Paste the copied text by choosing Edit > Paste from the menu bar (⌘+V).
  • Copying as PDF: Select File > Print… from the menu bar in Messages. Click the PDF button and select Save as PDF. Choose a file location and click Save. Switch to Alimentor and start editing the selected event. Click the Add PDF Documents button and select the previously saved file.
  • Copying as image: Take a screenshot of the Messages app window using the Screenshot app (⇧+⌘+4) and then add it to the selected Alimentor record as image.

 iOS  To document iMessage or SMS conversations in Alimentor for iOS, launch Messages from your Home screen, scroll to the relevant part of the conversation and use one of the following options:

  • Copying as image: To take a screenshot on your iPhone or iPad press the side button and the volume up button at the same time, then quickly release both buttons. After you take a screenshot, a thumbnail temporarily appears in the lower‑left corner of your screen. Tap the thumbnail to open it, then tap the Share button located in the upper right corner and select Copy from the list of available options. Switch to Alimentor and start editing the selected event. Tap Add Photos and select Copy from Clipboard.
  • Copying as text: Tap and hold the message that you want to copy. Tap Copy. Switch to Alimentor and start editing the selected event. Tap Add Notes and paste the copied message.

Documenting E‑Mail Correspondence

E‑mail correspondence can be stored in Alimentor as PDF documents.

 Mac  On your Mac:
  1. Open Mail and select the message(s) you want to export.
  2. Next choose File > Export as PDF... from the menu bar.
  3. Choose a file location and click Save.
  4. Switch to Alimentor and start editing the selected event.
  5. Click the Add PDF Documents button and select the previously saved file.

 iOS  On your iPhone or iPad:
  1. Open Mail and tap the message you want to export.
  2. Tap the action button. The action button looks like a reply arrow (it's also used to reply to or forward email messages).
  3. Tap Print to open the printer options.
  4. Pinch open the thumbnail image of your email. The Printer Options will be replaced with the PDF version of your email message.
  5. Tap the Share button in the upper right corner of the screen.
  6. Tap Copy.
  7. Switch to Alimentor and start editing the selected event.
  8. Tap Add PDF Documents and select Copy from Clipboard.


To start editing reporting settings tap the Setup button located in the upper left corner of the Report View.

Report length is limited to 200 pages.

Color legend and formatting:

  • Black color - represents actual values.
  • Gray color - represents scheduled values.
  • Scheduled and actual values are presented in separate tables.
  • Available layouts: Actual vs. Schedule, Actual, Schedule.

If you are preparing Alimentor report(s) for your lawyer or court, you can use almost any popular PDF reader on your PC or Mac to add extra annotations to your documents. If you are using a Mac, you can use Preview to annotate a PDF on Mac.

iCloud Sync

Syncing Data Across Your Devices

Alimentor uses Apple's CloudKit, part of iCloud, to sync and backup your data and therefore you do not need a separate account/login process.

With iCloud Sync, your data is seamlessly pushed across all of your devices (that use the same Apple ID). iCloud is a service running in the background on your device and updates may take a few seconds or several minutes to appear on other devices.

To turn on iCloud Sync:

  •  iOS  Navigate to Settings, select iCloud Sync and tap Turn On iCloud Sync.
  •  Mac  Choose Preferences... from the menu bar. Select the iCloud Sync tab, click Turn On iCloud Sync.


  • If you are syncing large amount of data for the first time, please let the initial upload to come to an end, then allow a few minutes for Apple servers to index freshly uploaded data before turning on iCloud Sync on the secondary device(s).
  • If you have used iCloud Sync before and are turning it back on, please be aware that Alimentor data records stored on your device will be merged with the records stored in iCloud.

Sharing Data With Other Alimentor Users

How it works:

  • You can invite one or more users to access your data.
  • Data is always shared in a read-only mode, your records cannot be changed or deleted by someone else.
  • Users can mutually share data by creating and exchanging invitations with access rights.
  • If somebody shares with you data for a person that has the same nickname as the one that you have already used, then Alimentor will link both person's profiles and display the combined data.
  • If you do not want to sync data shared by another user, you can disable the obtained access rights. Previously downloaded data records will be removed from your device(s).
  • You can always revoke already granted access rights. Shared data will be removed from the other user's device(s).

To let another Alimentor user access your data:

  •  iOS  Open Alimentor and navigate to Settings > iCloud Sync, then tap Manage Access to My Data. Tap Add People, choose how you would like to send your invitation, select recipients and send the invitation link.
  •  Mac  Click the Sharing button located in the toolbar above the calendar. Click Add People, choose how you would like to send your invitation, select recipients and send the invitation link.

To accept an invitation that you have received from another user:

  1. Tap the authentication link that you have received to open it in Alimentor.
  2. Confirm that you want to open "Alimentor 2 Database" shared by another user.
  3. Wait for the shared data to be completely downloaded.


To display or change your Apple ID and iCloud storage settings:

  •  iOS  Open the Settings app, tap [your name]. Tap iCloud, then scroll down and find "Alimentor 2".
  •  Mac  Go to System Preferences, click iCloud. Make sure that iCloud Drive is turned on. Next to iCloud Drive, click Options and find "Alimentor".

Backup and Restore

iCloud Sync

When iCloud Sync is enabled, Alimentor maintains a copy of your data in iCloud and all changes are automatically backed up. It is highly recommended to backup your records, otherwise you risk loosing your data when your device is lost or broken.

To manually enable iCloud Sync:

  •  iOS  Navigate to Settings, select iCloud Sync and tap Turn On iCloud Sync.
  •  Mac  Choose Preferences... from the menu bar. Select the iCloud Sync tab, click Turn On iCloud Sync.

Last Resort Option

 iOS  If you have lost your iPhone/iPad or it has been damaged or reset and you did not use iCloud Sync to backup your data, then you can refer to this Apple Support article about restoring you device from a backup

Data Deletion

To delete all your data (this operation is irreversible):

  •  iOS  Navigate to Settings. Select iCloud Sync if syncing is enabled, otherwise choose Device Data. Tap Delete Data and confirm.
  •  Mac  Choose Preferences... from the menu bar. Select the Database tab. Click Delete My Data.

Preparing for Court

The following tips can help you when preparing for court:

  • Tag your records with the “best interests” factors, then generate the “Best Interests of the Child” chapter of the report. Give this document to your attorney in order to minimize the time needed to prepare a legal brief.
  • You can use almost any popular PDF reader on your PC or Mac to add extra annotations to the final version of your report. If you are using a Mac, you can use Preview to annotate a PDF on Mac.
  • The search functionality located in Diary will help you quickly look up records containing specific notes and titles.
  • You can export all Alimentor data records to a spreadsheet file in order to perform some advanced calculations or to create charts. To generate a file in .xlsx format:
    •  iOS  Navigate to Settings and tap Export to Spreadsheet.
    •  Mac  Choose File > Export as Spreadsheet... from the menu bar in Alimentor.
  • If you had been regularly sending Alimentor reports to the other parent (e.g. using email) in the past, consider using that fact to prove that the other parent was aware of the actual situation (time, expenses, etc.)

What is New in  Alimentor 2 

Alimentor 2 is offered as a separate app to give the users of the older version a choice whenever they prefer to stay with the existing solution or migrate to the new release.

PDF attachments, scans and photos

  • Multiple PDF documents, scans and photos can be added to a single data record (up to 5 MB).
  •  iOS  Built-in document scanner. v. 2.2.3 (iOS 13)
  • Generated reports can contain attached PDF documents.

Enhanced Reports

  • User selectable layouts: Actual, Scheduled, Actual vs. Scheduled.
  • Scheduled and actual parenting time can be output in the same calendar.
  • Calendars now display event titles and can contain events from selected device calendars.
  • The expense summary chapter shows the total expenses grouped by title. v. 2.1.3
  • Payments between caregivers can be reported as a negative cost for the caregiver who is assigned as the payee. v. 2.1.3
  • New report chapter “Best Interests of the Child” listing records tagged with "best interests" factors. v. 2.1.6
  • Check sample report and spreadsheet.

Refined User Interface

  • New record type “Call” for logging parent‑child call history. v. 2.1.7
  • Dark mode support. v. 2.2.3 (iOS 13)
  •  Mac  New event editor tools: Duplicate, Show Recurring Event.  v. 2.2.9 
  • Parenting time records for the same caregiver and child can overlap.
  • Enhanced settings for creating recurring events, including the option to set the first day of the week for events that repeat on selected weeks of the month.
  •  iOS  Expiring recurring events are now easily accessible from the Home View. v. 2.1.4
  • Application icon badge can display the number of pending events. v. 2.1.5
  • Simplified database sharing functionality based on standard user interface.
  • Shared codebase for iOS and macOS.
  • Data import from Alimentor 1.

Data migration

Alimentor 2 for iOS and Alimentor 1 for iOS are two separate apps. When Alimentor 2 is installed on a device where Alimentor 1 is already present, it will offer an option to import a copy of the existing data from Alimentor 1. You will be able to keep using Alimentor 1 without changes if needed.

Download and Installation

Alimentor 2 for iOS

Download on the App Store.

Alimentor 2 for Mac

Download on the Mac App Store.

Get access to the pre‑release version of the desktop application for free. The Mac app is fully compatible with Alimentor 2 for iOS and syncs data with it. We invite you to try it out and share your feedback with us.

Download for Mac

Installation: Open the downloaded archive and move the “Alimentor” file to the “Applications” folder.