iPhemeris Astrology Software for Mac OSX

By Clifford Ribaudo
iPhemeris ® © 2008-2018 Clifford Ribaudo. All rights reserved.

OSX Introduction


Midnight GMT positions are derived from the Jet Propulsion Laboratories (JPL) DE431 ephemerides and the US Naval Observatory equivalent for Asteroids. These are stored in a binary database of our own devising. From that database positions for other times are interpolated using algorithms specified by Jean Meeus. Sidereal positions are derived by adjusting Tropical positions for the selected Ayanamsa.

If you've purchased the Extended Ephemeris (via In-App purchase) coverage is 5000 years (2500 BC to 2500 AD) otherwise coverage is 1700 to 2100. The data range applies to all iPhemeris features.

iPhemeris uses New Style Gregorian Calendar dates starting October 15, 1582 and Julian dates or Old Style prior. However, be aware that various locales adopted the Gregorian calendar at other times; for example, Great Britain didn't switch until September 1752. Therefore, adjust your dates accordingly.

And when using the Extended Ephemeris, enter new style dates after Oct. 15, 1582 and old style dates prior. Currently iPhemeris does not support proleptic Gregorian dates for dates prior to 1582.

Top ▲

Getting Support

Before contacting support, please make a thorough review of the documentation. Most questions that we get are already answered here. When contacting support:

