AstroPlanner Beta Testing
Introduction
Anyone is free to download and test the latest beta version of the application. Please note that beta versions of the application have a built-in expiration date that is 120 days after the release date. After that date, you can still use it, but you'll be "nagged" to download a more recent release. This is to prevent bugs being reported on older beta versions that have already been fixed in later releases.
Please discuss beta issues only on the Beta Testers mailing list. Click here to join/leave the list.
Click here for more information on how to report a bug.
V2.4 Notes:
- This version requires a larger minimum screen size: 1280 x 720 pixels (2560 x 1440 pixels for Retina/HiDPI).
- This version might not be fully backwards-compatible with V2.3, so backup before trying it, especially the Image and Observation databases.
- As of V2.4a11, the Mac version will run natively on M1-based Macs.
- As of V2.4b6, the Mac and Windows-64 versions are compiled with "aggressive" optimisation switched on. This should make the application perform a bit faster. However it makes the code file a lot bigger, and it takes forever to compile (not your problem).
- As of V2.4b14, the minimum OS requirements for running the application are: MacOS 10.14 or later, Windows 8.1 or later. For the present, betas that run with MacOS 10.11 - 10.13, and Windows 7 SP1 - 8.0 are included below.
- Note that only the 64-bit, non-special versions of the application have been optimised for speed. However, you won't notice much of a difference in real life.
This page last modified: 2025/08/27 16:21 (Pacific time)
Download
Version | Release Date | Expiry Date |
2.4.1b6 | 2025/08/01 | 120 days from Release Date |
Macintosh
64-bit Application (.dmg) | Download | 220.2MB | 64-bit version. Intel-based Mac with MacOS 10.14 or later. Apple Silicon-based Mac with MacOS 11 or later. |
64-bit Application (.dmg) | Download | 164.9MB | Special version for MacOS 10.11 through 10.13. Intel-only. |
Windows
32-bit Application (.exe) | Download | 136.1MiB | 32-bit version. Installer. Windows 8.1 or later |
32-bit Application (.exe.zip) | Download | 135.7MiB | 32-bit version. Zipped installer |
64-bit Application (.exe) | Download | 132.4MiB | 64-bit version. Installer. Windows 8.1 or later |
64-bit Application (.exe.zip) | Download | 131.9MiB | 64-bit version. Zipped installer |
64-bit Application (.exe.zip) | Download | 187.9MiB | Special 64-bit version for Windows 7 SP1 through 8.0. |
32-bit Application (.exe.zip) | Download | 197.1MiB | Special 32-bit version for Windows 7 SP1 through 8.0. |
Both platforms
User Manual (.pdf.zip) | Download | 82.8MiB | V2.4 beta user manual |
Note: Beta versions of the application typically do not include the user manual or scripting manual in order to reduce download size.
Release Notes
A list of unresolved bugs can be found here, and feature requests here.
Version: 2.4.1b7 | Release Date: Soon | Fixes: 15, Enhancements: 4 |
ID: Status: Date: |
Issue with editing observation attachments I did create an observation for an object, every thing go well. After that I go into the Observation database. Click on the last observation I juste created to add attachement to the objet (basically I would like to link the Zip file which contain raw data and copy into the database the JPEG processed file). When I close and save, observation database is messed up. The last observation disappear or is replaced with a new observation of current date. The link with the object I was observing is lost and there is no way to recover because I can’t add object to existing observation. I have to remove this two new entry and repeat all operation to create the observation. Resolution: |
ID: Status: Date: |
CURLConnection.Get: Nil Object Exception Exception Type: Nil Object Exception 1: Function CURLConnection.Get( string, FolderItem, int64 ) as boolean Resolution: |
ID: Status: Date: |
Long-term visibility widget issue I have turned off the ‘Long term visibility‘ widget as it runs through multiple iterations before finally refreshing. It displays a percentage and then starts again and again. This only happens every so often. Resolution: |
ID: Status: Date: |
Utility.CopyTo: I/O Exception Exception Type: I/O Exception 1: Sub BinaryStream.CheckForError()
I noticed that the attached Visible Objects document was suddenly showing no User-Defined field information anymore, so I did a Save As and then this error immediately followed after the Save As completed. I had previously removed and object from, and then re-saved, the Main Objects document. number112
Analysis: Resolution: |
ID: Status: Date: |
Editing Object's Name and a User-Defined Field Causes a Hangup Open the attached document and do the following to duplicate: The program will freeze and show an hourglass. Attachment: Complex Companions (Freezes).apd Resolution: |
ID: Status: Date: |
MainWindow.GetResults: Nil Object Exception Exception Type: Nil Object Exception 1: Sub MainWindow.GetResults( MainWindow, boolean, boolean, boolean, string )
I noticed that Spica was returning wrong results for its altitude when I selected it in the Nova, Quasars and UFOs plan (I had recently merged my old Main Objects plan with it to get the object). It was also in the wrong spot on the constellation chart. I think it was from an older version of the Yale catalog. So I clicked the plus sign to add a new object and chose the Yale catalog. When I chose to add it to the object list I saw some message about searching for duplicates and then this exception appeared. Attachment: 2021-03-31 Novas, Quasars and UFOs.apdAttachment: Main Objects.apd Analysis: Resolution: |
ID: Status: Date: |
SkySafari export issue The SkySafari export feature sometimes puts the Name field contents into the CatalogueNumber line in the exported file, rather than the ID. Resolution: |
ID: Status: Date: |
Date.SQLDateTime.Set: Unsupported Format Exception Exception Type: Unsupported Format Exception 1: Sub Date.SQLDateTime.Set( int32, string )
Something really wrong with the application and/or planfiles. Planfile(s) becoming corrupted. Screenshot + 1 planfile attached. message=Invalid Date format
Resolution: |
ID: Status: Date: |
Ctrl-Y keyboard shortcut issue The Ctrl-Y keyboard shortcut is used both for instigating the Image Manager and for Preferences. Resolution: |
ID: Status: Date: |
Add descriptions to Image Manager Add the ability to display descriptions for user images in the image manager. Resolution: |
ID: Status: Date: |
Database.ExecuteSQL: DatabaseException Exception Type: DatabaseException 1: Sub Database.CheckForError()
I have shared database on Dropbox seems link is not working. So I updated path on both computer. Analysis: Resolution: |
ID: Status: Date: |
PlanWizardDatabase.UpdateCatalogueEntry: DatabaseException Exception Type: DatabaseException 1: Sub Database.CheckForError()
Just checking newly installed AP software, and starting a new plan wizard, software has an error and stopped running. Resolution: |
ID: Status: Date: |
ObservationWindow.RestoreObsSessionState: Nil Object Exception Exception Type: Nil Object Exception 1: Sub _CallLaterTimer.Event_Action()
Closed the observation database window and switched to the objects window. Resolution: |
ID: Status: Date: |
NewObservationEditDialog.Constructor: Out Of Bounds Exception Exception Type: Out Of Bounds Exception 1: Sub NewObservationEditDialog.Constructor( NewObservationEditDialog, PlanObservation(), int64, string )
On Observations screen. Resolution: |
ID: Status: Date: |
Adding optional tooltips for user notes, etc. Since there’s currently no setting for showing tooltips for User Notes, perhaps it could be added to the Object List Preferences. That way, users could decide per plan whether or not to enable it — which might be a flexible solution that works for everyone. Resolution: |
ID: Status: Date: |
Text in user notes slows down object list scrolling Excessive amounts of text in user notes slows down object list scrolling. Resolution: |
ID: Status: Date: |
Converting user notes to plain text When you paste text copied from elsewhere into the User Notes editor, it can carry over style info, such as Font, bold, size, etc. This is not straightforward to remove. Resolution: |
ID: Status: Date: |
Editing Object List Columns changes column width AP 2.4.1b6 issue: Editing Object List Columns changes column width. I opened an AP plan and proceeded to edit the object list columns by selecting the "Edit List Columns" menu item. In the "Edit Object List Columns" window I turned off the display of the "SB" column. I then clicked the "OK" button. The plan then showed no "SB" column (as expected) but unexpectedly showed modified spacing of the columns to the right (i.e. the "Transit" column and the "User Notes" column) of where the "SB" column had been displayed. It seems as if, in the post-edit plan, the "Transit" column that was immediately to the right of the newly hidden "SB" column has taken on the width of the hidden "SB" column. Likewise, the "User Notes" column has taken on the pre-edited width of the column to its left, i.e the "Transit" column. Attached please find screenshots of the plan window both before and after editing. I've reproduced this issue in a few different plans. AP 2.4.1b6 Mac Studio, macOS 15.5 Resolution: |
ID: Status: Date: |
Add Import text modifier to select from a list Sometimes a field in an import text file might contain, say, a list of IDs separated by commas, and you want to import just the first ID. Can the Text Modifier option have extra rules to allow this? Resolution: |
Version: 2.4.1b6 | Release Date: 2025/08/01 | Fixes: 14, Enhancements: 7 |
ID: Status: Date: |
Add "Best Altitude" column Add "Best Altitude" object list column which shows the altitude of the object at the Best Time. Resolution: |
ID: Status: Date: |
CURLConnection.Get: Nil Object Exception Exception Type: Nil Object Exception 1: Function CURLConnection.Get( string, FolderItem, int64 ) as boolean
I was going to download a single script but realized that once the download started that all available scripts were being downloaded (I assume because I had not selected the single script I wanted to download ). Not wanting to download all of the scripts, I clicked on the cancel button and then got this Application Exception window. Resolution: |
ID: Status: Date: |
ObservationDatabase.BeginDBTransaction: DatabaseException Exception Type: DatabaseException 1: Sub Database.CheckForError()
This exception popped up again when saving the planfile by Cmd+S. After sending this report the small window "Save Observation database" remains open. Resolution: |
ID: Status: Date: |
ResourceDatabase.CloseDatabase: DatabaseException Exception Type: DatabaseException 1: Sub Database.CheckForError()
Another error to save the data. This time when I tried to add a new Site. Looks like there’s some issue related to the Resources Database. Resolution: |
ID: Status: Date: |
Data displayed over FoV rendering: addition of value for Size All kinds of data can be selected to be displayed directly above the FoV chart rendering. Addition of the Size of the object selected in the Object list would be useful. Resolution: |
ID: Status: Date: |
SynonymManager.nextGUID.Get: Nil Object Exception Exception Type: Nil Object Exception 1: Function SynonymManager.nextGUID.Get( int32 ) as int64 Resolution: |
ID: Status: Date: |
Compatible Highlight Rule Transit Dates not Imported Transit dates that are exported with the same date they are imported to show a Transit Date Bad Rule error. Steps to Dupe: (Note: Steps 2 and 3 are from Visible Objects plan) 1. Open the two attached documents. Make sure the date is set to 12/20/24 at Civil Twilight end at the EM (KitchWell-S 2.07) site. 2. Make sure that the Not Seen / Rated, Near Opposition, Near Transit, Prime rule is selected for the highlight rule. This rule should have the transit date not between 1/4/2025 and 12/5/2025. 3. Save this rule or use the attached rule export. 4. Change to the Main Objects document and load the highlight rule by choosing the Highlight combo box in the Site Widget and choosing to Edit Custom Highlighting > Load. 5. Notice that in Main Objects, it sees the transit rule as having bad dates and doesn't keep what was there. Attachment: Main Objects.apdAttachment: Visible Objects 2024-10-25.apdAttachment: AstroPlannerV2-W32.prefsAttachment: AstroPlanner ResourcesAttachment: New-Beta(2.4.1b1) No Listman Opt Desc, Extra NearOpp.hrules Resolution: |
ID: Status: Date: |
A Light Dome and Horizon Marker do not show. I just saved my changes to a plan and chose Save All before sending this. I had set the date to 2/28/2025 and 9:32:04pm at my site called EM (KitchWell 1.06)H. I had Wezen highlighted, went into Edit> Resources, and set a light dome and obstruction (only ones at this site) because I had observed two other objects with issues and Wezen was around the same area in the sky. The Alt/Az indicator shows the horizon obstruction and light dome right below the object but the Short Term indicator doesn't show either one at all. The plan I had open was 2024-10-12 Candidates. I suspect that if I exit the program and come back in then everything will look fine. I have turned off the forced date and time in General Prefs and will see what happens. If things then show up correctly I'll let you know in another report. However, one still shouldn't have to restart the program and it might cause someone to miss something while planning another session. Attachment: AstroPlannerV2-W321.prefsAttachment: AstroPlanner ResourcesAttachment: 2024-10-12 Candidates.apd Resolution: |
ID: Status: Date: |
Addition of a column for "Distance to anti-solar point" Would it be possible to add a column in the objects tab to display the angular distance , in degrees, of any object to the current anti-solar point? Formatted as degrees, delta Alt/Az, or delta RA/Dec. Resolution: |
ID: Status: Date: |
Add Area type object Add a new Area type object that defines a rectangular area centered at the given RA and Dec. The Size field specifies the length and breadth of the rectangle, and the Position Angle specifies its angle w.r.t. N. The area should be plotted on the field of view chart, and on the sky chart, where applicable and visible. Resolution: |
ID: Status: Date: |
"Right click - create new object" not working In the FoV, the option to right click on a position, then select "Create new object centered at cursor position" is no longer working. Perhaps related to the "right click download image for position" not working (and since fixed) ? Analysis: Resolution: |
ID: Status: Date: |
Adding new built-in object list columns Adding new built-in object list columns is causing a "Corrupt" message when editing list columns. Resolution: |
ID: Status: Date: |
Addition of a column for "Distance to ecliptic" Would it be possible to add a column in the objects tab to display the vertical distance (delta declination), in degrees, of any object to the ecliptic? For example, object Dead Horse Nebula, 15.2° N If this is an easy implementation, could I perhaps get a pre-release version? Resolution: |
ID: Status: Date: |
Maximized window doesn't work permanently This is a small cosmetic problem I have experienced for a long time (many years). How to reproduce the problem: 1. Maximizing the main program window When you close the other window (e.g. Resources), the main program window will leave the maximized status. Resolution: |
ID: Status: Date: |
USNO stars not showing in FoV The stars in the USNO catalog will not longer display in the FoV. No such problem for other star catalogs. The USNO stars can still be added to a planfile from the catalog and then will display correctly. Screenshot attached. Attachment: 38355954111 Analysis: Resolution: |
ID: Status: Date: |
Planets and the sun position all at 0 (zero) R.A. and Dec. Any planet + the sun that is present in a planfile (or added to a planfile by means on the button "Add Special" in the Objects tab) is positioned at 00:00:00 right ascension and +00°00'00" declination. Additional info: I was looking at historical data and the time in the application was set to the year 1880. Apparently it is then that the application will not calculate proper positions. All is well at current day. Analysis: Resolution: |
ID: Status: Date: |
Different rendering of Dialog.ListChoiceParameter in Windows and Mac The Dialog.ListChoiceParameter requires column padding in Windows 11 to allow the display of the required columns. This is not the case on a Mac. The Dialog.ListChoiceParameter does not respect the minimum rows to display on Windows 11. Resolution: |
ID: Status: Date: |
Downloading image in FoV tab for cursor position not working anymore When attempting to download (an) image(s) when in the FoV tab, by means of a right click on the FoV rendering, then selecting "Download images centred at cursor position...", nothing happens; the Download Image window will not open. Resolution: |
ID: Status: Date: |
New "Field rotation column" automatically selected in all planfiles + associated sorting problem The new "Field rotation column" is automatically selected and displayed in all planfiles, requiring manual deselection. Also, some user Sort List presets are not functioning any more as the Field Rotation column seems to interfere with the set preset (not a big problem as a sort preference is easily re-created). Resolution: |
ID: Status: Date: |
Image Manager tweaks 1. It would be convenient to have a quick button to access the Image Manager instead of going to the menu etc... Resolution: |
ID: Status: Date: |
User-defined field values as tooltips Would it be possible to display the contents of the “User Notes†field (and ideally any other user-defined text fields) in a tooltip when hovering over the corresponding cell or item? This would make it much easier to quickly view important notes without opening the full details pane, especially when scanning through lists of objects during planning or observing sessions. If it’s feasible to implement for all fields containing text – not just built-in ones but also user-created ones – that would be fantastic. Resolution: |