logo

Documentation
iPhemeris Astrology Software for Mac

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

MacOS Introduction

What’s New (MacOS)

Version 4.2

NOTE: Please update iPhemeris on all Apple devices to Version 4.2 on MacOS and Version 11.2.1 on iOS. Both are now available.

WHAT’S NEW

  • The Tropical / Sidereal settings is no longer global, and can be set for each feature and for individual charts.
  • Heliocentric & Topocentric capabilities are included as part of the “Extended Ephemeris” In-App purchase.

TROPICAL / SIDEREAL SETTING – NOT GLOBAL

The major change in this release was the transition of the Sidereal setting to no longer being a global setting. The Ayanamsa setting is still global. It is now possible to display most features and individual charts as either Sidereal or Tropical. In the case of astrology charts, a sidereal chart can be compared to a tropical or even a heliocentric or topocentric chart.

HELIOCENTRIC AND TOPOCENTRIC

Heliocentric and Topocentric data is now available to owners of the Extended Ephemeris feature (see iPhemeris store). Existing owners of that In-App purchase will find it enabled in various places throughout the software.

ICLOUD DATA UPDATE & TRANSITION

This release of iPhemeris uses Apple’s newest CloudKit technology to store chart data to iCloud (at your option). In order to transition to this we had to copy data from the old iCloud location to the new iCloud location and also added support for the fact that astrological charts can now be Tropical, Sidereal, Topocentric or Heliocentric on an individual basis.

Therefore, during the copy of the data to the new iCloud location, we set astrological charts previously saved to be either Tropical or Sidereal based on whatever earlier global setting was found for your install. We hope that data is not duplicated but we did see it happening sometimes. Duplication is the lesser evil vs. losing data.

Please let us know via support@iphemeris.com if there are any issues and don’t forget to update all your devices to the latest version of iPhemeris.

TROUBLE SHOOTING DATABASE UPGRADE ISSUES

Unfortunately during the upgrade of the database, some people had been looking at Sidereal temporarily or had not understood the Sidereal / Tropical Setting in iPhemeris Settings. It was possible to have Sidereal set but with an Ayanamsa of “Tropical”. This would have meant that during the update of your chart database. We set this setting in each chart to Sidereal. If you notice that charts have unrecognizable position, check the area pointed to by the red arrows.

If it is Sidereal and should be Tropical or vice versa, this is easily remedied. Before using each chart for the first time (this is required only once) use the Chart Editor to set the chart to the correct value:

  1. Open the chart editor.
  2. Set the Tropical / Sidereal button to whichever you use. Most people want tropical.
  3. Make sure the Geocentric / Topocentric / Heliocentric button is set to Geocentric.

That chart is now back to normal and good to go. Unfortunately this will be required once and only once for each chart. We are sorry for the inconvenience.

 

Top ▲

Introduction

iPhemeris uses the Swiss Ephemeris which is based on the Jet Propulsion Laboratories (JPL) DE431 ephemerides and the US Naval Observatory equivalent for Asteroids. It offers sub-second accuracy to with .001 seconds of arc.

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

iPhemeris uses New StyleGregorian 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.

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.

Note:
We use translation services, but Astrology is a special discipline and many astrological terms have dual meanings. If you notice anything out of context or incorrect in your language please notify support.

Top ▲

MacOS Getting Support

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

GETTING SUPPORT

  • Send email via the iPhemeris Menu at the top of the Screen: Help> Email iPhemeris Support. That button automatically includes information about the version of MacOS and iPhemeris you are running and helps us diagnose the issue.
  • Please provide as much information as possible about the issue, including:
    • The version of MacOS (see the Apple About menu).
    • The version of iPhemeris (see the iPhemeris About Menu).
  • When asking a question about charts, include:
    • Date, time, place and type of horoscope you are asking about (it’s best to send a screen shot of the chart).
    • The exact nature of the issue you are encountering.
    • If you are getting a chart with an unfamiliar Ascendant/Mc, please review the help documentation on time zones. Wrong time zones are the most frequent cause of issues with Mc and Ascendants.
  • Screen shots illustrating the issue are always helpful.

