Skip to content
Branch: master
Find file History
Type Name Latest commit message Commit time
Failed to load latest commit information.
CMakeLists.txt Bump version 0.3 -> 0.4 Jan 31, 2019
README.rst Update changelog, and README Feb 1, 2019
command_interface.h Add speed constants Jan 30, 2019
connectioncurl.cpp Fix segfault when reusing CURL handle Jan 31, 2019
indi_starbook_telescope.xml.cmake Fix typo Jan 3, 2019
starbook_types.cpp Refactor Status parsing Dec 23, 2018
starbook_types.h Add Connection::Curl interface Jan 4, 2019


Starbook INDI Driver

This package provides the INDI driver for the Vixen Starbook telescope controllers. This driver aims for compatibility with first generation Starbook. Starbook 10 is not tested with this driver.


In order to build this package you need:

  • INDI >= v1.7 (

    You need to install both indi and indi-devel to build this package.

  • cURL >= v7.58.0 (

    You need to install curl

  • libnova

    You need to install both libnova and libnova-devel to build this package.


Starbook is easy to hang up. You won't get smooth operation by design. Driver was written with this in mind so it will put few limitations on a user. Starbook is a state machine, that means it will allow different functions in specified states. During INIT state it won't react to GOTORADEC commands and will wait for user to manually enter SCOPE state or by START command. In INDI control panel it's called Initialize

In later version I expect to implement abstract state machine, to keep Starbook state and allowed transitions. From version 0.4 you can see Starbooks state in INDI control panel.

Internal HTTP server is very fragile, so any wrong request might break it. Expect to frequently restart your Starbook.


IMPORTANT NOTE: watch your mount at all times, don't trust this driver.
Starbook is known for its erratic behaviour. Please report any troubles, so we can stabilize drivers operation. Go to GitHub issues and report them here.
  1. Connect Starbook's LAN port to your network:
    • It can be connected directly with _cross-over cable_.
    • To standard router with DHCP enabled, you should give starbook static IP in your router.
  2. Boot up Starbook. It will enter INIT state. (now you can setup date, location, etc.)
  3. Check acquired IP address in About STARBOOK option in INIT menu.
  4. Check internal HTTP server by going to specified IP address in browser.
  5. In Connection tab in Kstars enter IP address
  6. Connect from Main control tab
  7. If Starbook is in INIT state, initialize it by:
  8. ...
  9. Profit?

Have fun and don't look at the Sun!

You can’t perform that action at this time.