Please Do

  • Provide as much information as possible about the issue, including
    • The version of macOS being used (see the Apple About menu).
    • The version iPhemeris being used (see the iPhemeris About Menu).
  • When asking questions about charts, please provide the following:
    • Date, time, place and type of horoscope you are asking about (it's best to send a screen shot of the chart).
    • What the exact nature of the problem you are seeing is.
    • If you are getting a chart with an ascendant/mc that you don't recognize, please first review the help documentation on time zones. Wrong time zones are the most frequent cause of erroneous charts.
  • Screen shots illustrating the issue are always helpful.

Please Do Not
Post bad or negative reviews. This is not effective as we can take weeks to notice things mentioned in the App Store and when we do it mainly just annoys us 🙂 We are very responsive to email and will respond within hours or minutes even, and will do our utmost to get things sorted ASAP!

To get support, please contact us via email at: iPhemeris Support

Top ▲

OSX Preferences

Ephemeris Preferences

iPhemeris is a powerful tool that provides a Tropical or Sidereal Ephemeris with Declination & Latitude tables and Astrological Calendars for any time and time zone in the world. Simply by adjusting a few of these settings, iPhemeris can display a standard Midnight or Noon GMT Ephemeris or something more customized to specific needs, for example positions at the time of the New York Stock Market Open.

Ephemeris Type

  • Tropical or Sidereal setting applies to all iPhemeris features throughout the software.
  • When Sidereal is selected, the Ayanamsa settings are enabled.
  • If you're not familiar with the difference between Tropical & Sidereal, use Tropical.


  • In Sidereal mode, the pre-defined and custom ayanamsa fields are enabled.
  • Ayanamsa - Select a pre-defined Ayanamsa, or choose "Your Ayanamsa" at the bottom to set your own.
  • Your Ayanamsa - To use your own value:
    • Select Your Ayanamsa in the Ayanamsa list.
    • Enter your custom value in the box below. Use a value for the Epoch Jan 1, 2000. iPhemeris will interpolate the correct value for other dates.
    • To calculate the correct value: ValueNow - ((CurrentYear - 2000) * 0.01396887831940)
  • In Sidereal mode all positions for all features throughout the App are adjusted accordingly.

Note: The degree offset from Tropical positions for pre-defined Ayanamsa are listed at the end of this documentation. Values shown are for the Epoch starting Jan. 1 2000. iPhemeris adjusts those to the date of the Chart or Table being used. It does this using the mean rate of annual precession (0.01396887831940 degrees per year).

Time Zone
This setting is used by the Ephemeris, Declination/Latitude, and Calendar displays and causes those features to display values for the selected Time Zone at the selected Ephemeris Hour.

  • It uses standard Time Zone notation. Locations West of Greenwich are negative (-) and East are positive (+).
  • This setting does not auto adjust for Summer Time.

Example: For Ephemeris Tables and Calendars which display values at the time of the New York Stock Market open, set the Time Zone to -5:00 and the Ephemeris Hour to 9:30.


Ephemeris Hour - Sets the hour in the the selected Time Zone. For example, a Time Zone set to UTC (GMT) 00:00 with Ephemeris Hour set to 12, displays Noon GMT Ephemerides and Calendars.

Lunar Nodes - Sets the type of Lunar Node: True or Mean for all features.

Top ▲

Symbols & Calculation Preferences

Global settings for symbols displayed and calculations used by all features throughout iPhemeris.

Select the glyph used to represent Pluto and Eris. This applies to all software features throughout the application.


Part of Fortune
Sets the calculation used by all features. Most ancient authorities advocated using a different algorithm for day and night births. However, due to a mis-translation of Ptolemy's writings many Astrologers commonly believe he advocated using the same formula for day and night births. Recent translations make it clear he did not. It's your choice, iPhemeris offers both:

  • Different for Day and Night Births (default):
    • Part of Fortune for Day Birth = Ascendant + Moon - Sun.
    • Part of Fortune for Night Birth = Ascendant + Sun - Moon.
  • Same for Day or Night Births: Part of Fortune = Ascendant + Moon - Sun.


Choose the first day of the week for Aspect & Transit Calendars: Sunday or Monday.


Use this setting to force iPhemeris to use one of the supported translations and override your system language settings.

We do use translation services, but Astrology is a special discipline and many astrological terms have dual meanings. If you are willing to help us improve the iPhemeris translations, contact support and we can provide promo codes for In-App purchased features.

Top ▲

Color Preferences

iPhemeris uses pre-defined color themes. We offer have created a variety of themes that work well on displays and for black and white and color printing and which use generally accepted colors for various astrological elements and points. You may select a color theme for each of the iPhemeris feature tabs:

  • Ephemeris Tab & Declination/Latitude Tab - they share the same color theme.
  • Aspect Calendar & Transit Calendar - they share the same theme.
  • Sky Now
  • Charts (Horoscope wheel and Reports)
  • Graphic Ephemeris

Top ▲

iCloud Preferences

When iCloud is enabled, iPhemeris stores your astrological chart data in iCloud. This allows all your devices (Mac and iOS) to share your horoscope data. A horoscope added or edited on one device will automatically be added to or updated on all devices. Using iCloud saves time and provides secure backup so that you do not lose them.

iPhemeris astrological chart storage takes up very little space and it is well worth doing. We strongly recommend using iCloud to backup and store your iPhemeris data.

To enable it:

  1. Click Yes.
  2. Follow all prompts.
  3. If you are asked to sign into iCloud, please use the same account you use with iPhemeris on your other devices.
  4. Proceed to macOS System Preferences >iCloud >  iCloud Drive > Options and allow iPhemeris to use iCloud Drive (scroll down in the list if you do not see it).

Once iCloud is properly enabled astrological charts from other devices (macOS or iOS) using iPhemeris will start to appear. This may take a few minutes. If you do not see them, wait 5 minutes then restart iPhemeris.


Trouble Shooting

Please double check the following:

  • Check that iCloud is enabled AND also that you have allowed iPhemeris to use iCloud Drive in macOS System Preferences.
  • If you can't save charts we have occasional seen users who have enabled iCloud but not iCloud Drive. Or, they did not want to use iCloud, but had it on in iPhemeris Preferences by accident.

Top ▲

Printing Preferences

These set the defaults used when printing from the various iPhemeris feature windows. Set the options you think you will use most often when printing. At the time you print an actual Chart and its associated reports, you will be given an option to temporarily change an option.

Applies to all Features

  • Print Only In Black & White - Disables color printing throughout iPhemeris. This improves readability for Black & White printers and saves costly ink and toner.

Applies to Astrological Chart Reports & Sky Now

  • Print Grid - enable / disable default printing the Synastry Grid (at print time you have the option to temporarily change it).
  • Print Aspects - enable / disable default printing the Aspect Report (at print time you have the option to temporarily change it).
  • Print Points - enable / disable default printing the Points Report (at print time you have the option to temporarily change it).
  • Print Midpoints - enable / disable default printing the Midpoints Report (at print time you have the option to temporarily change it).
  • Print Graphic Ephemeris - enable / disable default printing of the Graphic Ephemeris Report for a Horoscope wheel (at print time you have the option to temporarily change it).

Top ▲

Function Toolbar Preferences

Arrange which functions appear and in what order on the iPhemeris function Tab Bar (across the top of the main application window). Restart iPhemeris to see your changes.


Using this Preference you can have multiple instances of the Chart window or other feature if required.

Top ▲

OSX Ephemeris

OSX Ephemeris

iPhemeris is a powerful tool that provides a Tropical or Sidereal Ephemeris, Declination tables and Astrological Calendars for any location and time at that location around the world. Simply by adjusting a few settings in Ephemeris Preferences you can have a standard Midnight or Noon GMT Ephemeris or any other time and time zone e.g., the Open of the New York Stock Market.


  • Ephemeris tables display a full month of: planetary, asteroid, lunar phases, lunar ingress, moon "void of course" times and eclipse data.
  • Positions are Tropical or Sidereal as per Ephemeris Preference settings.
  • Data is grouped into weeks, with weeks starting on Sunday.
  • The date column shows day and day of the week.
  • The GST column displays Greenwich Sidereal Time.
  • Two Moon positions are included:
    • This first displays the Lunar position at Ephemeris Time Zone and Hour as set in Preferences.
    • The second displays its position 12 hours later.
  • Columns for the individual planets and bodies can be turned on or off in the side bar.
  • The display of Planetary longitude data is in Degrees, Minutes and Seconds order and is read as follows:

11 ! 45" R = 11°, 9 minutes, 45 seconds of Aries. The Planet is Retrograde.


  • The Print button prints the currently displayed month.
  • The Disclosure button shows or hides the sidebar.
  • Left / Right arrow keys page back or forward by month.
  • The Date entry field can be used to jump to a specific date.
    • If you purchased the Extended Ephemeris, clicking AD/BC toggles between dates before or after AD year 1.
    • There is no year 0.
    • When looking at pages for months prior to year 1 the title also displays the year in the Julian (Astronomical) Calendar which does have a year 0.
    • The Julian astronomical date for the 1st day of the month is included in the page title.
  • The Today button always returns to the current day and month.
  • The Text Size buttons increase and decrease the text.
  • Click a row to highlight it, click again to un-highlight.

Top ▲

OSX Declination & Latitude

iPhemeris is a powerful tool that provides Tropical or Sidereal declination tables for any location and time at that location around the world.


  • The Declination and Latitude tables provide two columns for each body.
  • All buttons and navigation behave exactly the same as the Ephemeris feature.
  • Displayed values are read as follows:

25 n 28' 59" = 25 degrees North, 28 minutes, 59 seconds.

Top ▲

Void of Course Moon Tables

Void of Course Moon tables display in the lower left of the Ephemeris and Declination / Latitude displays. The table is included with the Mac Version of iPhemeris, and is available as an In-App Purchase on iOS.

Void of Course Moon
Last Aspect Columns

  • Time Columns - the first 2 or 3 columns show the date and time of the event. There will be 3 columns when GMT, the Ephemeris Time Zone and Local time are not the same, other wise only two.
  • Last Aspect Column - Show the last planet to aspect the moon and the aspect it made.

Lunar Ingress Columns

  • Sign Column - Shows the next sign the moon entered (after the last aspect to its left).
  • Time Columns - 2 or 3 columns listing the time of the ingress event. As above there are 3 columns when GMT, Ephemeris Time Zone and Local time are not the same, other wise two.

The Void of Course period is the time between last aspect and the moon's entrance into the next sign (Lunar Ingress).

Top ▲

OSX Graphic Ephemeris

OSX Graphic Ephemeris

The Graphic Ephemeris can be added to the Mac version of iPhemeris with a one-time In-App Purchase. The Graphic Ephemeris feature adds the following capabilities:

  • A new tab on the main view allowing display of planetary longitude and declination.
  • A new Graphic Ephemeris Report in the Report section of charts that overlay's the currently displayed astrological chart data.

The feature will be added in the last tab position but it can be moved anywhere from the Function Toolbar tab of iPhemeris Preferences.


When longitude is selected, standard zodiacal positions for bodies selected in the disclosure panel on the left are drawn for the time period set in the start and end date fields in the tool bar above the graph.



If you are not familiar with the display of a graphical ephemeris, it might help to understand for example, that bodies are in Aries when shown on the graph between 0° and 30° and they are in Pisces when between 330° and 360°.

Planets are conjunct where lines cross and they are in aspect to each other when they are separated vertically by the degrees of that particular aspect. For example, if the Sun is on the horizontal line labeled 30° (Aries/Taurus cusp) and Venus is on the horizontal line labeled 90° (Gemini/Cancer cusp) they are separated by 60° and are sextile on that date.

When Moon Phase is selected in the planet selector, New and Full Moon are displayed. New moon is shown where sun and moon lines cross and full moon where they are 180° apart.



To see standard Astrological notation for any body currently displayed on the graph:

  • Open the sidebar at the left (square button in upper left corner of Graphic Ephemeris view).
  • Click select the magnifying glass button on the panel (if not already blue).
  • Click the mouse anywhere on the graph and the astrological positions for the date wherever the mouse is moved are displayed.



Using the harmonic range selector to the right of the Use button, it is possible to look for aspects by folding the graph over on itself for the selected range. If you are not familiar with how this works, best to leave it set at 360°.

For example, if a range of 90 is set then the vertical scale is restricted to a range of 90° and things at 0°, 90°, 180° and 270° are all displayed at the 0° position and appear to be conjunct. This makes it easy to spot angles for the selected harmonic.

Harmonic ranges can only be used on the longitude display and are disabled when showing declination.




When the Declination button is selected in the toolbar at the top of the Graphic Ephemeris window declination of any planet or body selected in the sidebar is shown. Declination for most bodies is between -30° (south) and 30° (north) degrees of latitude.

Use of harmonic ranges does not make sense for declination and therefore the range selector is disabled.

Top ▲

OSX Graphic Ephemeris Chart Report


When enabled, the Graphic Ephemeris Chart Report shows up as a new tab in the Reports section of Charts and Sky Now. For full details on how it works see the previous section:

  • Click the Search Button to display a pop up window showing data under the mouse.
  • Select a date range to display.
  • Harmonic ranges are shown using the degree entry field to the right of the Use button.
  • Declination data is not available in the Charts or Sky Now Reports view.
  • When a Horoscope is being displayed, the positions of the first chart (inner most wheel) are overlaid on the Graphic Ephemeris. These positions are shown as horizontal dashed lines.

Top ▲

OSX Calendars

OSX Aspect Calendar

iPhemeris offers a powerful Calendar style Aspectarian that can display Tropical or Sidereal positions for any location and time around the world. An Aspectarian shows the relationship between bodies in the sky on a particular date, e.g. the Sun relative to Saturn on a day.


    • It uses a calendar like format.
    • The displayJ0.0*@ R1.0*is read: Sun at 0.0° Capricorn, conjunct Uranus at 1.0° of Capricorn.
    • Planets & Asteroids shown on the Aspectarian can be turned On or Off in the sidebar.
    • Orbs for Aspects can be adjusted from the left sidebar. Open it and click the button with the I F symbol. Fractional Orbs are allowed.
    • Sidebar settings for Planets and Orbs are saved and only apply on the Aspect Calendar, i.e. no other iPhemeris feature shares these settings.


  • The Disclosure button shows or hides the sidebar.
  • The Date field jumps to the specified month and year. Years must be 4 digit (YYYY).
  • Left / Right Arrow buttons page back and forward by months.
  • The Today button always returns to the current month.
  • The Print button prints the month currently showing.
  • The Text Size buttons increase or decreases calendar text.

Top ▲

OSX Transit Calendar

iPhemeris offers a powerful monthly Transit Calendar that displays transits between things in the sky and any Chart (the Radix) in your Astrological Chart database. Positions are either Tropical or Sidereal as per iPhemeris Preferences.

The first time used it prompts for a Radix Chart, select one from the list of existing Charts. If none exist yet, return here later after you've created the one you want to use.


  • The column to the left of the aspect glyph displays the position of things in the sky on that date.
  • The column to the right of the aspect glyph shows the position of aspected bodies in the Radix Chart.
  • The displayJ0.0*@R1.0* is read as Transiting Sun at 0.0° Capricorn, conjunct natal Uranus at 1.0° Capricorn.
  • Bodies and Points can be individually toggled for things in the Sky and the Radix from the left sidebar:
      • PR Button (left most) - Toggles things in the Sky.
      • Middle Button - Toggles things for the Radix Chart.
      • IF Button (right most) - Sets Orbs.
  • Use the Edit button in the toolbar to select a different Radix Chart.
  • Sidebar settings for Bodies, Points and Orbs are remembered and only apply to the Transit Calendar. i.e. no other iPhemeris feature shares these settings.


  • The Disclosure button shows or hides the sidebar.
  • The Date field jumps to the specified month and year.
  • Left / Right Arrow buttons page back and forward by months.
  • The Today button always returns to the current month.
  • The Edit button displays your saved charts. Select one to change the Radix chart.
  • The Print button prints the month currently showing.
  • The Text Size buttons increase or decreases calendar text.

Top ▲

OSX Charts

OSX Sky Now

Sky Now displays a continuously updating Chart of the Sky using the House System and Location specified in Preferences.


  • The display updates once per second.
  • Use the disclosure button in the toolbar show or hide the left sidebar.
    • Turn On or Off display of Planets and other Points from the left sidebar.
    • Adjust Orbs for aspects (or turn them off completely) in the left sidebar.
    • Sidebar settings are remembered and apply to Sky Now only.
  • Use the Settings button (gear) to configure the Appearance of the Sky Now wheel (colors, style, etc).
  • Adjust time steps using the drop down.
  • Time step the chart using arrows:
    • Real-time updates are turned off once time-stepping has been started.
    • Use the button with the red line to resume real-time updating.
  • Drag the divider between the chart and the reports section tor re-size.

Top ▲

Sky Now Settings

SkyNow wheel styles and other settings are accessed via the Gear button in the Sky Now Toolbar.


House System - Sets the House System used by the Sky Now chart.

Chart Wheel Styles:

  • These work the same as Chart Wheel Styles for Charts. See Chart Preferences section.

Location - Sets the location used by the Sky Now chart. Enter location data using any of the following techniques:

  • Enter latitude / longitude values manually.
  • Search for a place name or address.
  • Scroll around the Map.

Top ▲

OSX Charts Usage

Chart creating, editing and viewing is done from the Charts tab. The interface is simple and after familiarizing yourself with a few buttons you should be able to get around quickly and easily.

Navigation (Left to Right)

  • Sidebar Disclosure Button - Show / Hide left sidebar.
    • Select Displayed Bodies & Points: Left checkbox toggles points displayed on the wheel. The Right checkbox toggles points included in reports.
    • Orbs:
      • Set orbs for Applying / Separating independently.
      • Fractional Orbs are allowed.
      • Set a value of 0 to disable an Applying or Separating Orb (you can show only the applying aspect if you wish).
      • Be sure orbs don't overlap for aspects that are close (e.g. 45 and 51 degree aspects) else only the first will be show. In this case you would need to use an orb of less than 6 degrees.
  • Chart List - To display your saved charts, click the button with the Chart icon to show / hide the list. When you allow iPhemeris to store charts in iCloud (iPhemeris Preferences) all charts stored in iCloud by any version of iPhemeris (iOS or Mac) will be available.
    • Add a Chart: Tap the '+' button.
    • Copy a Chart: Copy the selected chart. Only works when 1 chart is selected.
    • Edit a Chart: Select a chart in the list:
      • Make sure only one is selected (a blue check mark appears on the left of the currently selected chart(s)).
      • Click the Edit button. If the button is not blue it means no chart is selected or more than one is selected.
      • Make your edits in the dialog that appears.
    • Clear Selected: Clears selected charts and stops displaying. Useful when selection is hidden by search filter or off screen.
    • Delete a Chart: Select a chart in the list (only one), click the Trash button.
    • Search/Filter: Search charts by Name or Categories. If you've added category tags to any of your charts, for example President, you can filter the list to only show charts "tagged" with the word President.
  • Chart Style Settings - Click the gear button. See below for details.
  • Show Charts Dropdown - Depending on the number of charts selected (1, 2 or 3) the drop down displays relevant display options. E.g. Currently selected chart with an additional chart for "Now" as a bi-wheel, or a composite of 2 selected charts, etc.
  • Chart Notes: Add or edit written notes for the charts currently being displayed. Notes are saved as part of the chart data and sync via iCloud (when enabled) to all devices.
  • Chart Rectification - 
    • Use the drop down to select a period to time step charts.
    • Use the Arrow buttons to advance the respective chart forward or back the selected amount of time.
  • Text Size (A/A) - Adjusts the size of text show in the aspect reports view.
  • Print Button - Print the currently displayed charts and their respective reports.
  • Adjust Size of Chart Relative to Aspect Grid: Drag the divider between the wheel and the Aspect grid.

Draw 1 Chart

  • Click the row of the chart to draw.
  • Select a Chart Type from the dropdown in the Toolbar.

Draw 2 Charts (Bi-Wheel)

  • Click any two charts in the list (first is on inner wheel, second on the outer).
  • Make sure only two charts are selected, or de-select unwanted charts.
  • Select 2 Charts in the drop-down in the toolbar.

Draw 3 Charts (Tri-Wheel)

  • Select any 3 charts in your list.
  • Select 3 Charts in the drop-down above the chart display.

Draw Composite Chart

  • Select two Charts.
  • Select "Composite" in the dropdown in the toolbar.

Draw 2 Charts (Bi-Wheel) - Natal and Relocated, Progressed or Solar Return

  • If you've not already done so, make a Copy of the natal chart.
  • Find the copy in your list of charts. Edit the copy and add the Relocated, Progressed or Solar Return data. We recommend making one copy for each additional Relocated, Progressed or Solar Return horoscope associated with a Natal horoscope.
  • Select the Natal horoscope in the list.
  • Select the Relocated, Progressed or Solar Return in the list.

Draw 2 Horoscopes With Composite (Tri-Wheel) - 2 Natal charts with Composite

  • Select 2 Natal horoscopes in your list.
  • Select "2 Charts +Composite" in chart type dropdown in the toolbar.


Adding & Editing Charts


Time Zone lookup works best when data is entered in the dialog in the orders the fields are presented (start at the top and work down).

  • Date and Time - This is required.
  • Location - To enter Latitude and Longitude, click the Edit button next to those fields. The Map view will drop down. The Map allows manual entry of latitude and longitude, search for locations by name, and drag and zoom to find locations. The position under the cross-hair is used and is more precise depending on the degree to which the map is zoomed.
  • Time Zone
    • After date, time and place have been entered, use the Find Time Zone button to look it up.
    • Alternatively, you can enter it manually. iPhemeris uses standard time-zone notation, e.g. time zones west of GMT are negative (-) and east (+).
    • Local Mean Time - Calculates a time zone from the chart longitude. This is for researchers and should only be used by those who understand how and when to use it.
  • Note - The Map and Time Zone lookup require Internet access.
  • House System: Select a house system to use for the chart. This setting overrides whatever you set as the default for this chart only.
  • Categories: Add any words to categorize your charts. These can be used in the chart list to search, filter and group your charts.
  • Notes: Add and edit notes about the chart.


Relocated, Progressed & Solar Return Horoscopes

The fastest (and recommended) way to create Relocated, Progressed and Solar or Lunar return charts is to make a copy of the respective natal chart. Select one in your chart list and use the copy button, then find the copy and edit to add Relocated, Progressed or Solar Return settings. Copies makes it possible to compare them in bi-wheels or tri-wheels to each other.

Relocated Chart
Relocation Charts require additional information. After You've entered Natal or Event information, check the Relocated box to enter Relocation data.


  • Location (required) - Provide latitude and longitude using the Map view. Use the Edit button to display the Map view.
  • Place Name (optional) - Location search from the Map sets this automatically, you can manually enter and edit it.


Progressed Charts
Progressed Charts require additional information. After you've entered Natal or Event information, check the Progressed box to add Progression data.


  • Select Progress to Now if you wish the chart to always be progressed to the current date and time.
  • Or de-select Progress to Now, to set a specific Date and Time.
  • Either Progress to Now or a Date and Time are required.
  • Choose a Planet and Cusp progression styles.
  • Charts can be both Relocated and Progressed.

Solar & Lunar Return Charts

Solar and Lunar Return horoscopes require additional information. After You've entered Natal or Event information, check the Solar / Lunar Return box.

Solar Return

  • Year - Enter a year for the solar return. Must be 4 digits. Click AD/BC to toggle (on available with extended ephemeris option).
  • Location (required) - Set the place where the subject was on the Date & Time of the Solar Return.
    • Edit - displays the map and allows location search.
    • Use Natal - When the subject was at the same location as for the natal chart, this sets the Solar Return location with that data.
  • Place Name (optional) - set by the Map tool and can be edited. This is not location lookup. Use the map map for location lookup.
  • Time Zone:
    • After datetime and place have been entered, use the Find Time Zone button to look it up.
    • Or, enter time zone manually. iPhemeris uses standard time zone notation.
    • Local Mean Time - Calculates a time zone from the chart longitude. This is for researchers and should only be used by those who understand how and when to use it.
  • Solar Return charts cannot also be Relocated or Progressed.

Lunar Return

The data required to cast Lunar Return charts is essentially the same as for Solar Returns. To create one:

  • Select the Lunar Return button on the Solar / Lunar Return panel.
  • Enter a date near the date you want a Lunar Return chart for.
  • Use the Previous and Next buttons to find Lunar Returns after, or previous to that date.
  • Continued clicking of next/previous buttons steps back and forward through all lunar returns for the charts natal moon location.

NOTE: If the chart type does not remain selected after leaving the Edit Chart dialog, it is because iPhemeris did not find all the data needed to display that type of chart. Please check that you have entered all required information.

Top ▲

Chart Settings


House System - The default house system when creating charts. Changing this does not change the house system used by charts already created. Edit a specific chart to change its house system, or make a copy and have one with each.

Use 24 Hour Time - Forces time entry and time display to use 24 hour style. This over-rides time entry / display styles that are determined by your Mac System Settings for date and time in your country.

Progression Defaults

  • Progressed Planets - The default planet progression style (will not change settings of previously created charts)
  • Progressed MC & Cusps - The default progression style for the MC & Cusps (will not change settings of previously created charts).


Progression Styles Explained

iPhemeris currently provides the two most common Progression styles, more will be added in future.

  • Planets
    • Secondary Progressed - Standard 1 day for 1 year and fraction thereof, since the natal or radix date. All planets are shown in their position on the implied Secondary progressed date and time. You can verify this by looking at the Ephemeris page for the date equal to the number of days after the natal date equal to the number of years since the natal date.
    • Solar Arc in Longitude - All planets are moved the same number of degrees in longitude the Sun moved, using the Secondary Progression technique. Using this style of progression, planets can be in positions they never actually occupied in time and space.
  • Cusps
    • Solar Arc in Longitude - The MC is progressed by the Sun's Solar Arc in Longitude from the natal or radix date to the progressed date. The Ascendant and cusps are calculated from the progressed MC's implied Right Ascension (this does not work with Whole House system).
    • Solar Solar Arc Directed - MC, ASC and cusps are moved the same number of degrees in longitude the Sun moved, using the Secondary Progression technique.

Chart Wheel Styles

  • Show House Numbers - Toggles the display of House numbers on the chart wheel.
  • Label House Cusps - Toggles house cusp labels. Turn OFF for European wheel.
  • Show Decanates - Toggles the display of Decanates on chart wheel.
  • Show Minutes on Wheel - Toggles the display of minutes on astrology charts. Minutes are NEVER displayed on Tri-Wheels. Minutes are ALWAYS displayed on reports.
  • Show Aspects On Wheel - Toggles the display of Aspects on the chart. No effect on display of aspects on reports.
  • Always Show MC & Asc - Can be used to turn off display of points on the chart if they are the same as various house cusps in the house system used. No effect on reports. E.g. when set to NO, the Asc point is not displayed on a chart using Placidus.
  • French Wheel Style - Horoscope wheel is displayed in style used and preferred in France. Disables some of the other wheel style preferences.
  • Dotted Line for Separating Aspects - When ON separating aspects are shown using a dotted line. When OFF a dotted line is used to indicate minor aspects.
  • Colors - See iPhemeris preferences to change the color theme used by Charts and Chart reports.

Top ▲

Time Zone Lookup

Time Zone Lookup requires Internet access. Iphemeris uses an international, open source Time Zone database. To get correct values for Astrology charts you must first set the Chart's Date, Time and Location.

The database is very correct for 1970 and after and is continuously updated and corrected due to an International effort to compile global historical Time Zone data for computer use. Prior to 1970 and due to the various and politically complex dates when places around the world adopted, repealed, then re-adopted Daylight Savings or Summer Time, the database is sometimes off by 1 hour. But this too is under continuous revision and improvement. In the U.S., errors sometimes occur for dates prior to 1966 after which it was mandated by law. This typically happens during summer months. If you are seeing an unfamiliar ascendant or midheaven value, do a Google search for when Daylight/Summer time was adopted at that place, or manually enter the value you know.

You can read more about it on Wikipedia if you wish. It is a relatively important subject for Astrologers to be familiar with.

  • Lookup requires Internet access.
  • Lookup requires that chart: Date, Time and Location have already been set.
  • Find Time Zone - Queries the database for the Time Zone in effect for the data and time at the location.
  • Local Mean Time - Calculates a Time Zone based purely on Longitude. This is only recommended for researchers and very old dates.

Top ▲



iPhemeris can use iCloud to backup and share your astrological chart data between iPhemeris on all your iOS and Mac devices. The first time iPhemeris sees an active iCloud account on a device, it asks if you would like to use iCloud. It only asks once, should you decide to turn it on later, you can do so from iPhemeris Preferences on the Mac or iPhemeris Settings on iOS.

Using iCloud

  • iOS - Requires iPhemeris v9.4 or later.
  • OSX - All versions of iPhemeris on Mac support iCloud.
  1. Enable iPhemeris to use iCloud in iPhemeris Settings (on iOS) and/or iPhemeris Preferences (MacOS).
  2. Allow iPhemeris to use iCloud Drive from iOS System Settings or Mac System Preferences.

iCloud Drive must be turned on and iPhemeris permissioned to use it for you to be able to save and share charts.


iOS - Enable iCloud Drive on iOS

Step 1


Step 2


Step 3


MacOS - Enable iCloud Drive on MacOS

Step 1


Step 2


Step 3

Handling Duplicate Charts

  1. First, turn iCloud on in iPhemeris on ALL devices you intend to use it with.
  2. Second, allow it to finish syncing all devices. This can take several minutes or hours and it is best to wait until you see all your charts appear on all devices.
  3. Finally, choose one and only one device and delete the duplicates. Deletions will automatically propagate to all your other devices.


Disabling iCloud

  • You can disable iCloud in iPhemeris from iPhemeris Settings.
  • Charts will be moved OUT of iCloud and stored on the device locally. This is not recommended because deleting the App can cause loss of all charts on that device.


Other Issues
We occasionally get blamed for "deleting" your charts. Actually iPhemeris NEVER does that unless you push the delete button on the chart list and delete a specific chart. And if you are using iCloud even deleting the App from an one device will not delete your charts.

Some issues we have seen users encounter and which can cause problems syncing with iCloud or even saving charts:

  • Can't Save Charts - Check that you have not reached your iCloud storage quota. If you have this can cause iPhemeris to silently fail while attempting to save a chart.
  • Can't Save Charts - This can happen if iCloud is ON in iPhemeris Preferences but not enabled to use iCloud Drive. Either turn it on in both places or disable it in both places, as you prefer.
  • Charts Not Syncing - This can occur for a number of reasons including:
    • Not logged into iCloud at all.
    • Not logged into the same iCloud account you saved charts to.
    • You just turned iCloud on and charts have not had time to sync up. After waiting 5 or 10 minutes try a full restart of iPhemeris.
    • On iOS devices check that you have Use Cellular Data turned on. It's at the bottom of the iCloud Drive screen iPhone Settings > iCloud > iCloud Drive > Scroll to bottom and check "Use Cellular Data". Be aware this could have an impact on your mobile bill.

Top ▲


Planets & Points

J Sun Soleil Sol Sonne
N Moon Lune Luna Mond
K Mercury Mercure Mercurio Merkur
L Venus Venus Venus Venus
[ Earth Terre Tierra Erde
O Mars Mars Marte Mars
P Jupiter Jupiter Jupiter Jupiter
Q Saturn Saturne Saturno Saturn
R Uranus Uranus Urano Uranus
S Neptune Neptune Neptuneo Neptun
T Pluto Pluton Pluton Pluto
: Pluto (esoteric) Pluton Pluton Pluto
U Chiron Chiron Chiron Chiron
V Vesta Vesta Vesta Vesta
W Pallas Pallas Pallas Pallas
X Juno Juno Juno Juno
Y Ceres Ceres Ceres Ceres
Z Cupido Cupido Cupido Cupido
^ Astraea Astraea Astraea Astraea
_ Hygiea Hygiea Hygiea Hygiea
` Eris Eris Eris Eris
a Eris (Alternate) Eris (alt) Eris (alt) Eris (alt)
b Sedna (Alternate) Sedna Sedna Sedna
9 Black Moon (Lilith) Lune Noire Negro Luna Schwarze Mond
] N. Node Noeud N. Nodo N. N. Mondknoten
\ S. Node Noeud S. Nodo S. S. Mondknoten
- Ascendant Ascendant Ascendente Aufwind
3 Descendant Descendant Descendiente Absteigend
. Mid Chart Mid Chart Mid Chart Mid Chart
/ Imum Coeli Fond du Ciel Imum Coeli Imum Coeli
2 Vertex Vertex Vertex Vertex
1 Part of Fortune Pt. Fortune Pt. Fortune Teil Glücks
0 Retrograde Retrograde Retrógrada Umgekehrt

Top ▲


@ Conjunction Conjonction Conjuncion Konjunktion
A 30° Semisextile Semisextile Semisextil Halbsextal
n 36° Decile Decile Decile Decile
? 40° Novile Novile Novil Novile
B 45° Semi-square Semi-carre Semi-cuadratura Halbquad-
p 51.4° Septile Septile Septile Septile
C 60° Sextile Sextile Sextil Sextaler
D 72° Quintile Quintile Quintil Quitil
= 80° Bi-Novile Bi-Novile Bi-Novil Bi-Novile
E 90° Square Carre Cuadratura Quadratisch
o 108° TreDecile TreDecile TreDecile TreDecile
F 120° Trine Trigone Trigono Trigon
G 135° Sesqui-square Sesqui-carre Sesqui-
< 144° Bi-Quintile Bi-Quintile Bi-Quintile Bi-Quintile
H 150° Quincunx Quinconce Quinconce Quincunx
> 160° Quad-Novile Quad-Novile Cuad-Novil Quad-Novile
q 165° QuinDecile QuinDecile QuinDecile QuinDecile
I 180° Opposition Opposition Opposicion Opposition

Top ▲


! Aries Belier Aries Widder
" Taurus Taureau Tauro Stier
# Gemini Gemeaux Geminis Zwillinge
$ Cancer Cancer Cancer Krebs
% Leo Lion Leo Lowe
& Virgo Vierge Virgo Jungfrau
' Libra Balance Libra Waage
( Scorpio Scorpion Escorpion Skorpion
) Sagittarius Sagittaire Sagitario Schutze
* Capricorn Capricorne Capricornio Steinbock
+ Aquarius Verseau Aquario Wassermann
, Pisces Poissons Piscis Fische

Top ▲



Ayanamsa Degree Offset From
Tropical Epoch 2000
D.K. *
Fagan Bradley
Takra I
Takra II
Larry Ely
* Courtesy of Keith Bailey who made available the date for the first decanate of the Age of Aquarius from some unpublished writings and instructions of the Master D.K. that were entrusted to his care.

Top ▲