What is VStar?
VStar is a multi-platform, easy-to-use variable star data visualization and analysis tool that was originally developed as part of the AAVSO's Citizen Sky project. Data for a star can be read from the AAVSO database or from a text file of your own creation. It will plot the data on a light curve and then it's up to you what happens next!
Please note that in order to run VStar, you need to have the Java Runtime Environment 1.8 or higher installed. VStar should run on any operating system that supports Java.
VStar Packages for Download: New Release (2 October 2023)
- Windows (zip): vstar-win-2.23.0.zip
- Windows (installer): VStarWinSetup-2.23.0.zip
- Mac: vstar-mac-2.23.0.dmg
- Linux/Ubuntu: vstar-bash-2.23.0.zip
The packages above as well as the source code are available from GitHub: https://github.com/AAVSO/VStar/releases/latest/. For installation instructions go here: https://github.com/AAVSO/VStar/wiki/Installation-Recipes.
If you have any trouble downloading or running VStar on your computer, please contact AAVSO HQ (aavso @ aavso.org) for help. It will save time if you can provide as much information as possible on your operating system and version of Java you are using along with details of exactly what you see and any error messages you get.
The easiest way to obtain data to plot is by requesting it directly from the AAVSO International Database. To do this, click the “New Star from AAVSO Database…” button in the upper left corner of the VStar screen, then choose a star from the 10-star drop-down list or type in the name of another star from the AAVSO database. You can change the date range of the plot, use the default range (the last two years worth of data), or select “All data” by clicking the checkbox and hitting “OK”. Other features include the ability to create your own list of favorite stars to view using the "Star Groups" tab under "Preferences" or to filter the data so you can highlight your own observations.
If you haven't yet downloaded and read the VStarUserManual, do so now! This Manual walks you through all of VStar's features and it is recommended that you follow along with VStar itself as you read.
There is also an excellent 5-minute introductory video (95 MB) created by VStar CHOICE course graduate George Sjoberg available for download.
Another interesting exercise is the 5-Star Data Analysis Tutorial (revised in June 2014 by Paul York). This document will introduce you to VStar by walking you through some of the concepts of basic data analysis. We recommend it as the first place to stop for those new to light curves and variable star data analysis. More help links can be found below.
VStar also supports a large number of plug-ins which perform a range of functions from allowing the loading of external data sets to complex filtering to data analysis. All are easily loaded using the "Plug-in Manager". A list of available plug-ins with descriptions and documentation on how to use them is available on the VStar Plug-in Library webpage.
Some of the things you can do with VStar include:
If you still have questions after reading the VStar User Manual, here are some additional resources you might find useful:
- AAVSO VStar forum - Please feel free to post your questions, suggestions, or observations here.
- AAVSO Data Analysis forum - For discussion of data analysis techniques and projects.
- VStar Slack Channel - For chatting about VStar with others.
- VStar Wiki - Other useful information and "Recipes".
- David Benn's VStar blog - Contains good examples of how VStar can be used for data analysis.
- eJAAVSO article: Algorithms + Observations = VStar - Outline of the development, use and future plans.
- VStar Video Tutorial - Video created by George Sjoberg (95 MB .mp4). Click here for (90 MB zipped version).
- Powerpoint Presentation on VStar (English)
- Powerpoint Presentation on VStar (Spanish)
- AAVSO CHOICE courses. There are two courses offered once/year related to VStar:
- How to use VStar (for beginners)
- Analyzing Data with VStar (for advanced users)
- VStar is the creation of lead developer David Benn with help from a few volunteers.
- VStar uses the Apache Commons Math library for anova (F-test, p-value) algorithms.
- VStar is made available under the Affero GNU Public License, which requires that the source code be made freely available. Click here to visit its GitHub site.
- When citing the use of VStar in a paper, please use this reference:
Benn, D. 2012, “Algorithms + Observations = VStar”, JAAVSO, v40, n2, pp.852-866.
- Information about libraries used by VStar can be found here: