Below is the man page for the command line program. You can also get it directly in your terminal on Linux, macOS and FreeBSD with the man kosmorro command.

Looking for some usage examples? Take a look at the tldr page!


  • kosmorro
  • kosmorro [OPTIONS]...


  • -h, --help
    show a help message and exit

  • --version, -v
    show the program version

  • --clear-cache
    delete all the files Kosmorro stored in the cache

  • --latitude=LATITUDE, -lat LATITUDE
    the observer's latitude on Earth

  • --longitude=LONGITUDE, -lon LONGITUDE
    the observer's longitude on Earth

  • --date=DATE, -d DATE
    The date for which the ephemerides must be computed, either in the YYYY-MM-DD format or as an interval in the "[+-]YyMmDd" format (with Y, M, and D numbers); defaults to the current date

  • --timezone=TIMEZONE, -t TIMEZONE
    the timezone to display the hours in; e.g. 2 for UTC+2 or -3 for UTC-3

  • --no-colors
    disable the colors in the console

  • --output=OUTPUT, -o OUTPUT
    a file to export the output to; if not given, the standard output is used

  • --format=FORMAT, -f FORMAT
    the format under which the information have to be output; one of the following: text, json, pdf

  • --no-graph
    present the ephemerides in a table instead of a graph; PDF output format only


The environment variable listed below may be used instead of the options. The options have a higher priority than the environment variable. As a consequence, any option that would be given to kosmorro will override its corresponding environment variable.

Available environment variables are:

    the observer's latitude on Earth (alternative to --latitude)

    the observer's longitude on Earth (alternative to --longitude)

    the observer's timezone (alternative to --timezone)


Compute the events only for the current date:


Compute the ephemerides for Lille, France, on April 1st, 2022:

kosmorro --latitude=50.5876 --longitude=3.0624 --date=2022-04-01

Compute the ephemerides for Lille, France, on April 1st, 2022, and export them in a PDF document:

kosmorro --latitude=50.5876 --longitude=3.0624 -date=2022-04-01 --format=pdf --output=file.pdf


Written by Jérôme Deuchnord.


Please report any encountered bugs on Kosmorro's GitHub project.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.