Astronomy charting, observation planning, ephemeris and image processing app.
Java Scala
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

NOTE: This project is abadoned, there is new rewrite to Kotlin at

Asterope is an astronomical application focused on advanced amateur astronomers. When finished it will provide skycharting, ephemeris, observation planning, telescope control and image manipulation.

This app is written in Scala and Java. Asterope is implemented as set of libraries and client Swing GUI. There are also plans for WebUI and Android app.

Asterope is not 'just another planetarium'. We take astronomy very seriously and some code from Asterope is actually used by 'big guys'.


You need an Linux, Windows or MacOSX machine with JRE 7 (JRE6 wont work) to build Asterope from sources. Source distribution already contains everything you need for build (including compiler, Ant build system, IDE project files and data). There is no reason to install JDK or Ant.

To invoke Ant use batch file 'ant.bat' on Windows or './ant' on Unix like systems. Asterope uses embedded Ant, so you should not use one installed on your system.

First step is to compile star and deep-sky database. This may take 20 to 60 minutes, but needs to be performed only once. Asterope sources contains all data, you just need to run Ant target:

    ant.bat compiledb       (on Windows)
    ./ant compiledb         (on Linux or MacOSX)

Second step is to run unit tests. It may download some data from internet, but data are cached locally. To run tests:

    ant.bat test      (on Windows)
    ./ant test        (on Linux or MacOSX)

Test reports are saved in:


Asterope is distributed in two zip archives: sources and compiled. You may build distribution archives with this command:

    ./ant dist

You may also run Asterope GUI directly from Ant. Use 'main' target:

    ./ant main


Git repository contains basic Intellij Idea project files. To import Asterope as your project:

  • Open Asterope folder as new project
  • Set SDK in Project Settings / Project / Project SDK
  • Set resource pattern under File / Settings / Compiler / Resource patterns / enter star
  • Hit Recompile and try to run tests