Manpage

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!

SYNOPSIS

  • kosmorro
  • kosmorro [OPTIONS]...

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

ENVIRONMENT VARIABLES

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:

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

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

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

EXAMPLES

Compute the events only for the current date:

kosmorro

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

AUTHOR

Written by Jérôme Deuchnord.

REPORTING BUGS

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.