badweathermounttester 0.8.0

Test telescope mount periodic error indoors using a simulated star on a monitor

Bad Weather Mount Tester

When you buy a new telescope mount, the first things to do is to measure the periodic error, because if the periodic error is really high, you would like to complain and send it back as fast as possible. Unfortunately, most of the time there will be bad weather after buying astro gear for an indefinite amount of time.

Bad Weather Mount Tester to the rescue!

Using this program you can test the periodic error of your mount any time, any place, provided you have a spare computer and monitor and a little bit of space.

Documentation

The full user manual is available in docs/manual.md.

A hosted version of the documentation site is available at https://jscheidtmann.github.io/BadWeatherMountTester/.

How to Install

From PyPI (all platforms)

Using pip:

pip install BadWeatherMountTester

Or using pipx for an isolated install:

pipx install BadWeatherMountTester

Then run the application:

bwmt

From GitHub Releases (pre-built binaries)

Download the latest release from the GitHub Releases page.

• Linux: Download the .tar.gz archive, extract it, and run ./bwmt
• Windows: Download the .zip archive, extract it, and run bwmt.exe
• macOS: Download the .tar.gz archive, extract it, and run ./bwmt

From Source

git clone https://github.com/jscheidtmann/BadWeatherMountTester.git
cd BadWeatherMountTester

Install uv if you don't have it, then:

uv sync
uv run bwmt

How to Contribute

1. Fork the repository and clone your fork
2. Install development dependencies:

   uv sync --dev
   

3. Run the tests:

   uv run pytest
   

4. Lint:

   uv run flake8
   

5. Internationalization: The project supports German, English, and French via Flask-Babel. Translation files live in the locale directories.
6. Submit a pull request against main

Credit

This software is based on the idea by Klaus Weyer from Solingen, Germany. Rest in Peace, Klaus!

Author, Copyright & License

Copyright (c) 2026 Jens Scheidtmann and contributors (see CONTRIBUTORS.md)

This file is part of BWMT, the Bad Weather Mount Tester.

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

BWMT is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with BWMT. If not, see http://www.gnu.org/licenses/.