NOTE:
Posting negative reviews is not the best or fastest way to get our attention. It can take us weeks to notice. We are very responsive to email and often respond within hours, and will do our utmost to get things sorted ASAP!

To get support, use the option to email us from the iPhemeris Help Menu or at: iPhemeris Support

Top ▲

MacOS Preferences

Symbols & Calculations Preferences

All of these settings are Global and are used throughout the program in every feature.

Ayanamsa

  • When a feature is displaying Sidereal data, this Ayanamsa settings is used.
  • Ayanamsa Select a pre-defined Ayanamsa from the dropdownor choose Your Ayanamsa” at the bottom to set a custom value.
  • Custom Ayanamsa – To use your own custom value for the Ayansamsa:
    • Select Your Ayanamsa at the bottom of the Ayanamsa list.
    • Enter your value in the box. 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).

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).

Symbols
Select the symbol used to represent Earth, Pluto, Eris & Vulcan. This applies to all features throughout iPhemeris.

Calculations

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.

Lunar Nodes – Use either True Node or Mean Node in all features.

Black Moon – Use either True or Mean values for Lunar Apogee, also know as Black Moon and Lillith.

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

Calendars
Choose the first day of the week (Sunday or Monday) for calendars displayed on the following feature tabs:

  • Ephemeris and Declination/Latitude
  • Aspect Calendar
  • Transit Calendar

Top ▲

Location Preferences

Location Preferences are used by the Ephemeris tables and Calendar pages for the location and elevation when Topocentric data is being displayed.

Top ▲

iCloud Preferences

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

iPhemeris uses very little iCloud storage for horoscope data and it is well worth doing, we strongly recommend using it.

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 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 & also that you have allowed iPhemeris to use iCloud Drive in MacOS System Preferences.
  • If you can’t save charts we have seen users with the following issues:
    • iCloud was enabled but not iCloud Drive.
    • The iCloud storage limit was reached (the solution is delete some of the likely many photos up there or buy more space).
  • If you are not seeing the charts saved on your iOS device, then also check that your iOS device has access to the internet via WIFI or a cellular connection. When using a cellular connection you must also allow cellular data or charts will not sync.

Top ▲

Printing Preferences

Print Only In Black & White

Disables color printing throughout iPhemeris and improves readability for Black & White printers and/or saves costly ink and toner.

 

Astrologer Information

You may enter up to 5 lines of Astrologer information that is displayed in the lower right corner of the Chart Wheel. This can be anything you want and will appear on printouts also.

Top ▲

Function Toolbar Preferences

Arrange which functions appear and in what order on the iPhemeris 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 ▲

Your Color Scheme

iPhemeris offers pre-defined color themes which can be selected via the settings button (Gear icon) on most feature tabs.  We 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. However if you prefer to design your own color theme then this is the place to do it.

This custom Color scheme will be saved and sent to iCloud and is available to iPhemeris on iOS devices if you use that. You will see this color scheme available in versions of iPhemeris (version 11.0 or newer).

Define Your Color Scheme for Charts & Sky Now
Select the color well next to the planet, sign or other element you wish to set a color for. When you are done adjusting all the colors Save the changes. You may then apply this scheme by selecting “Your Colors” from the dropdown on the Charts & Sky Now settings panels.

Top ▲

MacOS Ephemeris

Ephemeris (MacOS)

iPhemeris is a powerful tool that displays Tropical, Sidereal, Topocentric and Heliocentric data for any location and time at that location around the world (Topo and Heliocentric are available with the Extended Ephemeris). Simply by adjusting a few Display Preferences (gear button) you can have a standard monthly, tabular Midnight or Noon GMT Ephemeris or set it for any other time and time zone. For example, the Open of the New York Stock Market.


EPHEMERIS DISPLAY

  • Ephemeris tables display a full month of: planetary, asteroid, lunar phases, lunar ingress, moon “void of course” times and eclipse data.
  • 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 settings.
    • The second displays its position 12 hours later.
  • Heliocentric tables do not show Moon tables or the Sun, Earth can be included instead from the planet picker in the side panel.
  • Columns for the individual planets and bodies can be turned on or off in the side panel at left.
  • 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 display of planetary declination and latitude (declination on the left, latitude on the right of each column) is in Degrees, Minutes and seconds and is read as follows:

