Table of Contents

• Description
• Installation
  • Binary packages
  • Direct installation from git
• Build app binaries for target platform
  • Android
  • Android (with Docker)
  • Windows
  • Linux
• Support
• Links
• Licenses

Description

Cross-platform app for small arms ballistic calculations based on python3

• Uses py_ballisticcalc library in backend
• Uses Kivy GUI framework and KivyMD for the frontend
• Compatible with ArcherBC2 .a7p file format

Installation

Binary packages:

You can download binaries from Releases section of this repo

Direct installation from git:

1. Download specific release

# latest (nightly) release, newest changes would be here
git clone https://github.com/o-murphy/eballistica_app

# dev release, there would be more stable versions
git clone -b kivymd-dev https://github.com/o-murphy/eballistica_app 

# latest stable version
git clone -b kivymd-main https://github.com/o-murphy/eballistica_app 

2. Create and activate new venv

python3 -m venv venv
. venv/bin/activate

3. Install requirements depends on platform

pip install -r requirements.txt # Windows OS
pip install -r requirements-linux.txt # Linux based OS 

4. Run app

python3 main.py

Build app binaries for target platform

Android with kivy/buildozer

# install buildozer from PyPi
pip install buildozer
# build in debug mode
buildozer android debug

Android with buildozer in Docker

# bind your source folder to hostcwd directory of the Docker container
# build in debug mode
docker pull omurphyslaw/buildozer:test
docker run -v "path-to-sources:/home/user/hostcwd" -d omurphyslaw/buildozer:test android debug
# or use branch with preinstalled SDK/NDK
docker pull omurphyslaw/buildozer:SDK31-NDKr25b
docker run -v "path-to-sources:/home/user/hostcwd" -d omurphyslaw/buildozer::SDK31-NDKr25b android debug

Windows

# install pyinstaller wia pip
pip install pyinstaller
# or
pip install pyinstaller==5.6.2  # (recommended)
# build binaries
pyinstaller pyinstaller.spec

Linux

# install pyinstaller wia pip
pip install pyinstaller
# or
pip install pyinstaller==5.12.0  # (recommended)
# build binaries
pyinstaller pyinstaller-linux.spec

Support

Issues tracker

Links

• py_ballisticcalc: LGPL library for small arms ballistic calculations
• ArcherBC2: Cross-platform app for managing ballistic profiles in .a7p format
• a7p_transfer and a7p for python: libraries and examples of .a7p profiles manage
• Kivy: open source, cross-platform Python framework for the development of applications
• KivyMD: Material widgets for Kivy framework
• Buildozer: generic Python packager for Android and iOS.
• Python for Android: toolchain for building and packaging Python applications for Android.
• Pyjnius: dynamic access to the Java/Android API from Python.
• Pyobjus: dynamic access to the Objective-C/iOS API from Python.
• Kivy iOS: toolchain for building and packaging Kivy applications for iOS.
• Garden: widgets and libraries created and maintained by users.

Licenses

• Kivy is released under the terms of the MIT License. Please refer to the LICENSE file.
• The provided fonts Roboto and Roboto Mono are licensed and distributed under the terms of the Apache License, Version 2.0. The DejaVuSans (used for the virtual keyboard) license can be viewed here.
• The current UI design has been adapted from Moblintouch theme's SVGs and is licensed under the terms of the LGPLv2.1.