You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
dependabot[bot] 49b34a9cdc chore(deps-dev): bump black from 23.12.0 to 23.12.1 3 months ago
.github ci(deps): bump actions/setup-python from 4 to 5 3 months ago
kosmorro build: bump version 0.10.12 (#323) 10 months ago
manpage feat(event): add support for moon apogee and perigee 3 years ago
tests test: remove LaTeX tests (#333) 7 months ago
.all-contributorsrc docs: add Deuchnord as a contributor for translation (#330) 8 months ago
.coveragerc ci(compatibility): test on more Python versions and on macOS (#131) 3 years ago
.editorconfig ci(compatibility): test on more Python versions and on macOS (#131) 3 years ago
.gitignore build: bump version 0.10.12 (#323) 10 months ago
.gitpod.yml chore: migrate to Poetry 2 years ago
.pylintrc ci(compatibility): test on more Python versions and on macOS (#131) 3 years ago
CHANGELOG.md build: bump version 0.10.13 3 months ago
CODE_OF_CONDUCT.md docs: add code of conduct (#155) 3 years ago
CONTRIBUTING.md chore: migrate to Poetry 2 years ago
CONTRIBUTORS.md docs: add Deuchnord as a contributor for translation (#330) 8 months ago
LICENSE.md Add AGPL-v3.0 license 4 years ago
MANIFEST.in feat: use Kosmorrolib (#162) 2 years ago
Makefile build: bump version 0.10.12 (#323) 10 months ago
README.md chore: update Readme 3 months ago
poetry.lock chore(deps-dev): bump black from 23.12.0 to 23.12.1 3 months ago
pyproject.toml chore(deps-dev): bump black from 23.12.0 to 23.12.1 3 months ago
setup.cfg chore: migrate to Poetry 2 years ago

README.md

Kosmorro

Version on PyPI Packaging status Help translating Kosmorro!

Kosmorro is a program that calculates your astronomical ephemerides.

Installation

Installing Kosmorro is documented on the official website. Just select your operating system and follow the instructions!

Development environment

To contribute to Kosmorrolib, you will need Poetry, 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 with tldr kosmorro.

Help translating Kosmorro!

Kosmorro is translated on Weblate, 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