25 n 28′ 59″ = 25 degrees North, 28 minutes, 59 seconds.

NAVIGATION

  • The Disclosure button shows or hides the sidebar.
    • In the sidebar click buttons next to the various bodies to turn them on or off in the display.
    • The Data Export button will display the option to purchase Data Export (if you do not own it) or show planet set for data export.
  • The Gear button shows the settings window.
  • 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 Left / Right arrow keys page back or forward by month.
  • The Today button always returns to the current day and month.
  • Longitude | Dec / Lat button switches between the two sets of data.
  • The Print button prints the currently displayed month.
  • The Text Size buttons increase and decrease the text.
  • Click a row to highlight it, click again to un-highlight.

Top ▲

Ephemeris Settings (MacOS)

Ephemeris Settings are accessed via the Gear button at the top of the Ephemeris tab. These settings effect only the Ephemeris tabs.

The Ephemeris display settings are accessed via the gear button. Clicking that button display the following dialog which can be used to set:

  • Time Zone andTime for data shown in the tables.
  • Data Precision – long or short format.
  • Color Scheme – color scheme used to display the ephemeris tables.
  • Tropical or Sidereal – This setting is no longer global and relates only to the ephemeris tables displayed in the Ephemeris Tab. The sidereal setting uses the Ayanamsa selected in iPhemeris Preferences.
  • Geocentric, Topocentric, Heliocentric – Topocentric and Heliocentric are only available with the Extended Ephemeris. See the iPhemeris store to purchase Extended Ephemeris.

Time Zone & Ephemeris Hour
This setting controls what time zone and hour each row of data in the Ephemeris tables uses. The tables will show the data in the selected Time Zone at the selected Ephemeris Hour.

  • Time Zone – It uses standard Time Zone notation. Locations West of Greenwich are negative (-) and East are positive (+). It does not auto adjust for Summer/Winter time.
  • Ephemeris Hour – Sets the hour in the the selected Time Zone.

Examples

  1. For a Noon GMT Ephemeris, set a Time Zone of UTC (GMT) 00:00 with an Hour of 12.
  2. For a Midnight Ephemeris is your Time Zone, set the Time Zone to your time zone and the Hour to 00:00.
  3. For a New York Stock Market Ephemeris, set the Time Zone to -5:00 (or -4 during summer time) and the Ephemeris Hour to 9:30.

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 ▲

Ephemeris Data Export (MacOS)

Data export allows any data in your version of the ephemeris including asteroids and uranians to be exported to a file of Comma Separated Values (.csv) and saved on your Mac.

Planet and Body Check Boxes
These are in the sidebar at the left of the Ephemeris View. They set which planetary bodies will have their data exported to a file. These settings are independent of the display columns and only effect what is exported.

Start & End Date and Times
The Start and End date/time fields set the starting and ending point of the exported data. This setting in combination with the Frequency setting will determine how many rows of data are exported. You may select any period of time in the range of data supported by your version of the Ephemeris. For example if you set a start of Jan. 1, 2021 and an end of Jan. 1 2022 with a 1 day frequency you will get 365 rows of data.

Tropical / Sideral
This setting is independent of the displayed data and determines if the values exported are tropical or sidereal. If sidereal, then the ayanamsa setting set in iPhemeris Preferences is used. If you’ve never selected an ayanamsa then it defaults to Tropical and this setting has no effect.

Geocentric / Topocentric / Heliocentric
Data exported can be either:

  • Geocentric – Earth centered data.
  • Topocentric – Earth centered data as viewed from elevation at the spot on the Earth selected in Location Preferences (see iPhemeris Preferences). When you set the location using the map from the Location Preferences panel, iPhemeris will also get the elevation for that location from a NASA derived global elevation database.
  • Heliocentric – Sun centered data. The Sun is not available, Earth is offered as an alternative.

Time Zone
Determines what time zone is applied to the date/time setting. If UTC 00:00 is set, then the data is GMT for whatever time was set.

Frequency of Data Points
Use a combination of the Every field and the Days/Hours field to determine how many rows of data you get between the selected starting and ending date/time.

Examples:

  • If you want to export hourly moon data, set Every = 1 and Hours in the drop down.
  • If you want data twice a day or every 12 hours, set Every = 12 and Hours in the drop down.
  • Weekly data can be obtained by setting Every = 7 and Days in the dropdown.

Be careful with this setting, setting hourly data for a period of 1 year is 24 rows x 365 days.

Data To Include
This determines how many columns of data you get for each selected planetary body. Most planetary bodies have all four values, if it does not, then that column will simply be excluded for that body.

Some planetary bodies, like Chiron, do not have data available for all periods of time for various reasons. Chiron for example passed close to Saturn in the distant past, making it impossible to accurately calculate its location prior to that date. In those cases you will see the following value substituted: 99999.0

Top ▲

MacOS Graphic Ephemeris

Graphic Ephemeris (MacOS)

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.

SETTINGS

Settings are accessed from the gear at the top left of the Graphic Ephemeris View. The settings are only for the Graphic Ephemeris Tab and allow setting:

  • The Color Scheme
  • The data type to display graphically: Tropical, Sidereal, Topocentric or Heliocentric.

LONGITUDE

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.

UNDERSTANDING THE DISPLAY

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.

VIEWING POSITIONS

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.

HARMONIC RANGES

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.

VIEWING 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 ▲

Graphic Ephemeris in Horoscope Reports (MacOS)

 

When enabled (see iPhemeris Store), 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.
  • Click the Use button to update after a new chart is selected.
  • 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.

DISPLAYED POINTS

  1. The planets and points selected to display on the Horoscope wheel will be included on the main graphic ephemeris chart (wavy lines).
  2. The planets and points selected to display in Reports will be used for the dotted line overlays.

Top ▲

MacOS Calendars

Aspect Calendar (MacOS)

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.

 

SETTINGS

Aspect and Transit Calendar share the same settings. They are accessed via the Gear button. Changing them for Aspect calendar also updates them for  Transit Calendar and vice versa.

ASPECTARIAN DISPLAY

    • 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.

NAVIGATION

  • 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 ▲

Transit Calendar (MacOS)

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.

SETTINGS

Aspect and Transit Calendar share the same settings. They are accessed via the Gear button. Changing them for Aspect calendar also updates them for  Transit Calendar and vice versa.

TRANSIT CALENDAR DISPLAY

  • 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.

NAVIGATION

  • 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 ▲

MacOS Charts

MacOS Sky Now

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

 

NAVIGATION

  • 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 ▲

MacOS Sky Now Settings

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

 

EPHEMERIS TYPE

  • Tropical, Sidereal, Geocentric, Topocentric, Heliocentric settings apply only to the SkyNow tab.
  • Sidereal data uses the Ayanamsa defined from iPhemeris Preferences.
  • Topocentric data will use the location and elevation at that location set from the Location Tab available on this Settings panel.

 

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 ▲

MacOS 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 (see 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

  • Select two Charts.
  • Select “Composite” in the dropdown in the toolbar.

DRAW BI-WHEEL with NATAL, RELOCATED, PROGRESSED or SOLAR RETURN

  • If you’ve not already done so, make a Copy of the natal chart. To make a copy, select the chart (only 1 chart may be selected) and use the copy button.
  • Edit one of the copies and add the additional data in the relevant section for whichever type you are trying to create: Relocated, etc. We recommend making a copy for each additional type. Then these can be compared in Bi or Tri-Wheels to the Natal horoscope.
  • Select the Natal horoscope.
  • Select the Relocated, Progressed or Solar Return.

 

Adding & Editing Charts

 

Time Zone lookup works best when data is entered in the dialog in the order the fields are listed (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.
  • Tropical / Sidereal – Individual charts can now display either tropical or sidereal positions (tropical sidereal is no longer a global setting). Sidereal positions use the global setting for Ayanamsa set in iPhemeris Preferences.
  • Geocentric / Topocentric / Heliocentric – Horoscopes can display positions for any of these types of data. Topocentric positions use elevation (altitude above sea level) obtained from NASAs global elevation database. The value is obtained when you use the map to set the location. If you have an existing chart and are switching it to display Topocentric data, use the Map (Location EDIT button) to get the location again so that the elevation can be obtained.

 

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.

mac-help-chart-relocated

  • 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.

mac-help-chart-progressed

  • 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

CHART WHEEL STYLES

  • Chart Colors – Select a color scheme from the drop down. This applies only to charts (not Sky Now). You can design your own color scheme from iPhemeris Preferences and which will appear on this dropdown after you’ve defined it in iPhemeris Preferences.
  • 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 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.
  • Draw Degree Marks on Wheel – Toggles ON or OFF the drawing of degree marks (1 per degree) and with a longer tick mark for the Decanates.
  • Draw Bold Axis Cusps with Arrows – Bolder lines for MC/IC and Asc/Dsc and with Arrows.
  • Show Decanates – Toggle the style of Decanates on chart wheel: None, Empty, Modern Rulerships, Traditional Rulerships.
  • Show Bounds, Terms, Limits – Display Bounds on wheel: Egyptian or Ptolemaic.
  • Show Nakshatra – Display 27 Nakshatra divisions around the Tropical wheel based on the Ayanamsa selected.

 

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.

Ephemeris Type: Tropical / Sidereal – Individual charts can now display either Tropical or Sidereal data. This sets the default used when creating a new chart. When sidereal, it uses the global Ayanamsa value set in iPhemeris Preferences.

Ephemeris Type: Geocentric / Topocentric / Heliocentric – Individual horoscopes can now use Geocentric, Topocentric or Heliocentric data. This setting sets the default used when creating new charts. Topocentric & Heliocentric are only available and enabled if you have purchased the Extended Ephemeris from the iPhemeris Store.

Rulers On Reports – Show Modern or Traditional Rulers

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.

Top ▲

Time Zone Lookup

iPhemeris uses an international, open source Time Zone database known as TZDATA. You can read more about it here: TZDATA on Wikipedia

  • Time Zone lookup requires Internet access (WIFI or a cellular data connection).
  • It requires that the: Date, Time and Location are already set.
  • Find Time Zone – This button 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.

TZDATA is contributed to and corrected by computer scientists all over the world. It was originally created to be an accurate source of Time Zone data for computer clocks which need to know when a specific location switches between regular and Summer or Daylight time DST. Due to the various and politically complex dates when places around the world have adopted and repealed Summer Time, the database can sometimes be off by 1 hour in a specific location. This is happening less and less frequently due to continuous updating and improvement.  Anyone finding errors can report it to TZData by providing 3 sources proving the error, e.g. newspaper articles, etc. TZDATA is now the most accurate historical record of time zone data and clock changes anywhere in the world.

For US locations, errors sometimes occur for dates prior to 1966 (when DST was mandated nationwide). When errors of this type occur, it is typically that the date for the switch between DT and DST is incorrect. This will produce an ascendant difference of approximately 15 degrees. If you are seeing an unfamiliar ascendant or midheaven value, do not assume iPhemeris is wrong, do a Google search for when Daylight/Summer time was adopted at the place of the chart being cast.

Some software uses an older source for historical time zone and daylight savings changes called the ACS Atlas and which is based on The Olsen Database, the predecessor to TZDATA. Unfortunately, the ACS atlas is known to be extremely error prone, so much so that the developers of TZDATA decided they could not use it as their starting point. They analyzed ACS’s accuracy and uncovered too many errors. The developers of iPhemeris have also observed over the years many errors in charts based on ACS. We therefore concluded that the safest approach was not to include it, and we suggest that when a discrepancy arises between TZDATA and a chart cast using ACS, to simply do the research.

Time zones and Daylight / Summer Time are an important subject for Astrologers to be familiar with and it will be well worth your time to study a bit about the subject.

Top ▲

Mac Printing

MacOS Printing

Ephemeris and Calendar Pages

Click the Printer button in upper right of the view, or Right-click or Ctrl-Click in the page.

 

Charts and Chart Reports

Right-click or Ctrl-Click on the Chart View or Report Tab you want to print.

 

Top ▲

iCloud

iCloud

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.

We strongly recommend you use iCloud as a means of backing up your charts. 

USING iCLOUD

  1. iOS Devices – Enable iPhemeris to use iCloud from iPhemeris Settings.
  2. MacOS Devices – Enable iPhemeris to use iCloud from iPhemeris Preferences.
  3. Make sure iPhemeris is enabled to use iCloud Drive in iOS System Settings or Mac System Preferences. iCloud Drive must be enabled and iPhemeris permissioned to use it for you to be able to save and share charts.

iOS – ENABLE iCLOUD DRIVE on iOS

  1. On your device goto System Settings.
  2. Tap your name at top left where Apple ID, iCloud… is shown.
  3. In list on right tap iCloud which is near top.
  4. Scroll down and make sure iCloud Drive is on.
  5. Scroll further down and make sure iPhemeris is on.

icloud2

Step 3

icloud3
 

MacOS – ENABLE iCLOUD DRIVE on MacOS

  1. Goto Mac System Preferences.
  2. Select Accounts.
  3. Select iCloud account in list on left side. If you do not see it then your device is not yet logged into iCloud.
  4. If you DO see it, select it and then in the window to the right click the Options button next to iCloud Drive.
  5. Find iPhemeris in the list and make sure it is selected as shown in the image below.

Step 3

iCloudDriveMac-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.

DIABLING ICLOUD

This is not recommended. Turning iCloud OFF means that you will have no backup for your astrology charts and if something happens to your system of your installation of iPhemeris, you will not be able to recover them unless the system is fully backed up some other way.

  • You can disable iCloud in iPhemeris from iPhemeris Settings.

 

TROUBLE SHOOTING

iPhemeris NEVER deletes your chart data for any reason. Only you can delete charts. Therefore if you are not seeing charts on a new device or after an upgrade of iOS check all of the following:

  1. You are logged into iCloud.
  2. You are logged into the same iCloud account you used on the previous device.
  3. You have an internet connection.
    • Any WIFI connection will work.
    • If the connection is only mobile make sure that mobile data is enabled and iPhemeris is enabled to use it. The settings to enable iPhemeris to use mobile data are typically in the cellular section of iOS Settings App. Chart syncing requires mobile data when the connection is exclusively mobile (no WIFI).
  4. If the first three are ok and you still cannot save charts check that you have not exceeded your iCloud storage limit.

 

Can’t Save Charts

  1. Check that you have not reached your iCloud storage quota. If you are out of storage iPhemeris will fail silently. The simplest solution is to free up space by deleting some of the likely thousands of photos you have up there 🙂
  2. iPhemeris can also fail to save charts if iCloud is ON in iPhemeris Preferences but not enabled to use iCloud Drive. See above instructions to enable iCloud Drive.
  3. iCloud sync and storage cache can become corrupt. This can be fixed by simply logging out of iCloud and back in again.

Top ▲

Vedic

Ayanamsa

Ayanamsa Degree Offset From
Tropical Epoch 2000
D.K. *
28.37194647
Fagan Bradley
24.73666667
Lahiri
23.85305556
Krishnamurti
23.76194444
Galactic
25.00000000
Raman
22.40694444
Takra I
24.50027778
Takra II
24.54222222
Babylonian
24.78666667
Deluce
27.80555556
Larry Ely
28.00361111
Yukteshwar
22.47777981
Sassanian
19.99222425
Ushashashi
20.05639092
Hipparchus
20.24611314
Dhira
23.06666870
Krushna
22.95166870
* 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 ▲

Symbols

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 Sedna Sedna Sedna
c Vulcan Vulcain Vulcano Vulkan
4 Vulcan (Alternate) Vulcain Vulcano Vulkan
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

 

Uranian (Hamburg) Hypothetical Bodies

These are now known not to exist, however some wanted them so they have been added as an In-App purchase. Have at it 😉

d Cupido Cupidon Cupido Cupido
e Hades Hadès

Infierno

Hades
f Zeus Zeus Zeus Zeus
g Kronos Kronos Krono Kronos
h Apollon Apollon Apolo Apollon
i Admetos Admète

Admeto

Admetos
j Vulkanus Vulcain

Vulcano

Vulcanus
k Poseidon Poséidon

Poseidón

Poseidon

Top ▲

Aspects

@ 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-
ratisch
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-
cuadratura
Anderthal-
bquadratisch
< 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
r Parallel Parallel Parallel Parallel
s 180° Contra-parallel Contra-parallel Contra-parallel Contra-parallel

Top ▲

Signs

! 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 ▲