https://github.com/Kosmorro/kosmorro

A program to calculate your ephemerides.
https://github.com/Kosmorro/kosmorro

astronomy ephemerides ephemeris ephemeris-calculations kosmorro python

Last synced: 3 months ago
JSON representation

A program to calculate your ephemerides.

• Host: GitHub
• URL: https://github.com/Kosmorro/kosmorro
• Owner: Kosmorro
• License: agpl-3.0
• Created: 2019-10-27T08:13:23.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-08-05T05:05:32.000Z (7 months ago)
• Last Synced: 2024-08-05T08:09:56.702Z (7 months ago)
• Topics: astronomy, ephemerides, ephemeris, ephemeris-calculations, kosmorro, python
• Language: Python
• Homepage: https://kosmorro.space
• Size: 1.6 MB
• Stars: 60
• Watchers: 4
• Forks: 7
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# ![Kosmorro](https://github.com/Kosmorro/logos/raw/main/kosmorro/kosmorro-artwork.jpg)

[![Version on PyPI](https://img.shields.io/pypi/v/kosmorro)](https://pypi.org/project/kosmorro) [![Packaging status](https://repology.org/badge/tiny-repos/kosmorro.svg)](https://repology.org/project/kosmorro/versions) [![Help translating Kosmorro!](https://hosted.weblate.org/widgets/kosmorro/-/cli/svg-badge.svg)](https://hosted.weblate.org/engage/kosmorro/)

Kosmorro is a program that calculates your astronomical ephemerides.

## Installation

Installing Kosmorro is documented on [the official website](https://kosmorro.space/cli/download/). Just select your operating system and follow the instructions!

### Development environment

To contribute to Kosmorrolib, you will need [Poetry](https://python-poetry.org), a software to manage the project from development to publishing.

Clone this repository and run `poetry install` to install the dependencies.

And that's all, your development environment is ready!

To run Kosmorro, invoke `poetry run kosmorro`. For comfort, you may also want to invoke `poetry shell`, which will expose the `kosmorro` command directly.

## Using Kosmorro

Using Kosmorro is as simple as invoking `kosmorro` in your terminal!

By default, it will give you the current Moon phase and, if any, the events that will occur today.

Kosmorro has a lot of available options to get exactly what you want, including the possibility to get planets rise and set. To get a list of them, run `kosmorro --help`, or read its manual with `man kosmorro`. You can also find usage examples in [the `tldr` manual](https://tldr.sh) with [`tldr kosmorro`](https://tldr.inbrowser.app/pages/common/kosmorro).

## Help translating Kosmorro!

Kosmorro is translated on [Weblate](https://hosted.weblate.org/engage/kosmorro/), a popular free platform for crowd-sourced internationalization.

If you speak a language that is not supported yet, feel free to contribute!

![Translation state per language](https://hosted.weblate.org/widgets/kosmorro/-/cli/multi-auto.svg)